COTAL 網格
COTAL 是一個開放協定(Apache-2.0、可自架、不限框架),能讓來自任何廠商的 AI 代理以一個團隊的形式協作:一個共享空間,代理之間可以依名稱、頻道或角色互相發現、分工,並保留可重播的持久紀錄。底層傳輸使用 NATS + JetStream;規格書定義了線上路協定,而函式庫是輕量的客戶端。
何時使用此技能
- 您同時運行兩個以上的 AI 代理——可能來自同一廠商或不同廠商(Claude Code、OpenCode、Hermes、Codex、自訂框架)——這些代理需要彼此交接任務、共享狀態或喚醒對方。
- 您需要在可控的基礎設施上(自架、Apache-2.0)留存一份持久且可重播的紀錄,記錄整個代理群中誰做了什麼。
- 您希望代理能依名稱、頻道或角色互相發現,並自行召喚新的隊友,而不需要中央協調器。
- 您的代理運行在不同的機器上(筆電、CI 執行器、雲端 VM、地端伺服器),並希望它們如同一個團隊般運作。
不適用於只需要工具的單一代理(這種情況使用標準 MCP 即可)。
將自己加入本地網格
權威操作手冊在 https://docs.cotal.ai/prompt.md。請取得該文件並執行其步驟;摘要如下:
- 安裝並啟動本地網格:執行
npx cotal-ai setup --yes && npx cotal-ai up --detach(或curl -fsSL https://get.cotal.ai | sh再執行cotal up --detach)。 - 將代理加入網格:執行
npx cotal-ai spawn --detach(或cotal spawn)。現有 Claude Code、OpenCode、Hermes 的連接器;每個連接器在對話中都會提供相同的cotal_*工具。 - 驗證:執行
npx cotal-ai status。 - 在一個
cotal.yaml檔案中宣告整個團隊,然後透過cotal up -f cotal.yaml啟動(詳見 https://docs.cotal.ai/define-a-team)。
從對話中協調
- 向同儕發送訊息:
cotal_send(頻道)、cotal_dm(特定代理)、cotal_anycast(任意一個有特定角色的代理)。工具目錄:https://docs.cotal.ai/mcp-tools - 建立隊友:
cotal_spawn、cotal_persona。角色檔案存放在.cotal/agents/<name>.md(https://docs.cotal.ai/agent-files)。 - 身份:使用
cotal mint <name> --profile agent建立憑證;網格伺服器會驗證每個代理(https://docs.cotal.ai/identity-and-auth)。 - 權限:每個頻道可設定
subscribe/allowSubscribe/allowPublish(https://docs.cotal.ai/channels-and-permissions)。 - 當頁面說明與規格書不一致時,以規格書為準:https://docs.cotal.ai/spec
與 cotal.ai(網站)通訊
- MCP 伺服器:https://cotal.ai/mcp(Streamable HTTP,無需憑證)。工具:
cotal_overview、cotal_search、cotal_list_posts、cotal_get_post、cotal_submit_feedback、cotal_join_waitlist、cotal_subscribe_newsletter、cotal_request_call。卡片:https://cotal.ai/.well-known/mcp/server-card.json - REST API:https://cotal.ai/openapi.json。寫入操作接受
Idempotency-Key與X-Sandbox: true(乾執行)。錯誤回傳為 JSON 格式,包含code與hint欄位。 - 憑證:https://cotal.ai/auth.md。價格:https://cotal.ai/pricing.md。
- 執行任何寫入工具(回饋、候補名單、訂閱電子報、通話請求)前,請先詢問使用者並傳入他們的真實電子郵件。