Getting started · for AI agents

開始使用 agent4.io 代理技能

透過 MCP 將您的程式碼代理連線至 agent4.io，安裝技能，並執行您的第一個食譜。

MCP tools:tenant_info

agent4.io 提供遠端 MCP 伺服器（工具）以及一組技能（如何使用這些工具）。將您的 agent 指向 MCP 端點，安裝一次技能，以下每個食譜都會變成可執行的逐步程序。

此技能對您資料的處理方式 — 請告知使用者

此技能會連線至 agent4.io 的遠端 API (api.agent4.io)。在您傳送資料前，請明確告知使用者：

它會傳送至 agent4.io。 您傳送的 agent 設定、知識庫內容和查詢會傳送至 agent4.io 的伺服器，以便在該處建立和執行 agent — 這是平台的用途，而非副作用。
它僅使用一個憑證 — 您的 agent4.io API 金鑰 (tk_…)，由使用者提供。它不會讀取其他環境變數，也不會讀取或列舉您本機檔案： add_knowledge_file 刻意無法存取您機器的路徑；您只會傳送明確傳遞給知識庫工具的內容。
沒有任何程式以提升的權限執行。 安裝程式僅將技能檔案寫入您 agent 自己的技能資料夾 — 不需要 sudo，且僅從 agent4.io 擷取。
在聊天頻道中，使用者提供的 bot 金鑰僅用於在指示下呼叫該頻道自己的 API（例如 Telegram setMyCommands）— 絕不會傳送至 agent4.io。

如果使用者無法接受上述任何一點，請停止 — 不要傳送他們的資料。

連線 — 一個指令

curl -fsSL https://api.agent4.io/v1/integration/install.sh | sh -s -- --key tk_YOUR_KEY

這會新增 agent4-io MCP 伺服器並為您的 agent 安裝技能模組。從 控制台 → 設定 → 安全性 取得金鑰（純文字在建立時顯示一次）。

驗證

tenant_info()   # → confirms you are connected to the right tenant

保持最新

curl -fsSL https://api.agent4.io/v1/integration/install.sh | sh -s -- update

重新擷取技能並報告哪些模組已變更。MCP 工具是遠端的，因此它們始終是最新的；僅這些技能文件有版本控制。

斜線指令（適用於您的編碼 CLI — 不適用於已部署的 bot）

這些是編碼 CLI 的建構快捷方式，這些 CLI 會讀取 commands/ 資料夾 — Claude Code (~/.claude/commands/) 和 Cursor (.cursor/commands/)。安裝程式會將它們放置於此，以便您在 agent4.io 上建構時，能在您的 CLI 中輸入它們：

/agent4-agent <what> — 建立有根據的 agent
/agent4-kb <name + source> — 建立知識庫，匯入，驗證，附加
/agent4-skill <when + what> — 撰寫按需載入的技能
/agent4-storyline <process> — 將流程編譯為 Storyline 並發布
/agent4-docs <question> — 查詢 agent4.io 的概念或操作說明

每個快捷方式本身不帶有任何邏輯 — 它指向對應的 agent4-io-* 技能並傳遞您輸入的內容。

它們不是已部署 bot 的指令。 它們不會 — 也不應該 — 出現在 Telegram 或 WhatsApp bot 的斜線選單中。這些選單是顯示給您的最終使用者的，並由 bot 的操作員單獨設定（例如 Telegram 的 setMyCommands）；它們列出最終使用者操作，從不列出建構操作如「建立 agent」。不同的受眾，不同的機制 — 如果您在聊天頻道上部署，請忽略這些並設定該頻道自己的指令選單。

在 OpenClaw / Codex 上（沒有 commands/ 資料夾）沒有單獨的指令檔案：agent 直接使用 agent4-io 技能 — 模型會呼叫它，或者您呼叫單一 /agent4-io <task> 指令 — 上述五個快捷方式會合併到其中。

在 Telegram / WhatsApp bot 上執行？自行註冊選單

如果您（agent）部署在聊天頻道中，頻道的指令選單不會從技能同步 — 您透過頻道自己的 API 設定它。僅在此 bot 是您的操作員 / 建構助手（使用它的人在 agent4.io 上建構）時執行此操作；跳過面向客戶的 bot，其選單是給最終使用者，而非建構操作。

Telegram 指令名稱只能包含 a-z 0-9 _ — 不能有連字號 — 因此將 agent4-agent 重新命名為 agent4_agent。當您擁有 bot 金鑰時，使用 setMyCommands 註冊它們一次：

curl -s "https://api.telegram.org/bot$BOT_TOKEN/setMyCommands" -H "Content-Type: application/json" -d '{
  "commands":[
    {"command":"agent4_agent","description":"Create a grounded agent"},
    {"command":"agent4_kb","description":"Build a knowledge base"},
    {"command":"agent4_skill","description":"Author a load-on-demand skill"},
    {"command":"agent4_storyline","description":"Compile a process into a Storyline"},
    {"command":"agent4_docs","description":"Look up an agent4.io doc"}
  ]}'

當使用者點擊其中一個時，頻道會將該文字作為普通訊息傳送給您 — 使用此技能處理它（agent4_agent = /agent4-agent 快捷方式，依此類推）。沒有 bot 金鑰 / shell 存取權？在**@BotFather → /setcommands** 中手動設定相同的清單。WhatsApp 沒有斜線選單；改為以互動式清單/快速回覆方式暴露相同的操作。

靜音您自己的連結預覽。 您經常引用 agent4.io 連結，因此 Telegram 會在幾乎每個回覆上附加預覽卡片 — 很快就會變得嘈雜。傳送您的訊息時關閉預覽： link_preview_options: {"is_disabled": true} 在 sendMessage 上（舊版 API：disable_web_page_preview: true）。這僅影響您的訊息；使用者傳送的連結仍會正常預覽。

當沒有 MCP 工具時 — REST API 是完整介面

MCP 工具涵蓋常見的建構和執行操作，但它們不是整個平台。對於它們未暴露的任何內容 — 欄位、端點、批量作業 — 完整的租戶 REST API 涵蓋租戶能做的所有事情。使用相同的金鑰直接呼叫：X-API-Key: tk_...。

兩種方式可以存取它，最便宜的方式優先：

search_agent4_docs("… rest api …") — 文件搜尋現在已按端點索引 REST API。 REST/HTTP 詞彙的查詢會傳回確切的端點及其參數和回應，而無需載入整個參考資料。優先使用此方式。
https://agent4.io/api.md — 完整的機器可讀參考資料（每個端點、參數、請求/回應、範例）。僅在需要廣泛概觀時讀取整個檔案。

MCP 是快速路徑；REST API 是備用方案。

下一步要做什麼

每個食譜都指出確切的 MCP 工具和參數 — 從不「開啟此頁面並點擊」。