🚀 Conectando Modelos Personalizados CodingPlanX ao Dify
Este tutorial irá guiá-lo na integração das APIs e modelos do CodingPlanX em sua plataforma Dify para aproveitar os recursos de IA personalizados.
📋 Pré-requisitos
Antes de começar, certifique-se de ter:
- Acesso ao Dify: Uma instância do Dify auto-hospedada ou uma conta no Dify Cloud.
- Chave de API: Uma Chave de API (API Key) válida da plataforma CodingPlanX.
⚙️ Passos de Configuração
Passo 1: Acessar Configurações de Provedores de Modelo
- Faça login no console do Dify.
- Clique no seu Ícone de Perfil no canto superior direito e selecione Settings (Configurações).
- Na barra lateral esquerda, clique em Model Providers (Provedores de Modelo).
Passo 2: Adicionar um Modelo Personalizado
Como o CodingPlanX é compatível com a OpenAI, usamos o provedor OpenAI-API-compatible.
- Role a página Provedores de Modelo para baixo até encontrar OpenAI-API-compatible.
- Clique no botão Add Model (Adicionar Modelo) no cartão.
Passo 3: Preencher Parâmetros de Configuração
Preencha a janela pop-up exatamente da seguinte forma:
| Parâmetro | Valor / Exemplo | Descrição |
|---|---|---|
| Model Type (Tipo) | LLM | Selecione o tipo de modelo (Large Language Model). |
| Model Name (Nome) | ex: gpt-4-turbo ou claude-3-opus | Obrigatório. Use o ID exato do modelo fornecido pelo CodingPlanX. |
| API Key | sk-xxxxxxxxxxxxxxxxxxx | Obrigatório. Sua Chave de API do CodingPlanX. |
| API endpoint URL | https://api.codingplanx.ai/v1 | Obrigatório. (⚠️ Nota: Deve incluir o sufixo /v1). |
| Context Length (Contexto) | 8192 | Contagem máxima de tokens suportada pelo modelo. |
| Max Token Limit (Limite) | 4096 | Máximo de tokens permitidos para uma única resposta. |
> 💡 Dicas Profissionais:
> * Sobre a URL da API: Embora o domínio base seja https://api.codingplanx.ai, o Dify requer o caminho completo: https://api.codingplanx.ai/v1.
> * Sobre o Nome do Modelo: Se não tiver certeza do ID, verifique a documentação oficial do CodingPlanX para a string exata do ID do Modelo.
Passo 4: Salvar e Verificar
- Clique em Save (Salvar) após verificar todos os detalhes.
- Se for bem-sucedido, o modelo aparecerá na sua lista de provedores.
🧪 Testando a Configuração
- Vá para o Studio do Dify e crie ou abra um Aplicativo (ex: um Assistente de Chat).
- Na área de Seleção de Modelo no canto superior direito, clique no menu suspenso.
- Encontre o grupo
OpenAI-API-compatiblee selecione seu modelo CodingPlanX. - Envie uma mensagem na janela de depuração. Se a IA responder, está tudo pronto! 🎉
❓ Solução de Problemas (FAQ)
Q1: "Connection failed" ou "Invalid API Key" ao salvar?
- Verifique se há espaços extras na Chave de API.
- Certifique-se de que a URL termina com
/v1. - Verifique se o seu servidor consegue acessar
https://api.codingplanx.ai.
Q2: "Model not found" durante o chat?
- O Nome do Modelo inserido não existe ou você não tem acesso a ele. Verifique novamente a ortografia (diferencia maiúsculas de minúsculas).
Q3: As respostas estão sendo cortadas?
- Verifique se o Max Token Limit (Limite Máximo de Tokens) está definido muito baixo. Tente aumentá-lo para 2048 ou 4096.