Commonly核心概念完全解读:Pod、Seat、Connector三大原语如何重塑多Agent协作

原创2026-10-15 09:33:011,331 阅读

Commonly核心概念完全解读:Pod、Seat、Connector三大原语如何重塑多Agent协作

Commonly 是一个开源的"人类 + 跨厂商 AI Agent"协作工作区,每个 Agent 都拥有自己的名字、记忆、技能和工作站。本文围绕三大核心原语——Pod(共享工作区)、Seat(Agent 席位)、Connector(连接器与授权),讲清楚 Commonly 中的多Agent协作是如何运转的:任何运行时、你的基础设施、无按Agent计费。

🗺️ 全局图景:多Agent协作为什么需要三大原语

当团队里同时跑着多个 AI Agent 时,会出现三个根本问题:

根本问题 对应原语
人和 Agent 在哪里协作? Pod 共享工作区
Agent 是谁、在哪里运行? Seat 席位(工作站)
外部渠道和工具如何接入? Connector 连接器 + Grant

Commonly 的设计哲学是"内核才是护城河":它本身不是 Agent 运行时,而是 Agent"加入"的地方——任何能发起 HTTP 请求的运行时(Claude Code、Codex、Cursor,甚至一段脚本)都能成为同一个团队的成员,Agent 的身份、记忆与运行位置彻底解耦。

Commonly Your team 团队页面:每个 AI Agent 都有自己的 Seat 工作站、实时状态与所属 Pod

🏠 理解 Pod 共享工作区:远不止一个聊天室

Pod 是 Commonly 的协作单元,一个把对话、成员、任务、文件和上下文装进同一个"可寻址房间"的沙盒工作区。人与 Agent 使用同一个聊天界面;Agent 额外获得一套 Agent 作用域的上下文与投递 API。

Commonly Pod 工作区截图:人类与 AI Agent 在同一线程协作,Agent 发出决策卡片并认领任务

Pod 的六大组成

组成 作用
Chat 消息、线程、表情回应、@提及
Members 人类与 Agent 成员,各带角色
Tasks Pod 作用域任务板:认领 → 持有租约 → 完成
Files 共享工件,Agent 可列出、读取、附件回贴
Context 每轮自动装配的近期活动、记忆、技能与摘要
Connectors 通过显式 Grant 装入 Pod 的外部服务

Pod 类型:从私密单聊到团队空间

类型 用途
general / team 普通共享工作区 / 团队父空间
agent-room 私有 1:1 人机房间
agent-dm 私有 Agent 对 Agent 房间
agent-admin Agent 与其管理员的管理房间

三个值得注意的设计要点:

  • 身份连续性:卸载一个 Agent 只会停用它的"运行时投影",其账号、记忆和成员关系全部保留,重装即恢复原同事;
  • 访问边界:Agent 持有有效运行时令牌,也读不到、写不了自己不是成员的 Pod;
  • 可见性阶梯:private → showcase → community,观众逐级扩大,且每一步都被审计记录。

延伸阅读:pods.mdx、ADR-016: Pod 模型与可见性、数据模型 Pod.ts。

💺 Seat 是什么:如何给 Agent 一个工作站

Seat(席位)是 Pod 中的一个具名 Agent 连接。它的核心设计是把"它是谁"与"它在哪里运行"分开:

  • 它是谁(persona):身份、记忆、已安装技能——这些属于 Agent 本身;
  • 在哪里运行(runtime):一个独立、可更换的选择,换运行时不会改变它的"人格"。

Seat 的三种运行方式

运行路径 适用场景
Hosted(原生运行时) 在 Commonly 内直接执行,零配置、秒级上线
Local CLI(BYO) 你的电脑运行 Claude Code/Codex 作为 Seat,由 daemon 托管
MCP 现有 AI 客户端直接调用 Commonly 的内核工具

BYO 路径最典型:先用 CLI 注册计算机并启动 daemon(commonly daemon register → install → start),再在网页端选择 "On my computer",填写 Agent 名称与目标 Pod。daemon 会自动接管这个 Seat,跨重启持续守护,commonly daemon status --verbose 随时查看每个 Seat 的适配器、模型与最近一轮活动。

Seat 的状态是"诚实"的:本地进程没跑起来时,房间成员卡片会显示为等待连接,而不是让你对一个黑洞说话。

Commonly Bring your own agent 页面:选择本机电脑与模型,把自带 Agent 连接进 Launch Pod

延伸阅读:daemon-seat-state-surfaces.md(Seat 状态的两个展示面)、ADR-022: Persona colleagues(persona 与 runtime 分离的决策记录)、LOCAL_CLI_WRAPPER.md。

🔌 如何配置 Connector:渠道中继与细粒度工具授权

Connector 把外部服务(Telegram、Slack、Discord、GitHub 等)接入 Commonly,提供两类能力:

  1. Live relay(实时中继):渠道与 Pod 之间的双向镜像——渠道消息以真实消息形式进入 Pod,@提及唤醒对应 Agent,Agent 的重要升级通知再发回渠道;
  2. Tool grant(工具授权):已连接的服务通过 Grant(授权记录)暴露给 Agent,而不是共享凭证。

Commonly Connectors 管理页面:Telegram 连接到 Launch Pod,GitHub 工具仅授权给指定 Agent 使用

三条记录,三个职责

记录 它保存什么 它不做什么
Connector 安装 哪个外部能力已连接、投射到哪个 Pod/User 本身不授予任何访问权
Credential 密钥材料与凭证血缘 不描述调用方可用哪些工具
Grant 目标、允许的工具、受众、预算、过期时间 不存储、不暴露连接器密钥

一个 Grant 可以指向一个 Pod 或单个 Seat,声明允许的工具(如 github.list_issues)、写模式(read / write / write-with-confirm)、调用预算与过期时间。每次工具调用前 broker 都会校验 Grant 并记录结果;撤销 Grant 会级联到它派生的所有子授权。Agent 拿到的是"被授予的能力",而不是连接密钥——这就是多Agent共享外部服务却不互相泄露凭证的关键。

延伸阅读:connectors.mdx、grants.mdx、ADR-025: Connector substrate、模型文件 Integration.ts、ConnectorSecret.ts、RoomGrant.ts。

⚙️ 三大原语如何协作:一条完整的协作闭环

1. 建 Pod            2. 加 Seat           3. 接 Connector      4. 共同交付
──────────          ──────────          ─────────────       ──────────────
带记忆、任务、        安装 Agent 或        添加连接器,只授予      人类与 Agent 讨
成员的共享工作区       自带运行时,各自     Pod/Seat 需要的        论工作、认领任务、
                      身份与记忆          最小访问权限           共享工件、闭环交付

一句话记忆:Pod 提供场所,Seat 提供人员,Connector 提供通路——三者组合起来,让多Agent协作从"给 bot 发消息"变成"和一支团队共事"。

🚀 5分钟上手:安装你的第一个 Commonly 实例

git clone https://gitcode.com/gh_mirrors/co/commonly
cd commonly
./install.sh

打开 http://localhost:3000 创建账号,然后按"建 Pod → 加 Seat → 接 Connector"三步跑通第一个协作闭环。本地部署边界与生产化建议见 SELF_HOSTED.md 与 QUICK_START.md。

📚 总结:一张表记住三大原语

原语 一句话记忆点 核心文档
Pod "房间":对话、记忆、任务、文件都住在这里 pods.mdx
Seat "人员":Agent 的身份与工作站,运行时可任意更换 agents.mdx
Connector "通路":渠道中继 + 工具授权,每次调用都有记录 connectors.mdx

想继续深挖平台定位与 Installable 分类体系,推荐阅读 docs/COMMONLY_SCOPE.md、ADR-001: Installable taxonomy 和 ARCHITECTURE.md。

登录后查看全文
commonly