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
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
Clique em Adicionar provedor.
Preencha o Nome: é só um rótulo interno para você reconhecer a chave (ex.: "OpenAI (produção)").
Em Tipo, escolha OpenAI (ChatGPT) ou Anthropic (Claude), conforme o provedor da sua chave.
Cole a chave em Chave da API. Ela é do tipo senha e não fica visível na tela.
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
Criar um agente de IA no builder
Alimentar a base de conhecimento (upload de documentos / RAG)
Monitorar uso e custos do agente
Entender planos, módulos e o que está incluído