TypeScript
```typescript
const result = await session.rpc.fleet.start({
prompt: "Refactor each SDK package independently, then summarize the changes.",
});
if (result.started) {
console.log("Fleet mode started");
}
```
Python
```python
from copilot.rpc import FleetStartRequest
result = await session.rpc.fleet.start(
FleetStartRequest(
prompt="Review each service independently, then summarize the risks."
)
)
if result.started:
print("Fleet mode started")
```
Go
```golang
prompt := "Update each package independently, then report validation results."
result, err := session.RPC.Fleet.Start(ctx, &rpc.FleetStartRequest{
Prompt: &prompt,
})
if err != nil {
return err
}
if result.Started {
fmt.Println("Fleet mode started")
}
```
.NET
```csharp
var result = await session.Rpc.Fleet.StartAsync(
"Audit each project independently, then summarize the findings.");
if (result.Started)
{
Console.WriteLine("Fleet mode started");
}
```
Rust
```rust
use github_copilot_sdk::rpc::FleetStartRequest;
let result = session
.rpc()
.fleet()
.start(FleetStartRequest {
prompt: Some("Research each crate independently, then summarize the plan.".into()),
})
.await?;
if result.started {
println!("Fleet mode started");
}
```
机群模式的原生类型绑定已在 Node.js/TypeScript、Python、Go、.NET 和 Rust 中得到验证。 此分支上的 `java/src/main/java` 中找不到Java绑定，因此在该图面可用之前，将省略Java示例。
### 从计划模式
计划模式界面可以通过返回 `autopilot_fleet` 退出操作来启动集群部署。 生成的会话事件类型将其描述为：
```typescript
type ExitPlanModeAction =
| "exit_only"
| "interactive"
| "autopilot"
/** Exit plan mode and continue with parallel autonomous workers. */
| "autopilot_fleet";
```
当用户批准已包含独立工作项的计划时，请使用此功能。 对于单个自主工作单元，使用 `autopilot`；当需要用户参与其中时，使用 `interactive`。
## 子代理如何协调
机群模式依赖于显式协调状态，而不是隐式共享内存。 父智能体将工作分解为待办事项，每个子智能体负责一个待办事项，编排器会调度那些依赖关系已满足的辅助角色。
规范架构为：
```sql
CREATE TABLE todos (
id TEXT PRIMARY KEY,
title TEXT NOT NULL,
description TEXT,
status TEXT DEFAULT 'pending'
);
CREATE TABLE todo_deps (
todo_id TEXT,
depends_on TEXT,
PRIMARY KEY (todo_id, depends_on)
);
```
每个待办事项都会经历一个小型状态机：
```text
pending -> in_progress -> done
\-> blocked
```
子代理应：
1. 通过设置 `status = 'in_progress'` 来申领且仅一个已就绪的待办事项。
2. 仅在该待办事项的范围内进行工作。
3. 将其结果存储在对话或相关任务输出中。
4. 完成后设置 `status = 'done'` 。
5. 在无法继续时设置 `status = 'blocked'` ，并包括原因。
调度器可通过如下查询查找依赖关系已满足的工作：
```sql
SELECT t.*
FROM todos t
WHERE t.status = 'pending'
AND NOT EXISTS (
SELECT 1
FROM todo_deps td
JOIN todos dep ON td.depends_on = dep.id
WHERE td.todo_id = t.id
AND dep.status != 'done'
);
```
这种模式为每个工作单元明确指定了负责人，并使父会话能够判断哪些处于就绪、运行中、已完成或被阻塞状态。
## 生命周期挂钩
机群模式通过运行时的任务机制调用子代理。 运行时会为子智能体工具调用触发钩子活动：运行时 1.0.52 的变更日志指出，`preToolUse`、`postToolUse`、`subagentStart` 和 `subagentStop` 在子智能体工具调用时能正确触发。
在此分支的公开 SDK 接口中，未发现针对 `subagentStart` 或 `subagentStop` 的专用 SDK 钩子回调。 SDK 用户可以通过通用会话事件流观察子代理活动，其中包括诸如 `subagent.started`、`subagent.completed`、`subagent.failed`、`subagent.selected` 和 `subagent.deselected` 等事件。