Files
aiagent/内置工具列表.md
2026-01-23 09:49:45 +08:00

5.1 KiB
Raw Blame History

内置工具列表

平台目前提供 8个内置工具可以在LLM节点中启用工具调用来使用。

📋 工具列表

1. 🌐 http_request - HTTP请求工具

功能: 发送HTTP请求支持GET、POST、PUT、DELETE方法

用途:

  • 调用外部API
  • 获取网页内容
  • 发送数据到服务器

参数:

  • url (必需): 请求的URL地址
  • method (可选): HTTP方法默认GET
  • headers (可选): HTTP请求头
  • body (可选): 请求体POST/PUT时使用

示例:

{
  "url": "https://api.github.com/users/octocat",
  "method": "GET"
}

2. 📖 file_read - 文件读取工具

功能: 读取文件内容

用途:

  • 读取配置文件
  • 读取文档内容
  • 读取数据文件

参数:

  • file_path (必需): 文件路径(只能读取项目目录下的文件)

示例:

{
  "file_path": "backend/app/core/config.py"
}

3. ✍️ file_write - 文件写入工具

功能: 写入文件内容

用途:

  • 保存处理结果
  • 创建配置文件
  • 写入日志文件

参数:

  • file_path (必需): 文件路径(只能写入项目目录下的文件)
  • content (必需): 要写入的内容
  • mode (可选): 写入模式w=覆盖a=追加默认w

示例:

{
  "file_path": "output/result.txt",
  "content": "处理结果",
  "mode": "w"
}

4. 📊 text_analyze - 文本分析工具

功能: 分析文本内容

用途:

  • 统计文本字数、行数等
  • 提取关键词
  • 生成文本摘要

参数:

  • text (必需): 要分析的文本内容
  • operation (可选): 操作类型
    • count: 统计字数、字符数、行数、段落数
    • keywords: 提取关键词(基于词频)
    • summary: 生成摘要取前3句

示例:

{
  "text": "这是一段很长的文本...",
  "operation": "count"
}

5. 🕐 datetime - 日期时间工具

功能: 获取和处理日期时间信息

用途:

  • 获取当前时间
  • 格式化时间
  • 时间戳转换

参数:

  • operation (可选): 操作类型
    • now: 获取当前时间(默认)
    • format: 格式化时间
  • format (可选): 时间格式字符串,默认 "%Y-%m-%d %H:%M:%S"

示例:

{
  "operation": "now",
  "format": "%Y-%m-%d %H:%M:%S"
}

6. 🔢 math_calculate - 数学计算工具

功能: 执行数学计算

用途:

  • 基本数学运算(加减乘除)
  • 数学函数计算sqrt, sin, cos, log等
  • 复杂数学表达式计算

参数:

  • expression (必需): 数学表达式

支持的函数:

  • sqrt(x): 平方根
  • sin(x), cos(x), tan(x): 三角函数
  • log(x): 自然对数
  • exp(x): 指数函数
  • abs(x): 绝对值
  • pow(x, y): 幂运算
  • pi: 圆周率
  • e: 自然常数

示例:

{
  "expression": "sqrt(16) + sin(0) * cos(0)"
}

7. 💻 system_info - 系统信息工具

功能: 获取系统信息

用途:

  • 查看操作系统信息
  • 查看Python版本
  • 查看系统架构

参数: 无

返回信息:

  • 操作系统平台
  • 系统版本
  • 处理器架构
  • Python版本

示例:

{}

8. 📦 json_process - JSON处理工具

功能: 处理JSON数据

用途:

  • 解析JSON字符串
  • 序列化数据为JSON
  • 验证JSON格式

参数:

  • json_string (必需): JSON字符串
  • operation (可选): 操作类型
    • parse: 解析JSON默认
    • stringify: 序列化为JSON
    • validate: 验证JSON格式

示例:

{
  "json_string": "{\"name\": \"test\"}",
  "operation": "parse"
}

🎯 使用场景示例

场景1: 数据获取和处理

用户: "查询GitHub用户信息并保存到文件"
→ LLM调用 http_request 获取数据
→ LLM调用 json_process 解析数据
→ LLM调用 file_write 保存结果

场景2: 文本分析

用户: "分析这段文本的字数和关键词"
→ LLM调用 text_analyze (count) 统计字数
→ LLM调用 text_analyze (keywords) 提取关键词

场景3: 数学计算

用户: "计算 2的10次方 加上 16的平方根"
→ LLM调用 math_calculate("pow(2, 10) + sqrt(16)")

场景4: 文件处理

用户: "读取config.json文件并解析"
→ LLM调用 file_read 读取文件
→ LLM调用 json_process 解析内容

⚠️ 安全限制

  1. 文件操作限制:

    • 只能读写项目目录下的文件
    • 不允许访问系统敏感文件
  2. 数学计算限制:

    • 只允许安全的数学函数
    • 不允许执行任意代码
  3. HTTP请求限制:

    • 超时时间30秒
    • 建议在生产环境中添加域名白名单

📝 如何启用工具

  1. 在工作流编辑器中选择LLM节点
  2. 打开"工具"标签页
  3. 启用"启用工具调用"开关
  4. 选择需要的工具(可多选)
  5. 保存配置

🔄 工具调用流程

用户输入
  ↓
LLM节点启用工具
  ↓
LLM分析需求决定调用哪个工具
  ↓
执行工具
  ↓
工具返回结果
  ↓
LLM基于结果生成最终回复

最后更新: 2026-01-23
工具总数: 8个