mirror of
https://github.com/shareAI-lab/analysis_claude_code.git
synced 2026-03-22 02:15:42 +08:00
143 lines
4.7 KiB
Markdown
143 lines
4.7 KiB
Markdown
# s11: Autonomous Agents (自治智能体)
|
|
|
|
`s01 > s02 > s03 > s04 > s05 > s06 | s07 > s08 > s09 > s10 > [ s11 ] s12`
|
|
|
|
> *"Poll, claim, work, repeat"* -- 不需要协调者, 智能体自己找活干。
|
|
|
|
## 问题
|
|
|
|
s09-s10 中, 队友只在被明确指派时才动。领导得给每个队友写 prompt, 任务看板上 10 个未认领的任务得手动分配。这扩展不了。
|
|
|
|
真正的自治: 队友自己扫描任务看板, 认领没人做的任务, 做完再找下一个。
|
|
|
|
一个细节: 上下文压缩 (s06) 后智能体可能忘了自己是谁。身份重注入解决这个问题。
|
|
|
|
## 解决方案
|
|
|
|
```
|
|
Teammate lifecycle with idle cycle:
|
|
|
|
+-------+
|
|
| spawn |
|
|
+---+---+
|
|
|
|
|
v
|
|
+-------+ tool_use +-------+
|
|
| WORK | <------------- | LLM |
|
|
+---+---+ +-------+
|
|
|
|
|
| stop_reason != tool_use (or idle tool called)
|
|
v
|
|
+--------+
|
|
| IDLE | poll every 5s for up to 60s
|
|
+---+----+
|
|
|
|
|
+---> check inbox --> message? ----------> WORK
|
|
|
|
|
+---> scan .tasks/ --> unclaimed? -------> claim -> WORK
|
|
|
|
|
+---> 60s timeout ----------------------> SHUTDOWN
|
|
|
|
Identity re-injection after compression:
|
|
if len(messages) <= 3:
|
|
messages.insert(0, identity_block)
|
|
```
|
|
|
|
## 工作原理
|
|
|
|
1. 队友循环分两个阶段: WORK 和 IDLE。LLM 停止调用工具 (或调用了 `idle`) 时, 进入 IDLE。
|
|
|
|
```python
|
|
def _loop(self, name, role, prompt):
|
|
while True:
|
|
# -- WORK PHASE --
|
|
messages = [{"role": "user", "content": prompt}]
|
|
for _ in range(50):
|
|
response = client.messages.create(...)
|
|
if response.stop_reason != "tool_use":
|
|
break
|
|
# execute tools...
|
|
if idle_requested:
|
|
break
|
|
|
|
# -- IDLE PHASE --
|
|
self._set_status(name, "idle")
|
|
resume = self._idle_poll(name, messages)
|
|
if not resume:
|
|
self._set_status(name, "shutdown")
|
|
return
|
|
self._set_status(name, "working")
|
|
```
|
|
|
|
2. 空闲阶段循环轮询收件箱和任务看板。
|
|
|
|
```python
|
|
def _idle_poll(self, name, messages):
|
|
for _ in range(IDLE_TIMEOUT // POLL_INTERVAL): # 60s / 5s = 12
|
|
time.sleep(POLL_INTERVAL)
|
|
inbox = BUS.read_inbox(name)
|
|
if inbox:
|
|
messages.append({"role": "user",
|
|
"content": f"<inbox>{inbox}</inbox>"})
|
|
return True
|
|
unclaimed = scan_unclaimed_tasks()
|
|
if unclaimed:
|
|
claim_task(unclaimed[0]["id"], name)
|
|
messages.append({"role": "user",
|
|
"content": f"<auto-claimed>Task #{unclaimed[0]['id']}: "
|
|
f"{unclaimed[0]['subject']}</auto-claimed>"})
|
|
return True
|
|
return False # timeout -> shutdown
|
|
```
|
|
|
|
3. 任务看板扫描: 找 pending 状态、无 owner、未被阻塞的任务。
|
|
|
|
```python
|
|
def scan_unclaimed_tasks() -> list:
|
|
unclaimed = []
|
|
for f in sorted(TASKS_DIR.glob("task_*.json")):
|
|
task = json.loads(f.read_text())
|
|
if (task.get("status") == "pending"
|
|
and not task.get("owner")
|
|
and not task.get("blockedBy")):
|
|
unclaimed.append(task)
|
|
return unclaimed
|
|
```
|
|
|
|
4. 身份重注入: 上下文过短 (说明发生了压缩) 时, 在开头插入身份块。
|
|
|
|
```python
|
|
if len(messages) <= 3:
|
|
messages.insert(0, {"role": "user",
|
|
"content": f"<identity>You are '{name}', role: {role}, "
|
|
f"team: {team_name}. Continue your work.</identity>"})
|
|
messages.insert(1, {"role": "assistant",
|
|
"content": f"I am {name}. Continuing."})
|
|
```
|
|
|
|
## 相对 s10 的变更
|
|
|
|
| 组件 | 之前 (s10) | 之后 (s11) |
|
|
|----------------|------------------|----------------------------------|
|
|
| Tools | 12 | 14 (+idle, +claim_task) |
|
|
| 自治性 | 领导指派 | 自组织 |
|
|
| 空闲阶段 | 无 | 轮询收件箱 + 任务看板 |
|
|
| 任务认领 | 仅手动 | 自动认领未分配任务 |
|
|
| 身份 | 系统提示 | + 压缩后重注入 |
|
|
| 超时 | 无 | 60 秒空闲 -> 自动关机 |
|
|
|
|
## 试一试
|
|
|
|
```sh
|
|
cd learn-claude-code
|
|
python agents/s11_autonomous_agents.py
|
|
```
|
|
|
|
试试这些 prompt (英文 prompt 对 LLM 效果更好, 也可以用中文):
|
|
|
|
1. `Create 3 tasks on the board, then spawn alice and bob. Watch them auto-claim.`
|
|
2. `Spawn a coder teammate and let it find work from the task board itself`
|
|
3. `Create tasks with dependencies. Watch teammates respect the blocked order.`
|
|
4. 输入 `/tasks` 查看带 owner 的任务看板
|
|
5. 输入 `/team` 监控谁在工作、谁在空闲
|