Skip to main content
工具让智能体在推理之外获得与外部世界交互的能力：网页搜索、代码执行、图像与视频生成、访问第三方服务等。VeADK 把这些能力封装为可直接注册的工具，智能体在运行时根据用户输入与指令自主决定是否调用，框架在调用时自动执行并把结果回填到推理过程。

​
为智能体添加工具

无论何种类型的工具，注册方式一致：把工具放进 Agent 的 tools 列表。
注册后，智能体会依据函数签名 / 工具描述、用户输入与自身指令，决定何时调用工具、如何传参。多个工具可同时注册，智能体在推理过程中按需选择。

​
工具类别

VeADK 的工具按接入方式与用途分为以下几类。
内置工具与内置 MCP 工具多依赖火山引擎相关服务，使用前请开通对应服务并完成 AK/SK、API Key 等鉴权配置；系统工具由框架自动管理，无需手动加入 tools 列表。

​
调用前准备与结果验证

先完成安装与模型配置，再按工具页面开通对应服务并设置凭证。模型 API Key 与工具使用的 AK/SK、服务 API Key 相互独立；仅设置 CLOUD_PROVIDER 不会让所有工具自动切换服务端点 Agent(tools=[...]) 只注册能力，不会执行工具。通过 Runner.run() 发起请求后，在执行事件或工具结果中确认实际调用以及返回状态；模型生成一段回答并不能证明外部操作成功。同步工具直接返回普通值，异步工具需要等待结果，MCP 工具集还需要在应用退出时调用 await toolset.close() 释放连接 首次验证可先使用自定义计算器验证调用流程；连接 MCP 服务时先列出工具，再在所需权限范围内调用具体能力。代码沙箱、手机操作与第三方服务工具可能产生真实的文件或账户变更，应在工具指令中写明允许的操作
最后修改于 2026年9月19日