智能体

配置职责和工具，用会话运行任务，再通过 API 或网页服务你的用户。

让智能体回答产品问题、查询业务数据或完成工具任务。你配置模型、指令与工具，Praxis 管理会话执行和事件记录；你的应用决定谁可以使用、哪些业务操作可以执行。

适用对象与结果

给已有产品接入助手时，可以使用现成对话界面，把用户身份和当前页面带入会话。需要完全自定义交互、后台任务或非网页客户端时，使用 API 创建会话并读取事件。业务数据通过你授权的工具取得，订单权限仍由业务服务器核验。

如果只需要一次模型调用，或希望自己编写模型与工具循环，从模型服务开始。智能体服务适合希望复用配置、持续对话并追踪任务过程的应用。

对象	负责什么	与其他对象的关系
智能体	名称、指令、模型、工具	保存配置形成版本；一个智能体可以创建多个会话
会话	一段独立对话及其执行状态	创建时固定智能体版本，后续配置修改不会替换该快照
环境	会话运行所需的机器配置	API 可省略环境选择使用轻型机器；需要沙箱时选择环境
事件	用户消息、智能体回复、工具调用和状态变化	属于会话；发送成功表示输入已接收，回复要从事件中读取
终端用户	使用你产品的人	嵌入令牌把会话访问绑定到该用户和智能体

服务智能体面向你的客户，每个会话使用独立环境；个人智能体绑定持久电脑。本文的接入指南围绕服务智能体展开，详细关系见智能体与会话。公开智能体 ID 形如 agent_…，应直接使用创建或查询响应中的值。

React 是使用 Kit 的一种方式。公开资料问答可使用匿名访客接入；需要账户数据时，由宿主后端验证登录身份再签发令牌。完整比较见选择接入方式。