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

<p class="callout warning">🧩 Este recurso faz parte do módulo <strong>Agentes Inteligentes</strong>. 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).</p>

## 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**.

<p class="callout info">🖼️ <strong>PRINT</strong> — Janela <strong>Provedores</strong> com a lista de credenciais e o botão <strong>Adicionar provedor</strong> na base.</p>

2. Clique em **Adicionar provedor**.
3. Preencha o **Nome** — é só um rótulo interno para você reconhecer a chave (ex.: "OpenAI (produção)").
4. Em **Tipo**, escolha **OpenAI (ChatGPT)** ou **Anthropic (Claude)**, conforme o provedor da sua chave.
5. Cole a chave em **Chave da API**. Ela é do tipo senha e não fica visível na tela.
6. 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](/books/agentes-de-ia/page/criar-um-agente-de-ia-no-builder)
- [Alimentar a base de conhecimento (upload de documentos / RAG)](/books/agentes-de-ia/page/alimentar-a-base-de-conhecimento-upload-de-documentos-rag)
- [Monitorar uso e custos do agente](/books/agentes-de-ia/page/monitorar-uso-e-custos-do-agente)
- [Entender planos, módulos e o que está incluído](/books/comece-por-aqui/page/entender-planos-modulos-e-o-que-esta-incluido)