Files

renjianbo a7512a5423 docs: update 3 reference docs + add Android design, Feishu bot config, productization plan

- Rewrite api-reference.md: 245 endpoints across 38 modules, correct auth paths and response format
- Rewrite 内置工具列表.md: all 56 real tools in 11 categories
- Fix quickstart.md: local dev ports (3001/8038) vs Docker (8037/8038), --port 8038
- Add android-app-design.md: Kotlin/Compose/MVVM design with SSE, FCM, voice
- Add 飞书智能体配置手册.md: all 6 bots config, capabilities, memory architecture
- Add 产品化落地方案.md: PWA/voice/push/Flutter productization roadmap

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-06-13 21:58:10 +08:00

7.9 KiB

Raw Blame History

内置工具列表

平台提供 56 个内置工具，覆盖 11 个功能类别。工具定义在 backend/app/services/builtin_tools.py，启动时通过 ToolRegistry 自动注册。

可在工作流 LLM 节点中启用工具调用，Agent 会自动选择合适的工具执行任务。

文件操作（2个）

工具	功能	说明
file_read	读取文件	支持 UTF-8 文本、PDF 文字层、DOCX 段落、XLSX 单元格、图片 OCR。路径限制在 LOCAL_FILE_TOOLS_ROOT
file_write	写入文件	UTF-8 文本写入，支持覆盖/追加模式，自动创建父目录

网络请求（5个）

工具	功能	说明
http_request	HTTP 请求	GET/POST/PUT/DELETE，支持自定义 headers 和 body
url_parse	URL 解析	解析 URL 结构、提取查询参数、构建带参数 URL
web_search	网页搜索	Bing（主）/ DuckDuckGo（备用），返回标题、摘要、URL
send_email	邮件发送	SMTP 发送，配置从环境变量读取
browser_use	浏览器控制	无头浏览器：截图、提取内容、点击、填表、执行 JS。需要 playwright

数据处理（7个）

工具	功能	说明
text_analyze	文本分析	统计字数/行数/段落、提取关键词、生成摘要
json_process	JSON 处理	解析(parse)、序列化(stringify)、验证(validate)
math_calculate	数学计算	基本运算 + sqrt/sin/cos/log/pow 等函数，使用安全 eval
regex_test	正则测试	match/findall/replace/split/validate，支持 i/m/s 标志
random_generate	随机生成	密码、随机字符串、整数、浮点数，使用 secrets 模块
crypto_util	加密哈希	UUID 生成、Base64 编解码、MD5/SHA256 哈希
excel_process	Excel 处理	读写数据、添加图表（柱状/折线/饼图）。需要 openpyxl

数据库（1个）

工具	功能	说明
database_query	数据库查询	SELECT 只读查询，支持默认数据库或已配置数据源。不允许 INSERT/UPDATE/DELETE

系统工具（6个）

工具	功能	说明
system_info	系统信息	操作系统、Python 版本、工作区根目录路径
datetime	日期时间	获取当前时间、格式化时间戳
adb_log	ADB 日志	Android logcat、devices 列表、shell 命令，可按 tag/level 过滤
git_operation	Git 操作	只读：log/diff/status/blame/branch/show/tag/remote
docker_manage	Docker 管理	只读：容器/镜像列表、日志、资源使用、详情检查
deploy_push	部署推送	本地文件复制（支持排除规则）或 rsync 远程同步

AI Agent 扩展（13个）

工具	功能	说明
agent_call	调用子 Agent	调用其他已注册 Agent 处理子任务，模糊名称匹配
agent_create	创建子 Agent	动态创建专业化子 Agent，定义名称/system_prompt/模型/温度，持久化到 DB
tool_register	注册工具	动态注册 HTTP 工具，URL 模板支持 {param} 占位符，持久化到 DB
capability_check	能力自检	分析当前工具/子 Agent 能否处理指定任务，返回差距分析
code_tool_create	创建代码工具	将 code_execute 验证过的代码持久化为可复用工具
extension_log	扩展日志	记录和查询自主扩展历史（子 Agent/工具/代码工具），支持 list/log/evaluate
self_review	输出自审	LLM 输出质量自检，评分 >=0.6 通过
task_plan	任务规划	复杂任务分解、进度管理、步骤状态更新
project_scaffold	项目脚手架	按模板生成项目目录：fastapi/vue/react/python_cli/shell
code_execute	代码执行	沙箱执行 Python/JavaScript，返回 stdout/stderr，默认 30s 超时
schedule_create	创建定时任务	为 Agent 创建 cron 定时任务（5 字段表达式）
schedule_list	列出定时任务	列出指定 Agent 的所有定时任务
schedule_delete	删除定时任务	按 schedule_id 或 agent_id 删除

知识图谱（4个）

工具	功能	说明
knowledge_graph_search	图谱搜索	向量语义搜索 + 图邻居扩展混合检索
knowledge_graph_add	添加实体	从文本提取知识实体和关系，持久化到知识图谱
entity_search	实体搜索	关键词搜索实体，按类型过滤（concept/formula/fact/term/task/skill）
learning_path	学习路径	基于知识图谱推荐学习路径，分析前置依赖

多模态（5个）

工具	功能	说明
image_ocr	图片 OCR	文字识别（PNG/JPG/WebP/BMP/TIFF）。需要 Tesseract + chi_sim 中文包
image_vision	视觉理解	多模态模型分析（物体/场景/文字/图表/表情）。需要 OPENAI_API_KEY
speech_to_text	语音转文字	音频转文字（mp3/wav/webm/m4a/ogg），使用 OpenAI Whisper。需要 OPENAI_API_KEY
text_to_speech	文字转语音	文字转 MP3，6 种音色（alloy/echo/fable/onyx/nova/shimmer）。需要 OPENAI_API_KEY
pdf_generate	PDF 生成	Markdown 转 PDF（weasyprint），降级为 HTML

主 Agent 任务管理（4个）

工具	功能	说明
create_task	创建子任务	在目标下创建子任务：标题/描述/优先级/依赖/指派 Agent
assign_task	分配任务	将任务分配给指定 Agent（仅已发布的 Agent 可被分配）
check_progress	查看进度	目标下所有任务进度：状态统计 + 逐任务详情
notify_user	通知用户	站内通知（info/success/warning/error），支持 Markdown

飞书集成（7个）

工具	功能	说明
feishu_create_doc	创建飞书文档	创建飞书在线文档。需要 FEISHU_APP_ID/FEISHU_APP_SECRET
feishu_create_calendar_event	创建飞书日历	创建日历事件（会议/提醒/截止日），ISO 时间格式
feishu_search_contacts	搜索通讯录	按姓名/邮箱/部门搜索飞书通讯录
feishu_send_approval	飞书审批	发送审批卡片消息，审批人可直接同意/拒绝
feishu_read_messages	读取消息	读取飞书历史消息（P2P 私聊或群聊）
feishu_create_sheet	创建飞书表格	创建电子表格，用于报告/任务追踪
feishu_upload_file	上传文件	上传文件到飞书，返回 file_key 用于消息引用

DevOps / 测试（2个）

工具	功能	说明
create_gitea_issue	创建 Issue	在 Gitea 中创建 Issue，用于 bug 跟踪/任务登记
parse_test_result_file	解析测试结果	解析 JSON/XML/CSV 测试结果，提取 pass/fail/skip 统计。支持 JUnit XML、TestNG XML、pytest JSON

工具调用流程

用户输入
  -> LLM 节点（启用工具）
  -> AgentToolManager 过滤可用工具（include/exclude 白名单）
  -> LLM 分析需求，生成 function_call
  -> ToolRegistry.execute_tool() 分发
       -> 内置函数工具
       -> HTTP 工具
       -> 代码工具
       -> 工作流工具
  -> 结果返回 LLM
  -> LLM 生成最终回复

如何启用

工作流编辑器中，选择 LLM 节点
打开工具配置，启用工具调用
从 56 个工具中选择所需工具（可多选）
保存配置

创建 Agent 时通过 include_tools 控制可用工具范围：设为空数组 [] 或不传则默认启用全部 56 个工具。

自定义工具扩展

除 56 个内置工具外，支持通过 API 动态注册：

类型	方式	说明
HTTP 工具	`POST /api/v1/tools`	URL 模板 + 参数占位符
代码工具	`code_tool_create`	已验证的 Python/JS 代码持久化为工具
工作流工具	工作流封装	将已有工作流封装为可调用工具

工具总数: 56 个（内置），支持自定义扩展

7.9 KiB Raw Blame History Unescape Escape