AgentX 使用文档
从入门到熟练，5 分钟看完。
快速开始
- 1点击 开始对话，注册账号（邮箱 + 密码）
- 2在输入框直接输入你的需求，比如
“帮我做一个 Q1 销售报表” - 3Agent 会自动选择工具链执行（搜索/写代码/创建文件），实时显示进度
- 4任务完成后，生成的文件在聊天下方有下载按钮
💡 小技巧
拖拽文件到聊天窗口直接上传；输入
/ 看所有快捷命令。工具列表
Agent 会根据你的需求自动选择合适的工具。不需要手动指定。
Web
| web_search | Tavily API 搜索 + 自动读取第一条结果全文 | 2 积分 |
| web_fetch | 抓取指定 URL 的页面内容 | 2 积分 |
代码
| code_execute | 执行 Python 代码（pandas/numpy/matplotlib/requests 可用） | 3 积分 |
| bash_execute | 执行 shell 命令（受限沙箱） | 3 积分 |
编排
| delegate_task | 把任务拆给 1-5 个并行子代理，适合对比调研/批量爬取 | 5 积分/个子任务 |
文件
| file_read | 读取文本文件 | 1 积分 |
| file_write | 写入/覆盖文件 | 2 积分 |
| file_edit | 精确编辑文件（diff 格式） | 2 积分 |
| file_list | 列出目录下所有文件 | 1 积分 |
| file_delete | 删除文件（需确认） | 1 积分 |
| file_move | 移动/重命名文件 | 1 积分 |
| grep_search | 在文件中正则搜索内容 | 2 积分 |
| glob_files | 用 glob 模式查找文件 | 1 积分 |
| find_files | 按名称查找文件 | 1 积分 |
Excel
| read_excel | 读取 Excel 数据为 JSON | 3 积分 |
| write_cells | 写入指定单元格 | 3 积分 |
| write_range | 批量写入矩阵数据（创建 Excel 用这个） | 3 积分 |
| format_cells | 设置颜色/字体/边框 | 2 积分 |
| create_chart | 生成柱状/折线/饼图 | 3 积分 |
| save_as | 另存为其他格式 | 2 积分 |
Skill 命令
以 / 开头的快捷命令，或者用自然语言也能自动匹配。
💡 登录后在侧边栏点击「技能设置」可以开关每个 skill —— 关掉用不到的可以减少 prompt 膨胀、加快响应。关掉的 skill 仍可手动
/name 调用。| /search | 深度搜索（多次搜索+读网页） | /search 黄金价格走势 |
| /code | 写代码并保存到文件 | /code Python 爬豆瓣 Top 250 |
| /excel | 创建或分析 Excel | /excel 创建销售报表 |
| /analyze | 数据分析 + 可视化 | /analyze 用户留存率 |
| /web | 抓取指定网页 | /web https://news.ycombinator.com |
| /translate | 翻译文本或文件 | /translate 把这段翻成英文 |
| /summarize | 总结内容 | /summarize [URL] |
| /debug | 调试代码 bug（只读） | /debug TypeError in server.py |
| /simplify | 代码审查优化 | /simplify |
| /help | 显示所有可用命令 | /help |
并行子代理
复杂任务 Agent 会自动调用 delegate_task 工具，把任务拆成 1-5 个独立子任务并行执行，每个子任务跑在独立沙箱中。
适合的场景
- ✓ 对比调研：同时开 3 个子 agent 调研 GitHub Copilot / Cursor / Claude Code
- ✓ 批量爬取：同时爬 5 个网站的数据
- ✓ 多主题独立研究：每个主题独立深度搜索后汇总
- ✗ 不适合：有顺序依赖的任务（A 完成后才能做 B）
⚡ 最多 3 个 子任务并发执行
⏱ 单个子任务超时 180 秒
🔒 子代理不能再次 delegate（防止无限递归）
📊 结果带结构化摘要：summary + tools_used + duration
💡 小技巧：对于纯对比类需求（例如"对比 A B C 三个方案"），Agent 会自动用 delegate_task 并行；你也可以明确提示"请并行调研"。
历史搜索
对话列表累积多了找不到之前讨论过的方案？现在侧边栏顶部有搜索框。
✓ 全文索引：搜标题 + 所有消息正文
✓ 带上下文片段：结果显示关键词前后 60 字
✓ 匹配次数：每条显示有几处匹配
✓ 实时搜索：输入 0.25 秒后自动触发，无需按回车
长期记忆
Agent 会自动记住你的偏好、常用操作、项目上下文，跨会话保留。
⚙️ 偏好 (preference) — 如 “代码要加详细注释”、“回答尽量简短”
📋 上下文 (context) — 如 “正在做一个电商爬虫项目”
💡 事实 (fact) — 如 “我用的是 macOS”、“喜欢 TypeScript”
📌 指令 (instruction) — 如 “涉及金融数据必须列出来源”
记忆由 AI 自动从对话中提取，也可以通过管理后台手动编辑。
可靠性机制
AgentX 在遇到 LLM 错误、上下文溢出、工具结果过大时会自动恢复，不是简单报错。
🎯 智能错误恢复
| 错误类型 | 自动处理 |
|---|---|
| 401/403 授权失败 | 自动切换到下一个模型供应商 |
| 402 额度不足 | 立即切换并轮换密钥 |
| 429 限流 | 退避 2 秒后切换供应商 |
| 503/529 过载 | 退避 5 秒后切换到下一个模型 |
| 上下文溢出 | 自动压缩历史消息后重试 |
| 网络超时 | 切换模型继续尝试 |
🗂 大结果自动落盘
爬取网页、读取大文件、Shell 输出等工具返回超过 20KB 时，AgentX 自动把完整内容保存到会话沙箱的 .tool_outputs/ 目录，上下文里只留 1500 字预览 + 引用路径。Agent 需要时通过 file_read() 按需读取。
- ✓ 避免单个工具结果挤爆上下文
- ✓ 保留完整内容可查
- ✓ 降低 LLM 调用成本
🔒 技能平台门控
Skill 可以声明 requires_tools 和 platforms，相应工具不可用或平台不匹配时自动跳过，避免调用无效技能。
多平台接入
在 Telegram / 微信等消息平台直接和 AgentX 对话，不限于网页。
Telegram 接入
- 1. 在 Telegram 找
@BotFather创建新 Bot - 2. 获取 Bot Token（格式：
123456:ABC-xyz...） - 3. 进入管理后台 → 多平台 tab，粘贴 Token 连接
- 4. 在 Telegram 给 Bot 发消息就能对话
微信 / 企业微信 / Discord 支持即将上线
本地助手（桌面端）
在你电脑上安装本地助手后，Agent 可以直接读写你本地文件，无需上传到服务器。
- ✓ 文件完全在本地，不上传云端
- ✓ 可访问任意目录（需授权）
- ✓ 后台自动运行，不占资源
- ✓ 聊天依然走云端 AI
第一次访问聊天页面时会自动提示是否安装。支持 macOS 和 Windows。
计费规则
| 类型 | 积分 | 示例 |
|---|---|---|
| 普通对话 | 1 | 问答、聊天 |
| 搜索/爬网页 | 2 | web_search, web_fetch |
| 代码/Excel | 3 | code_execute, write_range |
| 复杂任务 | 5+ | 5+ 工具调用 |
会员充值享 7 折优惠 · 免费用户每天 20 次不计积分 · 查看完整定价
FAQ
免费用户能用哪些工具？▾
所有 20+ 工具都能用，只是每天限 20 次对话。
对话历史会保留多久？▾
免费用户 30 天，会员永久保留。
能上传多大的文件？▾
免费 10 MB，会员 50 MB。
支持哪些文件格式？▾
Excel (.xlsx/.xls)、CSV、PDF、TXT、Markdown、JSON、Python 等。
代码执行安全吗？▾
所有代码在独立的 session 沙箱执行，24 小时后自动清理。不能访问服务器系统。
会把我的数据上传吗？▾
文件操作在 session sandbox 内进行，不分享给其他用户。安装本地助手后文件完全留在你电脑上。
能取消正在执行的任务吗？▾
可以。输入框旁边有停止按钮。
忘记密码怎么办？▾
邮件联系 [email protected]。