n8n Integration

This document provides detailed instructions on how to integrate multiple MaiAgent AI assistants using the n8n workflow automation tool. Through n8n, you can easily create workflows to achieve multi-assistant integration effects.

Prerequisites

Registered n8n account
Valid MaiAgent API key
Completed AI assistant setup with assistant ID
Basic understanding of APIs and workflows

Basic Concepts

MaiAgent API provides functionality to interact with AI assistants. We will use n8n to automate these processes and integrate multiple AI assistants.

Workflow Examples

Example 1: Creating a Simple AI Assistant Chain Workflow

This workflow will receive user chat messages and process them sequentially through two different AI assistants, forming a chained processing flow.

Step 1: Set Up Chat Trigger Node

Add a "When chat message received" node in the n8n workflow
This will serve as the workflow's starting point, triggered when users send messages

Step 2: Set Up First HTTP Request Node

Add an "HTTP Request" node, connected to the "When chat message received" node
Configure the following settings:
- Method: POST
- URL: https://api.maiagent.ai/api/v1/chatbots/{id}/completions/
- id: Assistant ID
- Authentication: Headers
- Headers: Add Authorization header with value Api-Key YOUR_API_KEY (replace with your actual API key)
- Request Content Type: JSON
- Request Content:
```
{
  "conversation": "",
  "message": {
    "content": "{{ $json.chatInput }}",
    "attachments": []
  },
  "is_streaming": false
}
```

Step 3: Set Up Second HTTP Request Node

Add another "HTTP Request" node, connected to the first HTTP Request node
Configure the following settings:
- Method: POST
- URL: https://api.maiagent.ai/api/v1/chatbots/{id}/completions/
- id: Assistant ID
- Authentication: Headers
- Headers: Add Authorization header with value Api-Key YOUR_API_KEY
- Request Content Type: JSON
- Request Content:
```
{
  "conversation": "",
  "message": {
    "content": {{ JSON.stringify($json.content) }},
    "attachments": []
  },
  "is_streaming": false
}
```

This setup passes the response from the first AI assistant as input to the second AI assistant, achieving chained processing.

Integration Scenarios

Scenario 1: Multi-Expert Opinion Aggregation

Gather perspectives from different specialized assistants and aggregate them into a comprehensive response:

Legal assistant analyzes legal issues
Technical assistant analyzes technical feasibility
Business assistant analyzes business impact
Final aggregation assistant provides comprehensive recommendations

Scenario 2: Translation Improvement Process

Initial assistant performs translation
Secondary assistant checks translation quality
Final assistant polishes and optimizes expression

Scenario 3: Content Generation and Review Workflow

Creative assistant generates content
Review assistant checks accuracy and appropriateness
Editor assistant polishes and optimizes formatting

Advanced Application: Building Multi-Round Conversation Workflow

Example 2: Using Conversation ID for Multi-Round Dialogues

Step 1: Create Conversation Initialization Node

Add an HTTP Request node for initial conversation
Configure similar to previous settings, but store conversation ID:

// Store conversation ID for subsequent use
const conversationId = $json.conversationId;
$workflow.vars.conversationId = conversationId;

return {
  json: {
    ...$json,
    savedConversationId: conversationId
  }
};

Step 2: Set Up Subsequent Conversation Node

Add new HTTP Request node, configured to use saved conversation ID:

{
  "conversation": "{{$workflow.vars.conversationId}}",
  "message": {
    "content": "Continue from the previous question, please provide more details"
  },
  "is_streaming": false
}

Troubleshooting

Common issues and solutions:

API Authentication Error: Ensure correct API key format, including "Api-Key" prefix
Request Timeout: Increase HTTP request node timeout for complex queries
Streaming Mode Handling: Use is_streaming: true to change response mode to streaming

Conclusion

Through n8n, you can easily integrate and automate multiple MaiAgent AI assistants, creating powerful AI workflows that enable different specialized assistants to collaborate on complex tasks. From simple conversations to complex multi-assistant chain processing, n8n provides flexible and powerful automation capabilities.

Appendix: Complete Workflow JSON

Below is the complete workflow JSON configuration for Example 1, which you can directly import into n8n:

{
  "name": "My workflow",
  "nodes": [
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.maiagent.ai/api/v1/chatbots/{id}/completions/",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Api-Key YOUR_API_KEY"
            }
          ]
        },
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "={\n  \"conversation\": \"\",\n  \"message\": {\n    \"content\": \"{{ $json.chatInput }}\",\n    \"attachments\": []\n  },\n  \"is_streaming\": false\n} ",
        "options": {}
      },
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        -240,
        -180
      ],
      "id": "dfc1157d-7569-4caf-8b1d-256aa74515ac",
      "name": "HTTP Request"
    },
    {
      "parameters": {
        "options": {}
      },
      "type": "@n8n/n8n-nodes-langchain.chatTrigger",
      "typeVersion": 1.1,
      "position": [
        -500,
        -180
      ],
      "id": "82748324-6021-4660-98ef-481bdfc73569",
      "name": "When chat message received",
      "webhookId": "5f833c90-a7f9-4c66-8fff-cecc3568cd2a"
    },
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.maiagent.ai/api/v1/chatbots/{id}/completions/",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Api-Key YOUR_API_KEY"
            }
          ]
        },
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "={\n  \"conversation\": \"\",\n  \"message\": {\n    \"content\": {{ JSON.stringify($json.content) }},\n    \"attachments\": []\n  },\n  \"is_streaming\": false\n} ",
        "options": {}
      },
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        20,
        -180
      ],
      "id": "f0a80b1f-1bed-491b-bc5e-cddb87ccd2d5",
      "name": "HTTP Request1"
    }
  ],
  "pinData": {},
  "connections": {
    "When chat message received": {
      "main": [
        [
          {
            "node": "HTTP Request",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "HTTP Request": {
      "main": [
        [
          {
            "node": "HTTP Request1",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "HTTP Request1": {
      "main": [
        []
      ]
    }
  },
  "active": false,
  "settings": {
    "executionOrder": "v1"
  },
  "versionId": "c914db70-985a-48d0-a1ca-47c2a0d4f244",
  "meta": {
    "instanceId": "2eb51fcaa84ba34149e7fc138f6cac3b20a0038764b284579d6ceaea90b669f8"
  },
  "id": "pvMcKA5hHmwAKuZT",
  "tags": []
}

Import Result

For any questions, please refer to MaiAgent's Official API Documentation or n8n's Official Documentation.

PreviousGoogle Sheet Integration NextMaiAgent vs. Dify Comparison

Last updated 1 month ago

Was this helpful?