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 [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

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

  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 ou base. Troque o provedor nesses itens antes de excluir.

Artigos relacionados

No comments to display

Back to top