n8n 連携

本ドキュメントでは、ワークフロー自動化ツール n8n を使用して MaiAgent の複数の AI アシスタントを連携させる方法について詳しく説明します。n8n を活用することで、ワークフローを簡単に構築し、複数アシスタントの連携を実現できます。

前提条件

n8n アカウントを登録済みであること
有効な MaiAgent API キーをお持ちであること
AI アシスタントの構築が完了し、アシスタント ID を取得済みであること
API とワークフローに関する基本的な理解

基本概念

MaiAgent API は、AI アシスタントと対話する機能を提供します。本ドキュメントでは、n8n を使用してこれらの処理を自動化し、複数の AI アシスタントを連携させます。

ワークフローの例

例1：シンプルな AI アシスタント連携ワークフローの構築

このワークフローは、ユーザーのチャットメッセージを受信し、2 つの異なる AI アシスタントを順番に経由して処理することで、直列処理のフローを形成します。

ステップ1：チャットトリガーノードの設定

n8n ワークフローに「When chat message received」ノードを新規追加します
これがワークフローの起点となり、ユーザーがメッセージを送信したときにトリガーされます

ステップ2：1 つ目の HTTP リクエストノードの設定

「HTTP Request」ノードを新規追加し、「When chat message received」ノードに接続します
以下のとおり設定します：
- メソッド：POST
- URL：https://api.maiagent.ai/api/v1/chatbots/{id}/completions/
- id：アシスタント ID
- 認証：Headers
- Headers：Authorization ヘッダーを追加し、値を Api-Key YOUR_API_KEY とします（実際の API キーに置き換えてください）
- リクエストのコンテンツタイプ：JSON
- リクエスト本文：
```
{
  "conversation": "",
  "message": {
    "content": "{{ $json.chatInput }}",
    "attachments": []
  },
  "is_streaming": false
}
```

ステップ3：2 つ目の HTTP リクエストノードの設定

もう 1 つ「HTTP Request」ノードを新規追加し、1 つ目の HTTP Request ノードに接続します
以下のとおり設定します：
- メソッド：POST
- URL：https://api.maiagent.ai/api/v1/chatbots/{id}/completions/
- id：アシスタント ID
- 認証：Headers
- Headers：Authorization ヘッダーを追加し、値を Api-Key YOUR_API_KEY とします
- リクエストのコンテンツタイプ：JSON
- リクエスト本文：
```
{
  "conversation": "",
  "message": {
    "content": {{ JSON.stringify($json.content) }},
    "attachments": []
  },
  "is_streaming": false
}
```

この設定により、1 つ目の AI アシスタントの応答が入力として 2 つ目の AI アシスタントに渡され、直列処理が実現します。

連携の活用シナリオ

シナリオ1：複数の専門家による意見の集約

異なる専門分野のアシスタントがそれぞれの観点を提供し、それらを集約して包括的な回答にまとめます：

法務アシスタントに法的問題を分析させる
技術アシスタントに技術的な実現可能性を分析させる
ビジネスアシスタントにビジネスへの影響を分析させる
最後に集約アシスタントが総合的な提言を行う

シナリオ2：翻訳の改善フロー

初期アシスタントが翻訳を行う
2 次アシスタントが翻訳品質をチェックする
最終アシスタントが表現を推敲・最適化する

シナリオ3：コンテンツ生成とレビューのワークフロー

クリエイティブアシスタントがコンテンツを生成する
レビューアシスタントが正確性と適切性をチェックする
編集アシスタントが推敲とフォーマットの最適化を行う

応用：マルチターン対話ワークフローの構築

例2：対話 ID を使用したマルチターン対話の維持

ステップ1：対話初期化ノードの作成

HTTP Request ノードを新規追加し、初回の対話を行います
設定はこれまでと同様ですが、対話 ID を保存します：

// 対話 ID を保存し、後続の処理で使用する
const conversationId = $json.conversationId;
$workflow.vars.conversationId = conversationId;

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

ステップ2：後続の対話ノードの設定

新しい HTTP Request ノードを追加し、保存済みの対話 ID を使用するように設定します：

{
  "conversation": "{{$workflow.vars.conversationId}}",
  "message": {
    "content": "前の質問に続けて、さらに詳しい情報を提供してください"
  },
  "is_streaming": false
}

トラブルシューティング

よくある問題と解決方法：

API 認証エラー：API キーの形式が正しいことを確認してください。「Api-Key」プレフィックスを含めることを忘れないでください
リクエストのタイムアウト：複雑なクエリの場合は、HTTP リクエストノードのタイムアウト時間を延長してください
ストリーミングモードの処理：is_streaming: true を使用すると、応答モードがストリーミングモードに変更されます

まとめ

n8n を活用することで、MaiAgent の複数の AI アシスタントを簡単に統合・自動化し、強力な AI ワークフローを構築できます。これにより、異なる専門分野のアシスタントが協調して複雑なタスクを完遂できます。シンプルな対話から複雑なマルチアシスタント連携処理まで、n8n は柔軟かつ強力な自動化機能を提供します。

付録：完全なワークフロー JSON

以下は例1の完全なワークフロー JSON 設定です。そのまま 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": []
}

インポート結果

ご不明な点がございましたら、MaiAgent 公式 API ドキュメントまたは n8n 公式ドキュメントをご参照ください。

PreviousGoogle Sheet 連携 NextMaiAgent vs. Dify 比較

Last updated 15 days ago

Was this helpful?