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 [Entender planos, módulos e o que está incluído](/books/comece-por-aqui/page/entender-planos-modulos-e-o-que-esta-incluido).
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 Inteligentes → botão Provedores
Passo a passo
Na tela Agentes Inteligentes, clique em Provedores, no topo direito. Abre a janela Provedores.
🖼️ PRINT — Janela Provedores com a lista de credenciais e o botão Adicionar provedor na base.
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 ou base. Troque o provedor nesses itens 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