# 智能体 (/docs/developers/agent) 让智能体回答产品问题、查询业务数据或完成工具任务。你配置模型、指令与工具，Praxis 管理会话执行和事件记录；你的应用决定谁可以使用、哪些业务操作可以执行。 ## 适用对象与结果 [#use-cases] 给已有产品接入助手时，可以使用现成对话界面，把用户身份和当前页面带入会话。需要完全自定义交互、后台任务或非网页客户端时，使用 API 创建会话并读取事件。业务数据通过你授权的工具取得，订单权限仍由业务服务器核验。 如果只需要一次模型调用，或希望自己编写模型与工具循环，从[模型服务](/docs/developers/model)开始。智能体服务适合希望复用配置、持续对话并追踪任务过程的应用。 ## 对象如何关联 [#objects] | 对象 | 负责什么 | 与其他对象的关系 | | ---- | -------------------- | --------------------------- | | 智能体 | 名称、指令、模型、工具 | 保存配置形成版本；一个智能体可以创建多个会话 | | 会话 | 一段独立对话及其执行状态 | 创建时固定智能体版本，后续配置修改不会替换该快照 | | 环境 | 会话运行所需的机器配置 | API 可省略环境选择使用轻型机器；需要沙箱时选择环境 | | 事件 | 用户消息、智能体回复、工具调用和状态变化 | 属于会话；发送成功表示输入已接收，回复要从事件中读取 | | 终端用户 | 使用你产品的人 | 嵌入令牌把会话访问绑定到该用户和智能体 | 服务智能体面向你的客户，每个会话使用独立环境；个人智能体绑定持久电脑。本文的接入指南围绕服务智能体展开，详细关系见[智能体与会话](/docs/developers/agent/concepts)。公开智能体 ID 形如 `agent_…`，应直接使用创建或查询响应中的值。 ## 选择交付形态 [#delivery] | 形态 | 你负责 | 从哪里开始 | | --------- | ------------------- | ------------------------------------------------ | | API | 服务端鉴权、消息和事件处理、自有界面 | [运行第一个智能体](/docs/developers/agent/quickstart) | | PraxisKit | 在宿主网页挂载组件，接好身份与业务交互 | [嵌入到网页](/docs/developers/agent/embed/quickstart) | | iframe | 提供签发端点并加载托管界面 | [一行嵌入](/docs/developers/agent/embed/iframe) | | Hosted | 验证用户身份，签发短期链接并跳转 | [打开托管对话](/docs/developers/agent/embed/hosted) | React 是使用 Kit 的一种方式。公开资料问答可使用匿名访客接入；需要账户数据时，由宿主后端验证登录身份再签发令牌。完整比较见[选择接入方式](/docs/developers/agent/embed/overview)。 ## 按任务继续 [#tasks] * 修改回答范围、模型和版本：[配置智能体](/docs/developers/agent/configure)。 * 让助手了解当前页面并调用业务能力：[传入上下文](/docs/developers/agent/embed/context)、[配置工具授权](/docs/developers/agent/embed/tool-authorization)。 * 排查客户问题：[查看会话与用量](/docs/developers/agent/monitor)、[管理终端用户](/docs/developers/agent/end-users)。 * 准备上线：[测试嵌入接入](/docs/developers/agent/embed/testing)、[上线检查清单](/docs/developers/agent/embed/go-live)。 下一步：[API 参考](/docs/api/native/agent) · [文档问答配方](/docs/cookbook/scenarios/docs-qa-assistant) · [限制与错误](/docs/developers/agent/limits-and-errors)