用途：让智能体在生成文本之外执行动作，例如调用 Convex 函数、外部 API 和复杂操作。适用场景包括查询或修改数据库数据、集成外部 API、创建人工介入的工作流、由智能体自主决定动作，以及串联多次工具调用完成多步操作。
主要能力：用 @convex-dev/agent 的 createTool 定义工具，配合 zod 校验参数；用 Agent 的 tools 配置挂载工具，并设置 maxSteps 允许工具调用；在 action 中通过 continueThread 与 generateText 启用自动工具调用，maxSteps 控制最多调用次数。
用法要点：参数校验使用 Zod，字段上的 .describe() 帮助模型理解参数含义；handler 显式标注返回类型；工具调用与结果会自动保存在 thread 历史中；建议在能访问 userId 等上下文的 action 内创建工具。
限制与未提供信息：资料未说明收费、价格、平台支持范围、性能效果或配额；具体依赖版本、完整 API 列表及错误处理方式暂未提供。