我構建了一個點對點橋樑，讓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 商標僅用於描述互操作性。使用者需自行負責代理傳送的內容以及金鑰和管理令牌的安全。