Como conectar clientes OpenAI e Anthropic à RN
Escolha entre o catálogo protegido e o gateway nativo antes de configurar um cliente de IA ou agente de código. Modelo, endpoint e chave precisam combinar.
Rota Nacional · Publicado · Revisado
Escolha primeiro o contrato
A RN oferece chat compatível com o formato OpenAI em /v1/chat/completions e com o formato Messages em /v1/messages. Esse catálogo usa identificadores rota/* e aplica a política de dados pessoais da organização.
O gateway nativo é outro contrato. Ele conserva o modelo e o formato do provedor por /v1/providers/{provider}/. Não troque um caminho pelo outro apenas mudando o hostname: confira se o cliente precisa de ferramentas, arquivos, multimodalidade ou respostas que aquele caminho suporta.
Configure endereço, credencial e modelo juntos
Num cliente OpenAI compatível, o endereço base do catálogo é a origem da RN seguida de /v1. Use uma chave RN e um modelo publicado em /v1/models. No cliente Anthropic compatível, a origem e o caminho Messages seguem o exemplo da documentação.
A página de agentes de código reúne os exemplos da RN para clientes suportados. Copie o exemplo do cliente real. Não exponha o segredo em repositório, captura, comando público ou configuração enviada a outra pessoa. O identificador de uma conexão não substitui a chave RN.
Valide também as falhas
Faça uma chamada curta com conteúdo fictício. Depois confira streaming, ferramentas e limites que seu fluxo realmente usa. Uma resposta 401 indica problema de credencial; 403 pode vir de política da organização; 402 pede saldo ou condição financeira válida. O corpo do erro informa o código específico.
Se a organização exige a barreira, o cliente precisa usar um caminho protegido. Um agente de código não ganha permissão para enviar conteúdo bruto só por conseguir selecionar outro provedor. A aplicação mantém o controle sobre quais arquivos e informações entram no contexto.
Perguntas frequentes
Posso usar qualquer nome de modelo no catálogo protegido?
Use os identificadores publicados em /v1/models e liberados para a organização. Os nomes nativos dos provedores pertencem ao contrato do gateway nativo.
Compatibilidade de chat garante suporte a toda API do provedor?
Não. Confira os caminhos e os recursos que a aplicação usa. Arquivos, mídia, ferramentas e operações assíncronas têm contratos próprios.
Continue a leitura
Como exigir privacidade em todas as chaves da organização
A organização pode exigir a barreira de privacidade na RN. Entenda o bloqueio da API nativa, o erro 403 e o caminho protegido para o chat.
Gateway de IA sem trocar o modelo da sua aplicação
Centralize conexões de IA na RN sem converter o corpo de cada provedor. Entenda o endpoint nativo, o pool autorizado e os limites da migração.
n8n com IA e privacidade: um fluxo de atendimento
Use o exemplo n8n da RN para receber uma mensagem e devolver uma resposta. Veja autenticação, limites e responsabilidades antes de ligar ao seu canal.