Repository navigation
zh use agent runner
Agent 执行器是 AstrBot 中用于执行 Agent 的组件。
在 v4.7.0 版本之后，我们将 Dify、Coze、阿里云百炼应用这三个提供商迁移到了 Agent 执行器层面，减少了与 AstrBot 目前功能的一些冲突。请放心，如果您从旧版本升级到 v4.7.0 版本，您无需进行任何操作，AstrBot 会自动为您迁移。此后，AstrBot 也新增了 DeerFlow Agent 执行器支持。
AstrBot 目前支持五种 Agent 执行器：
- AstrBot 内置 Agent 执行器
- Dify Agent 执行器
- Coze Agent 执行器
- 阿里云百炼应用 Agent 执行器
- DeerFlow Agent 执行器
默认情况下，AstrBot 内置 Agent 执行器为默认执行器。
在早期版本中，Dify、Coze、阿里云百炼应用这类「自带 Agent 能力」的平台，是作为普通 Chat Provider 集成进 AstrBot 的。实践下来会发现，它们和传统「只负责补全文本」的 Chat Provider 有本质差异，强行放在同一层会带来很多设计和使用上的冲突。因此，从 v4.7.0 起，我们将它们抽象为独立的 Agent 执行器（Agent Runner）。
从架构上看，可以理解为：
- Chat Provider 负责「说话」；
- Agent 执行器负责「思考 + 做事」。
Agent 执行器会调用 Chat Provider 的接口，并根据 Chat Provider 的回复，进行多轮「感知 → 规划 → 执行动作 → 观察结果 → 再规划」的循环。
Chat Provider 本质上是一个 单轮补全接口，输入 prompt + 历史对话 + 工具列表，输出模型回复（文本、工具调用指令等）。
而 Agent Runner 通常是一个 循环（Loop），接收用户意图、上下文与环境状态，基于策略 / 模型做出规划（Plan），选择并调用工具（Act），从环境中读取结果（Observe），再次理解结果、更新内部状态，决定下一步动作，重复上述过程，直到任务完成或超时。
Dify、Coze、百炼应用、DeerFlow 等平台已经内置了这个循环，如果把它们当成普通 Chat Provider，会和 AstrBot 的内置 Agent 执行器功能冲突。
默认使用 AstrBot 内置 AI，可在「配置文件」→「AI 配置」→「模型」中选择对话模型，并配置人格、知识库和工具能力。
接入第三方应用时，在当前配置文件内直接选择执行方式并填写连接参数：
- 打开 WebUI 左侧「配置文件」，选择要修改的配置文件，进入「AI 配置」。
- 点击 AI 标题右侧的「更多操作」（
…），选择「更换执行方式」。 - 选择 Dify、Coze、阿里云百炼或 DeerFlow，阅读并勾选配置重置提示，然后点击「使用此方式」。
- 确保「启用 AI」已打开，在出现的执行方式设置中填写 API Key、应用 ID、API 地址等参数，具体字段见下方接入指南。
- 点击右下角「保存配置」使更改生效。
Important
切换执行方式会将配置重置为新执行方式的默认值，当前执行方式的配置不会保留。再次切回时需要重新配置；如需保留原配置，请先通过「管理配置文件」复制配置文件。
当前 WebUI 无需在「模型提供商」中新建 Agent 执行器，也无需选择执行器提供商 ID。每个配置文件保存自己的执行方式和连接参数；多个机器人需要连接不同应用时，可分别使用不同配置文件。