Provedor de IA
Os 7 provedores aceitos, como colar a sua chave e por que essa escolha vale para a organização inteira.
O ChatMade não tem inteligência própria e não revende crédito de IA. Você escolhe um provedor, cria a chave na conta dele e cola no painel. Esta página é para quem administra a conta e vai fazer essa ligação — não é preciso ser desenvolvedor, mas é preciso ter cartão para criar a conta no provedor.
Sem essa configuração, nenhum agente responde.
Os 7 provedores
Estes são os provedores selecionáveis, com o nome exatamente como aparece na tela:
| Na tela | Onde você pega a chave |
|---|---|
| OpenAI | platform.openai.com/api-keys |
| Anthropic (Claude) | console.anthropic.com/settings/keys |
| Google Gemini | aistudio.google.com/app/apikey |
| Mistral | console.mistral.ai/api-keys |
| xAI (Grok) | console.x.ai |
| DeepSeek | platform.deepseek.com/api_keys |
| Groq | console.groq.com/keys |
Não há outra opção. Se você já ouviu falar em rodar modelo local com Ollama, ou em puxar modelo do Hugging Face: essas opções não estão disponíveis no ChatMade e a tentativa de usá-las é recusada pelo sistema.
Uma configuração para a organização inteira
Esta é a parte que surpreende quem espera um modelo diferente por agente: existe uma única configuração de IA ativa por organização. Não há escolha de modelo por agente.
O que você define aqui vale, ao mesmo tempo, para:
- todos os agentes de IA que conversam com clientes;
- a busca na base de conhecimento;
- a geração automática de perguntas e respostas da central de ajuda;
- o botão de perguntar à IA na central de ajuda pública;
- a investigação automática de chamados.
Trocar o modelo aqui troca em tudo isso de uma vez.
Configurar
- No menu lateral, em Settings (“Configurações”), clique em AI Configuration (“Configuração de IA”).
- Abra a aba Advanced — Bring Your Own Model (“Avançado — Traga seu próprio modelo”). É a única aba disponível.
- Em AI Provider (“Provedor de IA”), clique no cartão do provedor escolhido.
- Em Model Name (“Nome do modelo”), escolha um modelo da lista. Cada provedor sugere os seus.
- Em API Key (“Chave de API”), cole a chave gerada no site do provedor. O campo esconde o texto, e um link ao lado leva direto para a página de chaves do provedor que você escolheu.
- Clique em Save Configuration (“Salvar configuração”). Se já houver uma configuração, o botão diz Update Configuration (“Atualizar configuração”).
O painel avisa junto ao campo que a chave é guardada criptografada.
Atenção: não existe botão de “testar conexão” separado. O teste acontece no momento de salvar: o ChatMade faz uma chamada real ao provedor com a sua chave e o modelo escolhido. Se a chave for inválida ou não tiver acesso àquele modelo, nada é salvo e aparece a mensagem “The provided API key is invalid or does not have access to the selected model.” (“A chave fornecida é inválida ou não tem acesso ao modelo selecionado.”). Salvou sem erro? Então a chave funciona de verdade.
Usar um modelo que não está na lista
No fim da lista de modelos existe a opção Custom model ID… (“ID de modelo personalizado…”). Ela abre um campo livre para você digitar o identificador exato do modelo, como gpt-4o. Serve para modelos lançados depois da lista, ou para modelos que só a sua conta tem.
A tela traz um aviso que vale repetir, porque ele é a fonte mais comum de agente quebrado: modelos personalizados não são verificados, e modelos menores ou mais antigos podem não dar conta de chamar ferramentas nem de devolver resposta estruturada. Sem isso, três coisas param de funcionar direito — a busca na base de conhecimento, a captura de lead e o encerramento da conversa. Se você for por esse caminho, prefira um modelo grande e com suporte a chamada de ferramenta.
Quanto custa
O consumo é cobrado pelo provedor, direto no cartão que você cadastrou lá. O ChatMade não impõe cota de mensagem e não corta o atendimento por volume. Quem define teto de gasto é você, no painel do provedor.
Isso significa que acompanhar o custo é responsabilidade sua. Modelos maiores respondem melhor e custam mais; modelos menores custam pouco e erram mais. Comece por um modelo intermediário, olhe a fatura na primeira semana e ajuste.
Quem pode mexer
Ver essa tela exige a permissão view_ai_config; salvar exige manage_ai_config. Um usuário com o papel Agent não vê a configuração de IA.
Próximo passo
Com o provedor ligado, dê ao agente uma voz e um roteiro em Personalidade e instruções.