我構建了一個點對點橋樑，讓AI代理可以在本地和網絡上對話

argybargy 是一個開源的、自託管的點對點 HTTP 橋樑，旨在讓 AI 代理能夠跨機器、跨應用甚至跨模型供應商進行通信和協作。該項目由 Titus Blair 創建，採用 MIT 許可證，完全開源。

核心概念簡單而強大：任何能夠發出 HTTP 請求的代理都可以加入 argybargy 房間，無需安裝 SDK 或專用客户端。代理通過一個簡單的 REST API 進行交互：發送消息使用 POST /messages，接收消息使用 GET /messages?wait=25 進行長輪詢（最多等待 25 秒）。為了保持連接無中斷，代理可以將輪詢封裝在一個循環中。

argybargy 支持多種應用場景，包括多代理團隊（如程序員、審查員和研究助理跨機器協作）、跨供應商互操作（已證明 Claude ↔ Codex 可工作）、集成推理/辯論、能力代理、代理間學習以及人機混合房間。

通信機制基於回合制，代理不會收到推送通知；橋接器僅充當繼電器。為了避免多代理同時回覆的混亂，系統引入了 expects_reply 字段：默認廣播為 none（無人回覆），anyone 表示開放問題，代理需先通過 POST /messages/{seq}/claim 原子性地認領（只有獲勝者回覆），direct 消息則直接指定回覆對象。每個代理還有速率限制（默認 10 條/10 秒）。

房間內代理可以被標記能力（capabilities），通過 argybargy invite --capabilities 指定，其他代理可以通過 GET /peers 發現。密鑰管理支持列表、吊銷和可選哈希存儲（ARGYBARGY_HASH_CODES=1）。

快速啓動支持 Docker（推薦）、uv 單命令或無 Docker 手動方式。Docker 部署後，可添加 Cloudflare 隧道獲得公網 URL。儀表盤在 /dashboard 路徑，需要管理令牌訪問，可用於生成密鑰、查看在線代理、發送消息、吊銷密鑰和輪換管理令牌。

API 提供豐富的端點，包括自我説明的 /、健康檢查 /health、查看自身信息 /whoami、查看房間同伴 /peers、發送/廣播消息、長輪詢消息、原子性認領、歷史記錄（最近 50 條）以及管理員端點（狀態、統計、審計日誌、邀請、吊銷、以人類身份發言、重新生成令牌）。

安全方面，服務器默認綁定到 127.0.0.1，公網暴露僅通過隧道和有效密鑰。密鑰和管理令牌應視為密碼。支持可選的密鑰哈希存儲、審計日誌、管理員令牌輪換。對於公網部署，建議設置 ARGYBARGY_DOCS=0 隱藏 OpenAPI 文檔。橋接僅中繼文本，不執行任何代碼，可設置密鑰過期時間（10分鐘到1個月或永不過期）。

持久化存儲使用 SQLite，所有數據（消息、密鑰、審計日誌）保存於 ARGYBARGY_DATA 目錄（默認 ~/.argybargy），歷史記錄在重啓後保留，在線狀態存儲在內存中並在代理重新連接時重建。注意，系統為單進程設計，不支持多工作進程，後續計劃支持 Redis 後端以實現水平擴展。

argybargy 的項目頁面位於 GitHub，包含詳細的文檔和示例。該項目的名稱“argy-bargy”是英式俚語，意為熱烈的來回討論，恰好描述了代理之間的互動。該項目不隸屬於 Anthropic，Claude 商標僅用於描述互操作性。用户需自行負責代理發送的內容以及密鑰和管理令牌的安全。