> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zerone.run/llms.txt
> Use this file to discover all available pages before exploring further.

# 集成到应用

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

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

## 通过 HTTP 调用

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

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

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

## 在 Node.js 中执行

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

从 [SDK 快速开始](/zh/sdk/quickstart)运行最小示例，再根据任务增加 [Tools](/zh/sdk/tools)或接入[流式响应](/zh/sdk/streaming)。现成的学习路径见[示例](/zh/sdk/examples)。

## 验证一次完整调用

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

当多个 Agent 需要集中配置时，可再加入 [Hub](/zh/guides/team-platform)，不必为最小 SDK 示例先部署完整平台。