Provedores e modelos de IA

O Agente IA responde usando um provedor de IA que você contrata: OpenAI (ChatGPT), Anthropic (Claude), Google (Gemini), Groq ou Mistral. Você cria uma chave no site do provedor e cola no Leadz. No Leadz essa chave se chama token de IA, e é o primeiro passo: sem ela, as abas Agentes e Material de Conhecimento ficam bloqueadas.

#Antes de começar

• Uma conta no provedor escolhido, com forma de pagamento ou crédito ativo. O consumo é cobrado pelo provedor, não pelo Leadz.
• Permissão para gerenciar o workspace (a conta da sua empresa dentro do Leadz). Sem ela, você vê os tokens, mas não consegue adicionar nem alterar.

#Onde criar a chave

#Adicionar o token

O token fica guardado no servidor e nunca volta para a tela. Para trocar a chave, você cola uma nova por cima.

Você pode ter mais de um token do mesmo provedor (por exemplo, uma chave por produto). Cada agente escolhe qual token usa.

#Provedor personalizado

A opção Provedor personalizado conecta qualquer serviço compatível com o formato da OpenAI. Além do token, informe o Nome do provedor e a URL base da API. Nesse caso, escreva o nome do modelo no campo Modelo personalizado.

#Testar, pausar e trocar o token

Na lista Tokens configurados, cada linha tem estas ações:

#Escolher o modelo

O modelo é escolhido em dois lugares:

• no token (Modelo padrão), que serve de sugestão;
• em cada agente, no passo Modelo de IA, campo Modelo. É este que vale para o agente.

A lista mostra os modelos recomendados. O botão Pesquisar modelos abre o catálogo completo do provedor. Se o modelo que você quer não está na lista, escreva o nome exato em Modelo personalizado.

#Áudio e imagem do contato

O agente entende o que o contato envia, mas isso depende do token e do modelo.

#Áudio

O áudio é transcrito antes de chegar ao agente. A transcrição usa o token escolhido em Transcrição de áudio, na aba Tokens de IA, campo Chave usada para transcrição de áudio.

• A transcrição funciona com token da OpenAI ou da Groq, ativo.
• Em Automática, o Leadz escolhe um token compatível sozinho.
• Sem token compatível, só os modelos Gemini conseguem ouvir o áudio direto.
• O áudio do contato é enviado ao provedor do token escolhido, com a sua chave.

#Imagem

A imagem vai direto para o modelo do agente. Nem todo modelo enxerga:

Quando o modelo não aceita a imagem, o agente responde sem ela e não finge que viu.

#Acompanhar o consumo

Na aba Tokens de IA, o quadro Consumo de IA mostra os Tokens no mês e o número de Chamadas feitas pelos agentes e pelos blocos de IA dos funis. O valor em dinheiro aparece no painel do seu provedor.

#Problemas comuns

«O provedor recusou o token: ele é inválido, foi revogado ou está sem permissão.»

A chave foi colada errada, foi apagada no provedor ou não tem permissão para o modelo. Gere uma chave nova no painel do provedor, abra Modelo e token na linha do token e cole a chave nova. Depois clique em Testar este token.

«O provedor recusou por limite de uso ou falta de crédito na conta.»

A conta no provedor está sem saldo ou bateu o limite de uso. Coloque crédito ou aumente o limite no painel do provedor. No Leadz não precisa mudar nada.

«O modelo configurado não existe nesta conta. Troque o modelo do token.»

O nome do modelo está errado ou a sua conta no provedor não tem acesso a ele. Escolha outro modelo no token e no agente.

As abas Agentes e Material de Conhecimento estão com cadeado

Ainda não há token ativo. Adicione um token ou ative um token pausado.

O cartão do agente mostra «Provedor sem token»

O token que o agente usava foi pausado ou removido. Edite o agente, vá ao passo Modelo de IA e escolha outro Token de IA.

O agente não entende áudio

Confira se há um token da OpenAI ou da Groq ativo e escolhido em Chave usada para transcrição de áudio. Se a tela mostrar «Nenhum token compatível», adicione um token de um desses dois provedores.

#Veja também

• Criar um agente
• Botões e mídia
• Testar o agente