选择接入方式

比较 Kit、iframe、Hosted 与 API，选择适合你的网站或应用的接入路径。

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

比较接入方式

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

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

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

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

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

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

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

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