工具功能
AI Agent 和普通聊天机器人的主要区别，是 Agent 可以使用工具。Tinybot 的工具能让 AI 读取文件、搜索网络、执行命令、操作知识库和调用外部 MCP 服务。
Cowork
cowork 工具用于启动和推进多 Agent 协作会话。它会根据目标动态生成一组角色，每个角色都有自己的上下文、收件箱、任务和讨论线程。适合调研、旅行规划、写作、分析、开发等需要多个视角持续推进的任务。
Cowork 也可以作为独立功能使用，不必进入普通聊天：uv run tinybot cowork start "..."。
Cowork supports multiple canonical architectures on one shared session, task, mailbox, and shared-memory model: adaptive_starter, team, generator_verifier, message_bus, shared_state, and swarm.
常用动作：
start：创建 cowork session，可选auto_run=true立即运行一轮status：查看 agent、任务、讨论线程和事件run：继续运行若干调度轮send_message：用户向某些 agent 补充约束或要求add_task：给指定 agent 追加任务summary：汇总当前成果
工具意味着什么
普通聊天机器人只能根据输入生成文字。Tinybot 可以在任务过程中做动作，例如：
| 用户请求 | Tinybot 可能使用的工具 |
|---|---|
| “总结这个项目” | 读取 README、搜索 docs、整理结果 |
| “检查配置是否正确” | 读取配置文件、分析字段 |
| “帮我生成文档” | 读取资料、写入 Markdown 文件 |
| “搜索最新资料” | 联网搜索、打开网页、汇总来源 |
| “运行测试” | 执行命令、读取测试输出 |
工具越强，越需要你明确工作范围和安全边界。
文件操作
Tinybot 可以读取、搜索、创建和修改文件。适合：
- 总结项目结构
- 修改文档
- 查找配置项
- 生成报告
- 整理文本资料
推荐指令：
请只阅读 docs 目录，找出使用说明中不适合新手的地方。请修改 docs/quickstart.md，让它更适合第一次使用 Tinybot 的用户。如果不想让它改文件，要明确说：
先不要修改文件，只给我建议。命令执行
Tinybot 可以执行终端命令，例如安装依赖、运行测试、查看状态。
示例：
请运行项目测试，并总结失败原因。相关配置：
{
"tools": {
"exec": {
"enable": true,
"timeout": 60
}
}
}如果你不希望 AI 执行命令，可以关闭：
{
"tools": {
"exec": {
"enable": false
}
}
}网络搜索
Tinybot 可以联网搜索，适合查询可能变化的信息，例如新闻、价格、版本、政策、第三方文档。
请搜索这个库的最新版文档，并告诉我升级注意事项。相关配置：
{
"tools": {
"web": {
"enable": true,
"search": {
"provider": "duckduckgo",
"maxResults": 5
}
}
}
}如果网络受限，可以配置代理：
{
"tools": {
"web": {
"proxy": "http://127.0.0.1:7890"
}
}
}浏览器自动化
浏览器自动化用于让 AI 打开网页、点击按钮、输入内容、提取页面信息。它通常需要额外的浏览器桥接工具和扩展。
适合：
- 检查网页界面
- 从页面中提取结构化信息
- 辅助测试本地 WebUI
不熟悉时可以先跳过，不影响基本聊天、文件操作和知识库使用。
MCP 工具
MCP 可以把外部工具服务接入 Tinybot。接入后，这些工具会像内置工具一样被 Agent 调用。
适合开发者或团队场景，例如连接内部系统、数据库、设计工具或代码平台。新手不需要一开始配置 MCP。
安全建议
| 设置 | 建议 |
|---|---|
| 工作区 | 设为一个明确目录，不要直接设为系统根目录 |
restrictToWorkspace |
新手建议开启 |
| 命令执行 | 不需要时可以关闭 |
| API Key | 不要提交到公开仓库 |
| 文件修改 | 让 Tinybot 修改前先说明范围 |
推荐安全配置：
{
"agents": {
"defaults": {
"workspace": "~/.tinybot/workspace"
}
},
"tools": {
"restrictToWorkspace": true,
"exec": {
"enable": true,
"timeout": 60
}
}
}常见问题
Tinybot 说没有权限
可能是工作区限制生效了。检查目标文件是否在 agents.defaults.workspace 内。
命令执行超时
默认超时是 60 秒。可以增加 tools.exec.timeout，也可以让 Tinybot 把大任务拆小。
搜索结果不准确
换更明确的问题，或增加 maxResults。如果是固定资料，建议放入知识库，而不是每次联网搜索。