查看 Markdown

集成工具

任意 Hub 触发器都可以通过 Hub MCP 服务器为 Agent 授予受控的 Slack 和 Discord 工具。每日定时任务可以向 Slack 发送 CI 摘要,webhook 处理器可以先读取最近的 Discord 上下文再发布更新,GitHub 触发器也可以通知 Slack 频道,无需在 daemon 上安装外部 CLI 或存放聊天令牌。

Hub 将 Provider 令牌保留在服务端,并在每次工具调用时校验连接、操作类型和频道白名单。

在控制台或 YAML 中配置

  1. 在 Hub 触发器编辑器中打开 Integration access。
  2. 选择 Add integration,然后选择 Slack 或 Discord。
  3. 在 Connection 中选择集成。
  4. 在 Channel IDs 中输入允许访问的频道 ID。
  5. 选择 Read messages、Post messages 或两者。

在 .paseo/triggers/*.yml 中添加 run.tools:

name: nightly-digest
on:
  schedule.tick:
    recurrence:
      start: "2026-09-09T08:00:00"
      rule: "FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR"
      timezone: America/New_York
run:
  target:
    daemon: devbox
    cwd: /workspace/project
  agent:
    provider: codex
    mode: full-access
  continuation:
    mode: new
  tools:
    slack:
      connection: engineering-slack
      actions: [post]
      channels: [C012AB3CD]
    discord:
      connection: community-discord
      actions: [read, post]
      channels: ["123456789012345678"]
  prompt: |
    Scan recent Discord messages with discord_latest, summarize open bugs,
    and post the digest to Slack channel C012AB3CD with slack_post.
    Call finish_execution when done.

授权字段

字段必填说明
connection是来自 Integrations 的集成 slug,例如 engineering-slack。
actions是非空列表,包含 read、post 或两者。
channels是显式白名单,包含 1 到 50 个频道 ID。Discord snowflake ID 请用引号括起作为字符串。

查看查找 Slack ID和查找 Discord ID以复制频道 ID。

可用的 Hub MCP 工具

权限向 Agent 开放的工具
Slack readslack_list_channels 列出已授权的频道 ID。slack_read 读取频道或讨论串消息(支持 limit、thread_ts 和来自 nextCursor 的 cursor)。
Slack postslack_post 向已授权频道发消息,或通过起始消息的 thread_ts 在讨论串中回复。
Discord readdiscord_list_channels 列出已授权的频道和论坛。discord_read 读取频道、论坛、讨论串或精确消息 URL(使用 nextBefore 传入 before)。discord_latest 扫描已授权频道的近期消息,包括活跃和近期归档的讨论串。
Discord postdiscord_post 向已授权频道发消息、在讨论串中回复,或在频道消息上开启上下文讨论串。

校验与行为

  • Hub 会在每次工具调用时对照声明的 connection、actions 和 channels 进行校验。只有在讨论串父频道位于 channels 白名单内时,才允许访问对应的 Discord 讨论串和论坛帖子。
  • 当 Hub 配置了 HTTPS 地址且记录了 daemon Agent 时,拥有 post 权限的 Agent 会在请求上下文中收到该次运行的 Open in Paseo URL,方便摘要和报告直接链接到会话。
  • 由于工具契约绑定在活动会话上,修改持续运行的触发器中的 run.tools 时,下一次运行需要使用 New agent(continuation: { mode: new })或新的延续键。
  • 如果你的 run.tools 块使用了 YAML 锚点或别名,请在 YAML 视图中编辑触发器,以便 Hub 完整保留这些引用。

赞助商