跳转到主要内容
YCloud Developer Kit 可帮助你的 AI 编程智能体在现有项目中规划集成、生成服务端代码并测试工作流。描述你想要构建的内容，例如 WhatsApp 订单通知、预约提醒或客户支持，智能体将使用 YCloud API 约定来指导开发工作。 你还可以要求智能体审查现有集成，或使用你配置的服务端凭据执行特定的线上 API 操作。

​
开始之前

对于安装和本地开发，你需要准备：
  • Codex、Claude Code 或 WorkBuddy。
  • 终端中可用的 Node.js 和 npx。
  • 要在其中构建集成的项目。
安装检查或使用 Mock 的测试不需要 YCloud API Key。对于线上 API 请求，你需要一个 YCloud 账户、服务端 API Key 以及工作流所需的资源。有关凭据设置，请参阅身份验证。

​
安装技能

从你的项目目录运行对应编程智能体的命令。每个命令都会在该项目中安装全部 17 项技能。
若要以交互方式选择编程智能体，请运行：
你可以在官方发布页面找到带版本号的插件 ZIP 压缩包和校验和。

​
检查安装情况

在编程智能体中启动新会话并发送：
预期响应为：
此项检查可确认智能体能够发现并调用安装就绪检查技能。它不会读取凭据、调用 YCloud，也不会验证你的账户配置。 如果智能体找不到该技能，请确认你是否在正确的项目中运行了安装命令、选择了正确的智能体，并为该项目打开了新会话。

​
构建你的第一个集成

描述你的业务目标、项目技术栈以及所需的结果。当工作流程涉及多项功能（例如模板、消息发送和 Webhook）时，请从 ycloud-integration-architect 开始。 例如，在你的应用程序项目中发送以下提示词：
智能体会为你所选的工作流程使用相关的领域技能。检查生成的代码和测试结果，然后在请求线上测试之前配置所需的 YCloud 资源。 在适当时向智能体提供以下上下文信息： 请通过你的服务器配置或机密管理器引用凭据。切勿将 API Key 或 Webhook 签名密钥直接粘贴到提示词中。

​
工具包涵盖的内容

版本 0.7.13 包含 17 项技能，涵盖 88 项 API 操作，以及 API 身份验证和 Webhook 接收。下表按你可以请求的工作内容对领域技能进行了分组。 其余两项技能是负责跨域协调工作流的 ycloud-integration-architect，以及负责检查安装就绪状态的 ycloud-developer-kit-smoke-test。
此版本不涵盖 SMS、Verify、Voice 或 Email 集成。这些产品仍可通过 YCloud API 使用。有关集成详情，请参阅各自的 API 指南和参考页面。

​
更多示例提示词

​
添加入站消息和 Webhook

​
审查现有集成

​
查询线上数据

​
本地测试与线上操作

本地 Mock 测试可让你使用合成数据检查应用程序行为。通过 Mock 测试并不代表线上身份验证、消息传递或生产环境部署已确认无误。 对于线上操作，请指定账户、环境、目标资源和操作。智能体会在该范围内使用已配置的凭证。当目标或影响不明确时，它会要求提供缺失的详细信息。在本地开发代码的请求并不意味着授权无关的线上变更。 对于消息发送和其他异步操作，请注意区分已接受的请求与其实际最终结果。请通过相应的查询 API 或 Webhook 验证送达或完成情况。如果线上变更发生超时，请在重试之前检查可用的资源状态。

​
后续步骤

发送 WhatsApp 消息

准备消息模板、有效负载以及送达处理。

配置 Webhook

将你的应用程序连接到入站消息和状态更新。