Skip to main content

Configurar seu provedor de IA (chave própria)

Cadastre a sua própria chave de IA (OpenAI ou Anthropic) para que os agentes possam pensar e responder — é o primeiro passo antes de criar qualquer agente.

🧩 Este recurso faz parte do módulo Agentes Inteligentes. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja Planos e módulos.

Objetivo

Salvar uma chave de IA própria (BYO-key) em Provedores, deixando-a pronta para ser usada pelos agentes.

Pré-requisitos

  • Perfil Administrador (apenas administradores gerenciam agentes inteligentes)
  • Módulo Agentes Inteligentes ativo
  • Uma chave de API da OpenAI ou da Anthropic, obtida no painel do provedor
  • Acesse pelo computador — esta tela não está disponível no celular

Tempo estimado

5 minutos.

Caminho de acesso

Bots → Agentes IA → botão Provedores

Passo a passo

  1. Na tela Agentes IA, clique em Provedores, no topo direito. Abre a janela Provedores.

Janela Provedores, onde ficam as chaves de IA usadas pelos agentes, com o botão Adicionar provedor
Janela Provedores, onde ficam as chaves de IA usadas pelos agentes, com o botão Adicionar provedor
  1. Clique em Adicionar provedor.
  2. Preencha o Nome — é só um rótulo interno para você reconhecer a chave (ex.: "OpenAI (produção)").
  3. Em Tipo, escolha OpenAI (ChatGPT) ou Anthropic (Claude), conforme o provedor da sua chave.
  4. Cole a chave em Chave da API. Ela é do tipo senha e não fica visível na tela.
  5. Clique em Salvar. A chave é validada junto ao provedor no momento de salvar.

Resultado esperado

Aparece a mensagem "Provedor criado" e a credencial passa a constar na lista, mostrando o tipo e apenas uma dica final da chave (as chaves nunca são exibidas de volta por segurança). Ao editar, o campo Chave da API fica vazio — digite uma nova chave só quando quiser substituir a atual.

Erros comuns

  • Sintoma: aparece "Informe a chave do provedor". Solução: o campo Chave da API é obrigatório ao criar um provedor novo. Cole a chave antes de salvar.
  • Sintoma: erro ao salvar informando chave inválida. Solução: confira se copiou a chave inteira (começa com sk- na OpenAI e sk-ant- na Anthropic) e se ela ainda está ativa no painel do provedor.
  • Sintoma: não consigo excluir um provedor. Solução: provedores marcados com Em uso estão vinculados a um agente, a uma base de conhecimento, a um Supervisor de IA ou à Análise IA. Troque o provedor deles antes de excluir.

Artigos relacionados