插件

連接外部服務，為任務添加專門的工具。

插件把文檔處理、圖像生成、外部數據和其他工具接入 EvoX。本頁介紹如何選擇工具、限定任務範圍、調用並驗收結果；如果想先了解技能與插件的區別，閲讀技能與插件。

瞭解插件的狀態

內置插件、自定義插件和 MCP 服務器在擴展管理界面中管理。找到一個插件後，不要只看它是否“已安裝”，還要檢查連接狀態和可用工具。

• 已安裝：插件已加入當前環境，不代表所需賬號或服務已經連接。
• 已連接：服務連接已建立，仍需確認它公開了哪些工具。
• 可用或已就緒：完成調用所需的準備；具體任務是否能執行，還受賬號權限、文件範圍和確認流程限制。
• 不可用：先查看狀態信息，排查配置、憑證、進程或網絡問題，再重新測試。

圖中狀態用於説明管理界面，不代表你的設備已經安裝或連接了這些插件。

準備可用插件

先按插件與應用連接完成安裝、賬號連接和工具檢查，再回到任務中使用。這裏從“工具已經就緒”開始，説明如何交付和檢查結果。

核對任務所需連接

調用前確認賬號、目標項目或文件夾，以及工具列表是否包含所需操作。連接步驟和憑證字段見插件與應用連接，手動服務器見MCP 服務器。

在任務中使用插件

直接描述任務

説明目標、數據來源和範圍，讓 EvoX 在當前可用工具中完成工作。例如：

查找已連接文檔服務中本週更新的項目記錄，整理標題和摘要，保留來源鏈接。只讀取，不修改原文。

如果任務涉及外部寫入，把目標和確認點説清楚：

根據這些記錄起草一份更新説明，先給我檢查，確認後再寫入指定文檔。

這些是請求方式示例。插件必須實際公開相應的讀取或寫入工具，才能完成操作。

明確選擇插件

協作模式可以從插件列表選擇所需插件。會話和編碼模式使用該入口與插件聲明支持的 @插件 或專用命令調用工具；通過 /mcp 檢查服務器狀態，調用前核對工具範圍。

當多個服務都能處理同類任務時，説明使用哪個連接、哪個項目或文件夾，避免來源含糊。插件被關閉、未連接或缺少憑證時，先修復該連接，再繼續任務。

查看 MCP 與技能

/mcp 打開統一的 MCP 狀態面板，用於檢查服務器及其連接狀態。編碼模式中的 /skills 進入技能管理。

技能提供可複用的操作方法；MCP 服務器提供可調用工具。它們可配合完成任務，但技能入口不等於插件目錄，也不代表已經獲得外部服務權限。

區分未安裝、已關閉和連接失敗

找不到插件工具時，先查看狀態，再決定下一步。已經安裝但連接失敗的插件不需要重新安裝。

刷新失敗時仍顯示的舊狀態只説明此前的連接結果。連接恢復後，檢查工具列表是否包含本次任務所需的操作，再繼續。

權限與數據範圍

安裝插件不會自動授權所有操作。讀取數據、修改數據以及發送或發佈內容，是不同的動作，應分別核對。

• 賬號範圍：插件只能訪問已連接賬號獲得授權的資源，項目歸屬不會自動賦予賬號權限。
• 工具範圍：插件只能調用公開的工具；不能因為安裝了文檔插件，就推斷它能控制整個應用。
• 外發範圍：調用前確認哪些文本、文件或圖片會傳到服務端。
• 寫入範圍：發送、刪除、發佈、購買和創建遠端資產應保留人工確認。

使用圖像和語音等插件前，還需檢查供應商配置和調用費用，具體參見圖像生成和語音。

任務結束後的連接管理

檢查產物、寫入記錄和授權範圍，確認沒有額外發送或修改。需要停止使用時，按停用與移除處理連接；本地停用與服務端撤銷授權分別管理。

排查常見問題

接下來

• 技能與插件：入門概念與使用方式。
• 權限：理解任務執行的確認邊界。
• 設置：查找服務與產品配置。