Como configurar conexões LLM
Provedor de modelo para os agentes de IA. Tela /admin/llm-connections. Você pode usar a API padrão do Painel Fácil (.env) ou um token do tenant, criptografado no banco.
Pré-requisito
Flags Chat e Agentes de IA do Chat em Gerais. Sem isso o item some do menu.
Maquete
| Conexão | Provedor | Modelo | Status |
|---|---|---|---|
| API padrão (Painel Fácil) | OpenAI | do .env | Plataforma |
| OpenAI do escritório | OpenAI | gpt-4o-mini | Conectado |
| Claude | Anthropic | claude-sonnet | Desconectado |
Passo a passo
- Configurações → Conexões LLM.
- Para a maioria dos escritórios, deixe a linha API padrão (Painel Fácil) e aponte o agente para ela.
- Para usar chave própria: nova conexão, driver OpenAI, OpenAI-compatível (URL base) ou Anthropic, cole o token e teste.
- O token nunca volta na tela depois de salvo. Em edição, deixe em branco para manter o atual.
Glossário
| Campo | O que faz |
|---|---|
| API padrão (Painel Fácil) | Credenciais do .env da plataforma. Não há token do tenant. |
| Driver OpenAI | API oficial da OpenAI. |
| Compatível OpenAI | Mesmo protocolo, outra URL (proxy, Azure, etc.). Informe base_url. |
| Anthropic | Claude. Token e modelo Anthropic. |
| Modelo | Nome do modelo (ex.: gpt-4o-mini). Vazio usa o padrão do driver. |
| Token / API key | Criptografado no banco. Nunca é reenviado à interface. |
| Testar conexão | Chamada curta ao provedor. Atualiza o chip para conectado ou erro. |
Erro comum
Recadastrar o token a cada edição porque o campo aparece vazio. Isso é proposital: o segredo não transita de volta. Só preencha de novo se for trocar a chave.