Cloud Code SDK & GitHub Action

动态交互式视频摘要

什么是 Cloud Code SDK？
  • 核心理念：它是一个全新的“构建基块” (building block)，允许以编程方式在无头模式 (headless mode)下调用 Cloud Code 智能体的强大能力。
  • 主要用途：
    • 类 Unix 工具：可无缝集成到终端管道 (pipeline) 中，处理标准输入/输出，像cat log | cloud-b ...一样使用。
    • CI 自动化：实现自动化代码审查 (code review)、根据自然语言描述编写新的代码检查器 (linter)。
    • 自定义应用：作为底层能力，构建您自己的聊天机器人或远程代码生成工具。
  • 未来计划：官方即将推出 Python 和 TypeScript 的 SDK 绑定，简化集成。
核心功能与示例
  • 权限管理：通过 --allow-tools 标志，可以精细化地预先授权，例如 write (文件写入)、bash (执行Shell命令) 或自定义的 MCP 工具。
  • 结构化输出：使用 --output-format JSON 获取机器可读的 JSON 响应。这是构建自动化应用和工具的关键。
  • 会话保持：利用响应中返回的 session ID，可以在后续请求中恢复上下文，实现多轮连续对话。
  • 架构剖析：GitHub Action 本身就是基于 SDK 构建的，分为三层：SDK (底层) -> Base Action (封装) -> PR Action (高级交互)。这种分层设计本身就是使用 SDK 的一个绝佳范例。
实战演示：GitHub Action
  • 触发方式：在 GitHub Issue 或 Pull Request 的评论区，通过 @cloud 提及机器人并用自然语言下达指令。
  • 演示任务：
    1. 实现新功能：从一个仅有标题的 Issue 出发，为问答 App 实现了“道具”功能（50/50 排除选项、跳过问题）。
    2. 修改现有代码：在一个已有的 PR 上，根据指令“change this to green”，将背景色从蓝色修改为绿色。
  • 核心价值：整个开发过程都在标准的 GitHub Runner 上自动执行，用户无需管理和维护任何额外的基础设施，极大地简化了工作流。
行动指南：如何开始使用
  • 目标：将强大的 Cloud 智能体集成到您的 GitHub 工作流中。
  • 操作步骤：
    1. 在您本地的项目仓库目录中，打开终端并启动 Cloud Code。
    2. 在 Cloud Code 交互界面中，输入命令：/install-github-action
    3. 程序将引导您完成配置，并自动创建一个包含所需 YAML 配置文件的 Pull Request。
    4. 在 GitHub 上合并这个 PR，并根据指引配置好您的 API Key 等密钥。
  • 特别注意：如果您是 Bedrock 或 Vertex 用户，安装过程略有不同，需要参考官方文档进行更手动的配置。
➡️ 前往 GitHub Action 仓库获取更多信息

原文

源链接