🚀 Integração do n8n: Tutorial de LLM Personalizado CodingPlanX

No n8n, você pode se conectar facilmente a Grandes Modelos de Linguagem (LLMs) de terceiros configurando um Domínio de API Personalizado e uma Chave de API (API Key).

Este tutorial demonstra como configurar e usar modelos de IA personalizados no n8n usando https://api.codingplanx.ai como exemplo.

📋 Pré-requisitos

Antes de começar, certifique-se de ter:

Uma instância do n8n em execução (versão auto-hospedada ou Cloud).
Uma Chave de API do CodingPlanX (geralmente começando com sk- ou cr_).
O Nome do Modelo específico que você deseja chamar (ex: gpt-4o, claude-3-5-sonnet, etc.).

🛠️ Passo 1: Criar Credenciais de API no n8n

Como a maioria das APIs personalizadas são compatíveis com a OpenAI, usaremos o tipo de credencial integrado da OpenAI.

Abra seu painel do n8n e clique em Credentials (Credenciais) na barra lateral esquerda.
Clique no botão + Add Credential (Adicionar Credencial) no canto superior direito.
Pesquise por OpenAI e selecione OpenAI API.

⚙️ Passo 2: Configurar URL e Chave de API Personalizadas

Na janela de configuração de credenciais, preencha o seguinte:

Name (Nome): Dê a esta credencial um nome reconhecível, ex: API CodingPlanX.
API Key: Insira sua Chave de API (sk-xxxxxx...).
Base URL (Passo Crucial):
- Por padrão, o n8n usa a URL oficial da OpenAI. Precisamos substituir isso.
- Encontre o campo Base URL (se não estiver visível, verifique se a sua versão do n8n suporta Base URLs personalizadas ou verifique nas configurações avançadas).
- Altere o endereço para:
```
https://api.codingplanx.ai/v1
```
> 💡 Nota: A maioria das APIs compatíveis com a OpenAI exige o sufixo /v1. Não o omita.
Clique em Save (Salvar). Se configurado corretamente, você verá uma mensagem Connection tested successfully (Conexão testada com sucesso).

🧩 Passo 3: Adicionar e Configurar o Nó de IA em um Fluxo de Trabalho (Workflow)

Agora, vamos usar a credencial em um fluxo de trabalho.

Vá para Workflows e clique em + Add workflow (Adicionar fluxo de trabalho).
Clique no ícone + na tela, pesquise e adicione um nó OpenAI (geralmente AI Chat Model).
Abra as configurações do nó:
- Credential to connect with (Credencial para se conectar): Selecione a API CodingPlanX que você acabou de criar.
- Model:
  - Como esta é uma API personalizada, o menu suspenso pode não listar seu modelo específico.
  - Clique em ⚙️ (ícone de engrenagem) ao lado do campo Model ou selecione o modo Expression / Custom.
  - Insira manualmente o nome do modelo, ex: gpt-3.5-turbo ou seu ID específico do Claude.

✅ Passo 4: Testar a Conexão

Conecte um nó Manual Trigger ao seu nó de IA.
Insira um prompt de teste no nó de IA, ex: "Olá, por favor, apresente-se.".
Clique em Execute Node ou Test step.
Verifique o painel Output (Saída) à direita. Se você vir uma resposta da IA, parabéns! Seu modelo personalizado foi integrado com sucesso! 🎉

❓ Solução de Problemas (FAQ)

Q1: Erro Invalid API Key ou AuthenticationError?

Verifique se a Chave de API foi copiada corretamente, sem espaços extras.
Certifique-se de que sua conta CodingPlanX tem saldo suficiente.

Q2: Erro Resource not found ou 404?

Verifique novamente a Base URL no Passo 2. Certifique-se de que ela inclua https://api.codingplanx.ai/v1 (verifique se falta o /v1 ou se há barras finais extras).

Q3: Erro Model not found?

Verifique se o Nome do Modelo que você digitou manualmente está correto. Consulte a lista de modelos do CodingPlanX para obter os IDs exatos.