v1.0.1 同时支持 ADK 函数工具、ADK Toolset,以及 VeADK 提供的内置工具。V1 的工具 API 以 google.golang.org/adk/tool 为基础。
函数工具
Web 工具
Web Search 会使用火山侧签名凭证或配置中的工具凭证;生产环境通过环境变量或 Secret 注入,不要写入仓库。
MCP Router
V1 的 MCP Router 构造函数是NewMcpRouter(),返回 ADK tool.Toolset:
Run Code Sandbox
NewRunCodeSandboxTool() 创建 run_code 工具,把代码执行交给 AgentKit Code Sandbox:
Skills Toolset
VeADK Gov1.0.1 提供本地 Skills toolset。常用入口包括:
本地执行脚本时要限制工作区、超时、输出和文件访问权限。
使用建议
- 工具名称和描述要稳定,清楚说明输入、输出和副作用。
- 有写入、删除、审批、发送消息或产生费用的工具,应在业务层增加确认和审计。
- 凭证通过环境变量、Secret 或运行时状态传入,不写入 prompt、代码示例或文档仓。
- 长耗时工具应设置超时,并向调用方返回可诊断的错误。