Matrix 通訊協定 AI 代理工具伺服器 - n8n 工作流程

AI 開發人員與研究人員，用於建構通訊代理。
管理 Matrix機器人（Bot）的系統管理員，需要複雜的代理驅動邏輯。
尋求將外部通訊服務整合到 LangChain 或 AI 調度工作流程中的進階 n8n 使用者。
任何需要強固型 n8n 範本來進行高階聊天自動化的人。

此專用 n8n 工作流程並非傳統的線性自動化；相反地，它作為 AI 代理的綜合性工具伺服器運作。利用專用的 MCP n8n 觸發器，此 n8n 工作流程會註冊 11 個獨立、高度細緻的 Matrix 通訊協定操作。這些操作——範圍涵蓋建立房間、邀請使用者、上傳媒體到擷取訊息歷史記錄——都被公開為可呼叫的函數。

外部 AI 代理（或使用 LangChain 節點在另一個 n8n 工作流程中定義的代理）可以利用此設定，僅需依名稱呼叫所需的 n8n 節點工具並提供參數，即可執行複雜的通訊任務。這是基於 Matrix 通訊協定建構強固、智慧化通訊系統的關鍵 n8n 範本。

此自動化流程利用 Matrix 工具 MCP 伺服器 n8n 觸發器的專用功能。與標準的 Webhook 不同，此 n8n 觸發器設計用於與 AI 調度框架整合，它會等待指令而非執行固定的順序。

1. 工具註冊： 核心邏輯包含 11 個獨立的 Matrix 工具 n8n 節點元件。這些元件中的每一個都透過 ai_tool 連線直接回連至 Matrix 工具 MCP 伺服器 n8n 觸發器。此連線會將特定的 Matrix 操作（例如：『將使用者踢出房間』）註冊為 AI 可用的函數。


2. AI 請求： 當 AI 代理判斷需要與 Matrix 互動時，會向 n8n 觸發器的 Webhook 發送請求，指定要執行的工具以及必要的輸入資料（如房間 ID 或使用者 ID）。


3. 執行： n8n 工作流程會自動將請求路由到指定的 n8n 節點（例如：『建立訊息』）。


4. 動作與回應： Matrix 工具 n8n 節點會執行 Matrix API 呼叫。結果會透過 n8n 觸發器回傳給原始的 AI 代理，讓代理可以繼續其推理過程。

1. 匯入： 複製提供的 JSON，然後透過「工作流程 (Workflows)」選單，選擇「新增 (New)」再選擇「從 JSON 匯入 (Import from JSON)」到您的 n8n 實例中。


2. 憑證設定： 此 n8n 工作流程需要 Matrix 憑證。您必須在 n8n 設定中建立或選取一個 Matrix API 憑證資源。


3. 觸發器設定： Matrix 工具 MCP 伺服器 n8n 觸發器節點會自動配置一個 Webhook ID。您必須啟用工作流程並取得完整的 Webhook URL，才能將其連結到您的外部 AI 代理或調度框架。


4. 啟用： 儲存並啟用 n8n 工作流程，以啟用 AI 工具伺服器。

Matrix 工具 MCP 伺服器 (n8n 觸發器)： 此專用 n8n 觸發器作為 AI 通訊的入口點。它會將所有後續的 Matrix 操作註冊為代理可呼叫的函數，為 AI 工具伺服器提供所需的架構。
Matrix 工具 (11 個實例)： 這是負責與 Matrix API 互動的核心 n8n 節點。使用十一個獨立的實例來定義一套完整的機能：
取得目前使用者的帳號資訊：擷取執行 n8n 節點之使用者的詳細資料。
依 ID 取得事件：擷取特定的事件資料。
將媒體上傳至聊天室：處理檔案和媒體的上傳作業。
建立訊息：發送標準文字訊息。
取得多筆訊息：擷取訊息歷史記錄。
建立房間：啟動一個新的聊天室。
邀請進入房間：邀請指定的用戶加入房間。
加入房間：允許機器人或使用者加入房間。
將使用者踢出房間：用於移除使用者的管理控制權。
離開房間：允許機器人退出房間。
* 取得房間的多位成員：擷取目前在房間內使用者的列表。