集成到应用

按调用边界选择 Runtime 或 SDK，并验证一次完整执行。

集成前先确定 Agent 在哪里运行，以及谁来处理执行事件、会话和权限。不要在浏览器中暴露模型密钥。

​

通过 HTTP 调用

如果你的客户端是网页、移动应用或非 Node.js 服务，使用 Runtime 提供的接口通常更直接。

1. 按 Runtime 快速开始启动服务。
2. 准备 Agent 定义和模型配置。
3. 按运行接口发起请求。
4. 根据交互需求选择响应模式，处理完成、错误与断连。

连续对话还需要管理 Session。对外开放前，应在服务端配置身份认证与访问边界。

​

在 Node.js 中执行

如果需要在自己的进程内定义工具、消费流式事件或编排调用，直接使用 SDK。

从 SDK 快速开始运行最小示例，再根据任务增加 Tools或接入流式响应。现成的学习路径见示例。

​

验证一次完整调用

除正常回复外，至少检查凭据错误、工具失败、用户中断和超时情况下的行为。记录输入、执行结果与错误，让调用方能够区分「任务完成」和「只收到部分输出」。

当多个 Agent 需要集中配置时，可再加入 Hub，不必为最小 SDK 示例先部署完整平台。