Configurar o provedor externo#
A geração de texto do Doot não roda na sua máquina: ela é feita por um provedor externo de IA, que você contrata e paga por uso. Esta página é a configuração dessa ligação — e o motivo de a IA não responder nada quando ela falta.
Antes de começar#
Você precisa de uma conta no provedor e de uma chave de API dele, com saldo ou meio de pagamento ativo. O Doot não intermedia essa contratação.
Sem chave configurada não há geração. Os fluxos, as intenções e a base de conhecimento continuam funcionando, porque são determinísticos. O sistema responde menos, e não responde errado.
Os provedores suportados#
| Provedor | Observação |
|---|---|
| DeepSeek | Compatível com o formato da OpenAI |
| OpenAI | |
| Anthropic | |
| Qualquer endpoint compatível com OpenAI | Informando a URL base |
A última linha é o que permite usar um provedor que não está na lista, desde que ele fale o mesmo protocolo.
Como fazer#
- Vá em Configurações → Inteligência artificial, aba do provedor.
- Escolha o provedor.
- Cole a chave de API.
- Escolha o modelo — veja Escolher o modelo.
- Se o provedor for compatível com OpenAI mas não estiver na lista, informe a URL base.
- Salve e faça um teste com uma pergunta que você sabe que a base responde.
O que cada campo significa#
| Campo | O que faz | Quando mudar |
|---|---|---|
| Provedor | Define qual API é chamada e o formato da requisição | Ao trocar de fornecedor |
| Chave de API | Autentica e é o que a fatura cobra | Se vazar, revogue no provedor e gere outra |
| Modelo | Qual modelo responde | Ver o artigo sobre escolha de modelo |
| URL base | Endereço da API, para provedores compatíveis fora da lista | Só nesse caso |
| Esforço de raciocínio | Quanto o modelo "pensa" antes de responder | Ver abaixo |
| Conversão para reais | Preço do dólar usado para mostrar o consumo em reais | Quando o câmbio mudar muito |
Esforço de raciocínio#
| Opção | O que muda |
|---|---|
| Padrão do provedor | Sem raciocínio estendido |
| Baixo | Mais rápido e mais barato |
| Médio | Equilíbrio |
| Alto | Mais qualidade, mais lento |
| Máximo | Prioriza acerto sobre custo |
Para atendimento de provedor, os níveis altos raramente compensam: a maior parte das perguntas é factual e a resposta certa está na base. Raciocínio estendido não substitui base bem alimentada — ele só encarece a mesma resposta.
Conversão para reais#
Preenchendo o valor do dólar, o consumo também aparece em reais. É uma conversão fixa, feita para leitura gerencial — não é câmbio do dia, e não é o valor que o provedor vai cobrar.
Onde a chave fica guardada#
A configuração vive no banco de dados do sistema e pode ser editada por quem tem permissão. Há também variáveis de ambiente equivalentes, usadas como reserva quando não há configuração no banco:
EXTERNAL_LLM_PROVIDER
EXTERNAL_LLM_API_KEY
EXTERNAL_LLM_MODEL
EXTERNAL_LLM_BASE_URLChave de API é credencial de gasto. Quem a tiver pode consumir a sua conta até o limite. Trate-a como senha: não a mande por chat, não a coloque em captura de tela e revogue-a no provedor se ela sair do lugar.
Se algo der errado#
A IA não responde nada, e o resto funciona. É o sintoma exato de chave ausente ou inválida. Confira no painel do provedor se a chave existe e está ativa.
Erro de autenticação. Chave errada, revogada, ou copiada com espaço no fim.
Erro de saldo ou de cota. É do lado do provedor. Nada no Doot contorna: reponha o saldo ou ajuste o limite lá.
A IA responde, mas ignora imagens. Nem todo modelo lê imagem, e há provedor em que só um modelo específico lê. Veja Descrição de imagens.
A resposta demora muito. Baixe o esforço de raciocínio e confira o modelo escolhido.