Agent 工具与自定义工具——让 AI 真正能干活的能力配置

工具系统的设计逻辑

Agent 之所以区别于聊天机器人，核心原因是它能调用工具。Taskade 的工具系统分为三层：

内置工具（34 种） → 覆盖通用场景
    ↓
自定义工具 → 扩展特定业务能力
    ↓
Automations 作为工具 → 把复杂流程封装成 Agent 可调用的单元

工具 vs Automations

Automation 是 Workspace DNA 的 Execution 层——它能被事件触发后自动运行。而工具是 Agent 的一个"能力"——Agent 可以主动决定要不要调用。

两者的关系是：你可以把一个复杂的 Automation 封装成工具，让 Agent 按需调用。

内置工具一览

Taskade 为每个 Agent 提供了 34 种内置工具，分以下几类：

信息获取

内容处理

系统操作

Agent 专用

配置 Agent 工具权限

在 Agent 详情页的 Tools 面板里，你可以：

1. 勾选这个 Agent 能用哪些内置工具
2. 设置每个工具的使用频率限制（防止 Agent 滥用）
3. 配置敏感工具的审批（如创建新 Project 需要确认）

权限设计的安全思路

给 Agent 开权限要遵循最小权限原则：

• 客服 Agent 不需要"创建 Project"权限——它只需要读取工单项目和发送通知
• 销售 Agent 不需要"删除数据"权限——它需要读取 CRM 和写入跟进记录
• 研究 Agent 不需要"外部 API 调用"权限——它只需要搜索和抓取

自定义工具（付费版）

当内置工具不够用时，你可以创建自定义工具。Taskade 提供了简单的工具定义界面——你不需要写代码。

自定义工具的两种类型

基于 Automation 的工具：

把一个现有的 Automation 封装成工具。比如你有一个 Automation 能"接收 Lead 信息 → 评分 → 写进 CRM"，你可以把它变成一个工具叫"评分 Lead"，任何 Agent 都可以调用它。

基于 Webhook / REST API 的工具：

如果你有自己的 API 服务，可以配置一个 Webhook 工具：

• Agent 调用时 POST 数据到你的 API
• 你的 API 返回结果（JSON 格式）
• Agent 把结果作为工具输出继续推理

自定义工具定义的字段

名称: "生成合同"
描述: "根据客户信息和报价自动生成合同文档"
输入参数:
  - 客户名称（文本）
  - 报价金额（数字）
  - 服务周期（日期范围）
执行方式: HTTP POST
目标 URL: https://your-api.com/contract/generate

配置好后，Agent 在对话中就可以说"帮我给 ABC 公司生成一份 5 万的季度服务合同"，自动填入参数调用你的 API。

工具使用的实际例子

例子：客服 Agent 的工具组合

运行流程：客户在 Genesis 门户提交工单 → Automations 通知客服 Agent → Agent 用"知识库读取"查相关政策 → 用"Ticket Project 查询"看历史工单 → 生成回复 → 用"Ticket Project 写入"更新状态 → 如果判断为紧急，用"发送通知"升级

例子：研究 Agent 的工具组合

运行流程：你让研究 Agent 调研某个赛道 → Agent 自动规划 → 搜索、抓取、转录 → 用代码执行做数据清洗 → 生成报告 → 保存到指定 Project

工具权限的常见陷阱

给 Agent 过多权限

新手常犯：觉得"给全权限以后再收"，结果 Agent 在后台误删了重要数据或发起了大量不必要的外部请求。建议从最小权限开始，遇到需要再开。

忘记开"调用 Automations"权限

Agent 要能触发 Automations，不仅要给 Agent 工具权限，还要在 Automation 那边配置"允许被 Agent 调用"。两边都要配。

自定义工具的输入输出格式不匹配

Agent 传的参数字段要和你的 API 期望的字段一一对应。建议先用文档测试几次，确认格式无误再上线给 Agent 用。