# 选择接入方式 (/docs/developers/agent/embed/overview)



选择对话出现的位置，再决定由谁编写界面。PraxisKit、iframe 和 Hosted 提供对话界面；API 适合自己实现界面的应用。

## 比较接入方式 [#compare]

| 方式     | 用户在哪里对话         | 你需要实现          | 外观入口                  | 开始接入                                             |
| ------ | --------------- | -------------- | --------------------- | ------------------------------------------------ |
| Kit 组件 | 你的网页内           | 宿主签发端点、组件初始化   | 宿主代码的 `setOptions`    | [嵌入到网页](/docs/developers/agent/embed/quickstart) |
| iframe | 网页内的独立框架        | 宿主签发端点、一行加载脚本  | 控制台保存，脚本可覆盖布局         | [一行嵌入](/docs/developers/agent/embed/iframe)      |
| Hosted | Praxis 托管的独立对话页 | 宿主验证身份、签发链接并跳转 | 与 iframe 共用保存的外观；全页显示 | [打开托管对话](/docs/developers/agent/embed/hosted)    |
| API    | 你自己的网页、App 或服务  | 会话、事件处理与所需界面   | 由你的应用决定               | [运行第一个智能体](/docs/developers/agent/quickstart)    |

## 按任务选择 [#choose]

需要在网页里调整组件、控制打开时机或连接页面交互时，选择 Kit。Kit 是 Web Component，也能在 React 应用里挂载；你在宿主代码中设置界面选项。

只想插入现成对话界面、把外观交给控制台维护时，选择 iframe。这里的“一行”指加载脚本，登录用户的后端签发端点仍需实现。复制一个裸 iframe 地址不能代替身份验证。

希望用户点按钮进入独立页面时，选择 Hosted。宿主后端为当前用户生成短期链接，浏览器立即跳转；不需要在宿主页安装组件。每次进入都重新取得链接，不能把用户的链接作为公共入口分享。

已有自己的聊天界面，或要从非网页应用接入时，选择 API。产品快速开始先带你从服务端跑通一次会话；向终端用户开放时，再按令牌指南隔离每个人的访问权限。

## 准备身份与配置 [#prepare]

登录用户接入需要一个服务智能体、保存的嵌入策略，以及能够验证宿主登录态的后端。API Key 留在后端；浏览器只取得当前终端用户的嵌入令牌。更换界面形态不应改变你为同一个用户分配的稳定标识。

公开问答站不要求登录时，可选 Kit 的匿名访客接入：使用可公开 key，由 Kit 获取匿名令牌。匿名身份不能代替你的账户登录，也不能据此开放订单等账户数据，见[嵌入令牌与用户](/docs/developers/agent/embed/tokens#anonymous)。

嵌入策略和持久化外观目前只能在控制台配置。Kit 的实例外观则由宿主代码设置。先选一种形态跑通真实问答，再增加上下文、工具或主题。

## 下一步 [#next]

* [嵌入到网页](/docs/developers/agent/embed/quickstart)：完成后端签发、挂载与双用户验证。
* [嵌入令牌与用户](/docs/developers/agent/embed/tokens)：选择身份方式并处理刷新与吊销。
* [智能体 API 参考](/docs/api/native/agent)：查会话与事件操作。
* [Cookbook](/docs/cookbook)：查看完整应用场景。