devana-n8n

devana-n8n

Ce module n8n permet d'intégrer l'API Devana AI dans vos workflows n8n.

Installation

Installation dans n8n

Option 1: Installation via l'interface n8n (Community Nodes)

• Ouvrez votre instance n8n
• Allez dans Settings > Community Nodes
• Cliquez sur Install
• Entrez devana-n8n
• Cliquez sur Install

Option 2: Installation manuelle via npm

• Accédez au répertoire de votre installation n8n
• Exécutez:

npm install devana-n8n

• Redémarrez n8n

Option 3: Développement local

• Clonez ce dépôt dans votre répertoire ~/.n8n/custom/

cd ~/.n8n/custom/
git clone <repo-url> devana-n8n
cd devana-n8n
npm install
npm run build

• Redémarrez n8n

Configuration

Credentials

Avant d'utiliser le node Devana, vous devez configurer vos credentials:

• Dans n8n, allez dans Credentials > New
• Recherchez "Devana API"
• Remplissez les champs:
  • API Key: Votre clé API Devana
  • Base URL: L'URL de base de l'API (par défaut: https://api.devana.ai)

Obtenir une API Key

• Connectez-vous à votre compte Devana
• Accédez aux paramètres de votre agent
• Générez une nouvelle API key dans la section "API Access"

Utilisation

Chat Completion

Le node Devana supporte l'opération Chat Completion qui permet d'envoyer des messages à un agent Devana et recevoir une réponse.

Paramètres requis:

• Agent ID (Model): L'identifiant de l'agent Devana à utiliser
• Messages: Au moins un message avec:
  • Role: system, user, ou assistant
  • Content: Le contenu du message

Paramètres optionnels:

• Temperature: Contrôle l'aléatoire (0-1, défaut: 0.7)
• Max Tokens: Nombre maximum de tokens (défaut: 1000)
• Top P: Contrôle la diversité (0-1, défaut: 1)
• Stream: Activer le streaming de la réponse
• Conversation ID: ID d'une conversation existante
• Language: Langue de la réponse (en, fr, es, etc.)
• Files: Liste de fichiers à inclure (séparés par virgule)
• Frequency Penalty: Pénalité de fréquence (-2 à 2)
• Presence Penalty: Pénalité de présence (-2 à 2)
• Response Format: Format de réponse (text ou json_object)
• Identity: Identité personnalisée pour l'agent
• Hidden Mode: Mode caché

Exemple de workflow

{
  "nodes": [
    {
      "parameters": {
        "operation": "chatCompletion",
        "model": "your-agent-id",
        "messages": {
          "messageValues": [
            {
              "role": "user",
              "content": "Bonjour, comment ça va?"
            }
          ]
        },
        "additionalFields": {
          "temperature": 0.7,
          "lang": "fr"
        }
      },
      "name": "Devana",
      "type": "n8n-nodes-devana.devana",
      "typeVersion": 1,
      "position": [250, 300],
      "credentials": {
        "devanaApi": {
          "id": "1",
          "name": "Devana API account"
        }
      }
    }
  ]
}

Développement

Scripts disponibles

• npm run build: Compile le TypeScript
• npm run dev: Mode watch pour le développement
• npm run format: Formate le code avec Prettier
• npm run lint: Vérifie le code avec ESLint
• npm run lintfix: Corrige automatiquement les erreurs ESLint

Structure du projet

n8n_module/
├── credentials/
│   └── DevanaApi.credentials.ts    # Configuration des credentials
├── nodes/
│   └── Devana/
│       └── Devana.node.ts          # Implémentation du node
├── package.json                     # Configuration npm
├── tsconfig.json                    # Configuration TypeScript
└── README.md                        # Documentation

Support

Pour toute question ou problème:

• Documentation: https://docs.devana.ai
• Support: [e-mail]
• Issues: https://github.com/your-org/n8n-nodes-devana/issues

Licence

MIT