工具与调用记录
工具是模型可请求执行的操作契约。Alice 同时管理 Agent Core 本地工具、Java/Bedrock Adapter 动态工具、QQ 工具和扩展工具。
支持状态：已支持
可用工具由 Alice 版本、当前工作区、Adapter 类型和已安装扩展动态决定。请以应用中当前工作区注册的列表为准。
需求
使用工具前确认：
- 对应工作区在线；
- Adapter 已完成工具注册；
- 智能体启用了所需工具；
- 主模型支持 Function Calling；
- 你理解工具的副作用，尤其是方块、背包、战斗、QQ 发送和群管理操作。
架构
每个工具包含注册名、显示名、描述、分类和参数 Schema。创建向导和智能体配置保存的是工具启用映射，不复制一份固定工具目录。
调用链路为：
用户消息
→ 模型返回 tool_calls
→ Alice 校验并调度
→ 本地执行或发送到当前工作区 Adapter
→ 保存结果并回传模型
→ 在聊天中显示调用块聊天中的调用状态包括等待中、执行中、成功和失败。展开调用块可查看参数、结构化结果、错误与耗时。QQ 账号详情还提供消息记录和绑定智能体的 LLM 对话，用于区分 OneBot 消息链路与模型链路。
执行
选择工具
- 创建智能体时进入第 3 步
工具，或打开已有智能体的配置。 - 点击
刷新获取当前注册表。 - 按分类启用最小必要工具，不要仅为方便全部开放高风险操作。
- 保存智能体配置。
验证一次调用
- 打开智能体
信息页。 - 发送一个结果容易验证的只读请求，例如询问当前位置或周围状态。
- 等待工具调用块从
执行中变为成功或失败。 - 展开调用块，核对工具名、输入参数、返回数据和耗时。
- 对写入世界或外部发送类工具，在游戏或 QQ 中再次核对实际副作用。
成功标志：调用块显示成功，返回结果与游戏或外部系统的可观察状态一致。
失败处理
- 列表为空：恢复 Adapter 连接并刷新；
WORLD_OFFLINE：工作区已掉线，先处理实例连接；- 工具不存在：当前 Adapter 或扩展未注册该工具，不要按其他平台的工具名猜测；
- 参数错误：展开调用块核对参数 Schema，并查看工具参考；
- 调用停在执行中：检查 TCP 连接和 Adapter 日志；
- QQ 群管理被拒绝：此类操作要求足够的 QQ 权限，并受 OneBot 平台权限限制。