当 AI Agent 成为你的员工,如何管理这家公司?
前言
想象一下:你开了一家公司,员工全是 AI Agent。CEO 负责制定战略,CTO 负责技术决策,工程师负责写代码,设计师负责做图。它们 24 小时不休息,不需要工资(只需要 API 费用),永远高效。
这就是 Paperclip 的愿景——AI Agent 公司。
本文将介绍如何日常运营这样一家公司。
一、公司组织架构
1.1 推荐的组织架构
`
┌─────────┐
│ CEO │
│ (战略) │
└────┬────┘
│
┌──────────────┼──────────────┐
│ │ │
┌─────┴─────┐ ┌─────┴─────┐ ┌─────┴─────┐
│ CTO │ │ 产品 │ │ 市场 │
│ (技术) │ │ (规划) │ │ (推广) │
└─────┬─────┘ └───────────┘ └───────────┘
│
┌─────┴─────┐
│ 工程师 │
│ (执行) │
└───────────┘
`
1.2 角色定义
| 角色 | 职责 | 推荐 Agent |
|---|
|——|——|———–|
| CEO | 制定战略、分配任务、审核成果 | Hermes Agent |
|---|---|---|
| CTO | 技术决策、代码审核、架构设计 | Claude Code |
| 工程师 | 编写代码、修复 Bug、实现功能 | OpenClaw / Codex |
| 设计师 | 生成图片、设计 UI、制作 PPT | Hermes Agent + ComfyUI |
| 运营 | 内容创作、数据分析、用户运营 | Hermes Agent |
二、日常运营流程
2.1 每日启动流程
`bash
# 1. 检查所有 Agent 状态
npx paperclipai agent list –company-id
# 2. 检查健康状态
curl http://localhost:3100/api/health
# 3. 查看待处理 Issue
npx paperclipai issue list –status backlog,todo,in_progress
# 4. 手动触发 CEO 的 Heartbeat(如果需要)
npx paperclipai agent heartbeat:invoke
`
2.2 任务分配流程
方式一:通过 CLI 创建 Issue
`bash
# 创建一个新任务
npx paperclipai issue create
–company-id
–payload-json ‘{
“title”: “开发用户登录功能”,
“body”: “实现 OAuth2.0 登录,支持 Google 和 GitHub”,
“priority”: “high”,
“assigneeAgentId”: “”
}’
`
方式二:通过 Web UI 创建
- 打开
http://localhost:3100 - 点击 “Issues” → “New Issue”
- 填写标题、描述、优先级
- 分配给对应的 Agent
方式三:让 CEO 自动分配
CEO Agent 在 Heartbeat 时会自动:
- 检查待处理的 Issue
- 根据优先级和 Agent 能力分配任务
- 通知对应的 Agent 开始工作
2.3 任务执行流程
`
Issue 创建 → 分配给 Agent → Agent 执行 → 完成标记 → 审核确认
│ │ │ │ │
▼ ▼ ▼ ▼ ▼
backlog todo in_progress done approved
`
Agent 执行任务时会:
- 读取 Issue 详情
- 使用工具完成任务(写代码、调用 API 等)
- 标记 Issue 为 “done”
- 发布完成评论
三、Agent 管理
3.1 添加新 Agent
`bash
# 添加一个工程师 Agent
npx paperclipai agent create
–company-id
–payload-json ‘{
“name”: “Engineer-Frontend”,
“role”: “engineer”,
“title”: “前端工程师”,
“adapterType”: “hermes_local”,
“adapterConfig”: {
“timeoutSec”: 600,
“persistSession”: true,
“model”: “xiaomi/mimo-v2.5-pro”,
“provider”: “xiaomi”
},
“runtimeConfig”: {
“heartbeat”: {
“enabled”: true,
“intervalSec”: 300,
“cooldownSec”: 10,
“maxConcurrentRuns”: 5
}
}
}’
`
3.2 暂停和恢复 Agent
`bash
# 暂停 Agent(停止接收新任务)
npx paperclipai agent pause –reason “维护中”
# 恢复 Agent
npx paperclipai agent resume
`
3.3 删除 Agent
`bash
# 删除 Agent(谨慎操作)
npx paperclipai agent delete –yes
`
3.4 查看 Agent 工作记录
`bash
# 查看 Agent 的运行历史
npx paperclipai agent task-sessions
# 查看 Agent 的运行时状态
npx paperclipai agent runtime-state
# 查看 Agent 的配置
npx paperclipai agent configuration
`
四、任务管理
4.1 Issue 状态流转
`
backlog → todo → in_progress → in_review → done
│ │ │ │ │
│ │ │ │ └── 完成
│ │ │ └── 审核中
│ │ └── 进行中
│ └── 待处理
└── 待规划
`
4.2 创建 Issue
`bash
# 创建高优先级任务
npx paperclipai issue create
–company-id
–payload-json ‘{
“title”: “修复登录页面 Bug”,
“body”: “用户反馈登录按钮点击无反应,需要排查修复”,
“priority”: “urgent”,
“assigneeAgentId”: “”
}’
# 创建普通任务
npx paperclipai issue create
–company-id
–payload-json ‘{
“title”: “编写 API 文档”,
“body”: “为 REST API 编写 OpenAPI 文档”,
“priority”: “medium”
}’
`
4.3 查看 Issue 列表
`bash
# 查看所有 Issue
npx paperclipai issue list
# 按状态筛选
npx paperclipai issue list –status backlog,todo
# 按 Agent 筛选
npx paperclipai issue list –assignee-agent-id
`
4.4 更新 Issue
`bash
# 标记为完成
npx paperclipai issue update
–payload-json ‘{“status”: “done”}’
# 重新分配
npx paperclipai issue update
–payload-json ‘{“assigneeAgentId”: “”}’
# 修改优先级
npx paperclipai issue update
–payload-json ‘{“priority”: “high”}’
`
五、Heartbeat 调度
5.1 什么是 Heartbeat?
Heartbeat 是 Paperclip 的核心机制。它定期唤醒 Agent,让 Agent:
- 检查是否有新任务
- 继续未完成的工作
- 汇报工作进度
5.2 配置 Heartbeat
`bash
# 启用 Heartbeat,每 5 分钟唤醒一次
npx paperclipai agent update
–payload-json ‘{
“runtimeConfig”: {
“heartbeat”: {
“enabled”: true,
“intervalSec”: 300,
“cooldownSec”: 10,
“wakeOnDemand”: true,
“maxConcurrentRuns”: 5
}
}
}’
`
5.3 手动触发 Heartbeat
`bash
# 立即唤醒 Agent
npx paperclipai agent heartbeat:invoke
`
5.4 Heartbeat 最佳实践
| 场景 | 建议间隔 | 说明 |
|---|
|——|———-|——|
| CEO | 300秒 (5分钟) | 频繁检查任务分配 |
|---|---|---|
| CTO | 600秒 (10分钟) | 定期审核代码 |
| 工程师 | 按需触发 | 有任务时才唤醒 |
| 运营 | 1800秒 (30分钟) | 定期检查数据 |
六、预算控制
6.1 设置月度预算
`bash
# 设置 Agent 的月度预算(单位:分)
# 10000 = $100
npx paperclipai agent update
–payload-json ‘{
“budgetMonthlyCents”: 10000
}’
`
6.2 查看消费情况
`bash
# 查看 Agent 的消费统计
npx paperclipai agent get | grep -E “spent|budget”
# 查看公司的总消费
npx paperclipai company get | grep -E “spent|budget”
`
6.3 预算超限处理
当 Agent 达到预算上限时:
- Agent 会自动停止接收新任务
- 已有的任务会继续完成
- 需要手动增加预算或等待下月重置
`bash
# 增加预算
npx paperclipai agent update
–payload-json ‘{“budgetMonthlyCents”: 20000}’
`
七、监控和日志
7.1 查看 Dashboard
打开浏览器访问 http://localhost:3100,可以看到:
- 所有 Agent 的状态
- 待处理的 Issue
- 最近的活动记录
- 消费统计
7.2 查看活动日志
`bash
# 查看最近活动
npx paperclipai activity list –limit 20
# 查看特定 Agent 的活动
npx paperclipai activity list –agent-id
`
7.3 查看服务器日志
`bash
# 实时查看日志
tail -f ~/.paperclip/instances/default/logs/server.log
# 搜索错误
grep -i “error|fail” ~/.paperclip/instances/default/logs/server.log
`
7.4 健康检查
`bash
# API 健康检查
curl http://localhost:3100/api/health
# 检查所有 Agent 状态
npx paperclipai agent list –company-id
`
八、协同工作模式
8.1 CEO 自动分配任务
CEO Agent 在 Heartbeat 时会自动:
- 检查 backlog 中的 Issue
- 根据 Agent 的能力和负载分配任务
- 更新 Issue 状态为 todo
- 通知对应的 Agent
8.2 CTO 审核代码
CTO Agent 可以配置为:
- 定期检查 in_review 状态的 Issue
- 审核工程师提交的代码
- 提供反馈或批准
- 更新 Issue 状态为 done
8.3 工程师协作
多个工程师 Agent 可以并行工作:
- 每个工程师专注于自己的任务
- 通过 Issue 系统协调工作
- CEO 负责解决冲突
8.4 跨 Agent 通信
Agent 之间通过 Issue 评论进行通信:
`bash
# Agent 在 Issue 上发布评论
curl -X POST “http://localhost:3100/api/issues//comments”
-H “Content-Type: application/json”
-d ‘{“body”: “代码已提交,等待审核”}’
`
九、最佳实践
9.1 任务描述要清晰
❌ 不好的描述:
`
修复 Bug
`
✅ 好的描述:
`
标题:修复用户登录页面的按钮点击无反应问题
描述:
- 问题:用户在登录页面点击”登录”按钮时,没有任何反应
- 预期:点击后应该发送登录请求
- 环境:Chrome 120, Windows 11
- 复现步骤:
- 打开登录页面
- 输入用户名和密码
- 点击”登录”按钮
- 观察:没有任何反应
`
9.2 合理设置优先级
| 优先级 | 说明 | 使用场景 |
|---|
|——–|——|———-|
| urgent | 紧急 | 生产环境故障 |
|---|---|---|
| high | 高 | 重要功能开发 |
| medium | 中 | 常规任务 |
| low | 低 | 优化和改进 |
9.3 定期检查预算
`bash
# 每周检查一次消费情况
npx paperclipai company get | grep -E “spent|budget”
`
9.4 备份重要数据
`bash
# 每天自动备份
npx paperclipai db:backup
# 备份配置文件
cp ~/.paperclip/instances/default/config.json ~/backup/
`
十、常见场景
场景 1:开发一个新功能
`bash
# 1. CEO 创建 Issue
npx paperclipai issue create
–payload-json ‘{
“title”: “开发用户注册功能”,
“body”: “实现邮箱注册,包含验证功能”,
“priority”: “high”
}’
# 2. CEO 分配给工程师
npx paperclipai issue update
–payload-json ‘{“assigneeAgentId”: “”, “status”: “todo”}’
# 3. 工程师 Heartbeat 触发,开始工作
# 4. 工程师完成后标记为 done
# 5. CTO 审核
`
场景 2:修复紧急 Bug
`bash
# 1. 创建紧急 Issue
npx paperclipai issue create
–payload-json ‘{
“title”: “紧急:支付页面崩溃”,
“body”: “用户在支付页面遇到 500 错误”,
“priority”: “urgent”
}’
# 2. 立即触发工程师的 Heartbeat
npx paperclipai agent heartbeat:invoke
`
场景 3:批量处理任务
`bash
# 创建多个相关 Issue
for i in {1..5}; do
npx paperclipai issue create
–payload-json “{
“title”: “API 端点 $i”,
“body”: “实现 API 端点 $i”,
“priority”: “medium”
}”
done
# CEO 会自动分配给空闲的工程师
`
十一、故障排除
11.1 Agent 不响应
`bash
# 1. 检查 Agent 状态
npx paperclipai agent get
# 2. 如果是 error 状态,重置
npx paperclipai agent runtime-state:reset-session
npx paperclipai agent resume
# 3. 手动触发 Heartbeat
npx paperclipai agent heartbeat:invoke
`
11.2 Issue 不被处理
`bash
# 1. 检查 Issue 是否已分配
npx paperclipai issue get
# 2. 检查分配的 Agent 是否在线
npx paperclipai agent get
# 3. 手动触发 Agent 的 Heartbeat
npx paperclipai agent heartbeat:invoke
`
11.3 预算超限
`bash
# 1. 查看消费详情
npx paperclipai agent get | grep spent
# 2. 增加预算或等待下月
npx paperclipai agent update
–payload-json ‘{“budgetMonthlyCents”: 20000}’
`
附录:常用命令速查
Agent 管理
`bash
npx paperclipai agent list # 列出所有 Agent
npx paperclipai agent get # 查看 Agent 详情
npx paperclipai agent create –payload-json # 创建 Agent
npx paperclipai agent update –payload # 更新 Agent
npx paperclipai agent delete –yes # 删除 Agent
npx paperclipai agent resume # 恢复 Agent
npx paperclipai agent pause # 暂停 Agent
npx paperclipai agent heartbeat:invoke # 手动触发 Heartbeat
`
Issue 管理
`bash
npx paperclipai issue list # 列出 Issue
npx paperclipai issue get # 查看 Issue
npx paperclipai issue create –payload-json # 创建 Issue
npx paperclipai issue update –payload # 更新 Issue
`
系统管理
`bash
npx paperclipai run # 启动服务
npx paperclipai health # 健康检查
npx paperclipai db:backup # 手动备份
npx paperclipai configure # 修改配置
`
维护者:攀岩者
最后更新:2026年6月15日
版本:v1.0
发表回复