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 esk-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.