5.8 KiB
5.8 KiB
PicoBot 工具说明
send_message — 向指定渠道发送消息
向指定会话发送消息，可附带文件或图片。
参数
| 参数 | 必填 | 说明 |
|---|---|---|
target_chat_id |
是 | 目标会话 ID，格式 <channel>:<chat_id> 或 <channel>:<chat_id>:<dialog_id> |
content |
是 | 消息文本内容 |
files |
否 | 文件路径列表 |
origin |
否 | 消息来源标识，不填则自动使用当前 session_id |
file_types |
否 | 指定文件发送类型，`{"路径": "audio" |
file_types 说明
控制文件以何种消息类型发送，主要用于飞书渠道：
"audio"：作为语音消息发送（仅 opus 格式支持）"file"：作为文件附件发送
飞书渠道限制：上传类型和消息类型必须一致。opus 文件以 "audio" 发送，其他音频（mp3、wav 等）只能以 "file" 发送。
示例
{
"target_chat_id": "feishu:oc_abc123",
"content": "这是生成的音乐文件",
"files": ["/workspace/music.mp3"],
"file_types": {"/workspace/music.mp3": "file"}
}
chat_manager — 会话管理
查看和管理会话及消息。
参数
| 参数 | 必填 | 说明 |
|---|---|---|
action |
是 | 操作: list_sessions, list_channels, list_messages |
session_id |
部分 | list_messages 时必填 |
count |
否 | 返回数量（默认 20，最大 100） |
offset |
否 | 跳过前 N 条，用于翻页 |
before_time |
否 | Unix 时间戳（秒），返回该时间之前的消息 |
after_time |
否 | Unix 时间戳（秒），返回该时间之后的消息 |
cron — 定时任务管理
管理 cron 定时任务。
参数
| 参数 | 必填 | 说明 |
|---|---|---|
action |
是 | 操作: add, list, update, remove, enable, disable |
name |
add必须 | 任务名称 |
schedule |
add需要 | 调度规则: once(时间戳), every(间隔秒), cron(表达式) |
prompt |
add必须 | 任务提示词 |
channel |
add必须 | 执行渠道 |
chat_id |
add必须 | 目标对话 |
memory_store — 存储记忆
写入长期记忆（Knowledge 类别）。
| 参数 | 必填 | 说明 |
|---|---|---|
key |
是 | 记忆唯一键，同 key 覆盖旧值 |
content |
是 | 记忆内容 |
importance |
否 | 重要性 (0.0–1.0) |
memory_recall — 搜索知识记忆
关键词全文搜索 Knowledge 记忆。
| 参数 | 必填 | 说明 |
|---|---|---|
query |
是 | 空格分隔的关键词列表 |
since |
否 | 起始时间戳（unix 毫秒） |
until |
否 | 结束时间戳 |
limit |
否 | 返回数量（默认 10） |
timeline_recall — 搜索时间线
搜索压缩后的历史会话摘要。
| 参数 | 必填 | 说明 |
|---|---|---|
query |
是 | 关键词 |
session_id |
否 | 限定会话 |
since |
否 | 起始时间 |
until |
否 | 结束时间 |
limit |
否 | 返回数量 |
memory_forget — 删除记忆
按 key 删除记忆。
| 参数 | 必填 | 说明 |
|---|---|---|
key |
是 | 要删除的记忆键 |
get_skill — 获取 Skill
查询 skill 内容。
| 参数 | 必填 | 说明 |
|---|---|---|
action |
否 | 操作: get(默认), list |
skill_name |
get时必填 | Skill 名称 |
delegate — 子 Agent 委托
创建子 Agent 处理独立任务。
| 参数 | 必填 | 说明 |
|---|---|---|
action |
是 | run, check_task, cancel_task, list_tasks |
prompt |
run 必填 | 子任务描述 |
mode |
否 | inline, background, parallel，默认 inline |
allowed_tools |
否 | 子 Agent 可用工具列表；默认只读工具集 |
max_iterations |
否 | 最大迭代次数，默认 99 |
timeout_secs |
否 | 超时秒数，默认 3600 |
tasks |
parallel 必填 | 并行子任务数组 |
task_id |
查询/取消必填 | 后台任务 ID |
默认只读工具集：file_read、file_search、content_search、web_fetch、http_request、calculator。
browser — 浏览器自动化
仅在 browser.enabled=true 时注册。底层使用 WebDriver/Chrome。
| action | 说明 |
|---|---|
open |
打开 URL |
snapshot |
获取页面结构快照 |
click, click_at |
点击元素或坐标 |
fill, type, press |
输入文本或按键 |
get_text, get_title, get_url |
读取页面信息 |
screenshot |
截图，可写入文件或返回 base64 |
focus, hover, scroll, wait |
常见交互和等待 |
close |
关闭浏览器会话 |
MCP 工具
如果 config.mcp.servers 配置了 MCP 服务器，Gateway 启动时会连接服务器、发现工具，并把 MCP 工具包装后注册到 ToolRegistry。使用 /mcp 查看当前连接状态和工具列表。
file_read / file_write / file_edit / file_search / content_search — 文件操作和搜索
工作目录内的文件读写编辑、文件名搜索和内容搜索。详细的参数定义见各工具的 parameters_schema。
bash — 执行命令
在本地环境执行 bash 命令，有超时限制和安全检查（阻止 rm -rf /、fork bomb 等）。
http_request / web_fetch — HTTP 和 Web 工具
发送 HTTP 请求和获取网页内容，有 URL 安全校验（阻止内网/本地访问）。
calculator — 计算器
数学表达式计算和统计函数。
| action | 说明 |
|---|---|
evaluate |
计算表达式 |
sum |
求和 |
average |
平均值 |
median |
中位数 |
mode |
众数 |
stdev / variance |
标准差/方差 |
min / max |
最小值/最大值 |
log |
对数 |
factorial |
阶乘 |
round |
四舍五入 |
percentage_change |
变化百分比 |
percentile |
百分位数 |