TypeScript
```typescript
// All events
session.on((event) => {
console.log(event.type, event.data);
});
// Specific event type — data is narrowed automatically
session.on("assistant.message_delta", (event) => {
process.stdout.write(event.data.deltaContent);
});
```
Python
```python
from copilot.session_events import SessionEventType
def handle(event):
if event.type == SessionEventType.ASSISTANT_MESSAGE_DELTA:
print(event.data.delta_content, end="", flush=True)
session.on(handle)
```
Go
```golang
session.On(func(event copilot.SessionEvent) {
if d, ok := event.Data.(*copilot.AssistantMessageDeltaData); ok {
fmt.Print(d.DeltaContent)
}
})
```
.NET
```csharp
session.On
(evt =>
{
if (evt is AssistantMessageDeltaEvent delta)
{
Console.Write(delta.Data.DeltaContent);
}
});
```
Java
```java
// All events
session.on(event -> System.out.println(event.getType()));
// Specific event type — data is narrowed to the matching class
session.on(AssistantMessageDeltaEvent.class, event ->
System.out.print(event.getData().deltaContent())
);
```
> \[!TIP]
> **（Python/Go）** 这些 SDK 使用单独的每个事件数据类型（例如`AssistantMessageDeltaData`），因此每个类型上仅存在相关字段。
>
> \[!TIP]
> **（.NET）** .NET SDK 为每个事件使用单独的强类型数据类（例如，`AssistantMessageDeltaData`），因此每个类型上仅存在相关字段。
>
> \[!TIP]
> **(TypeScript)** TypeScript SDK 使用可区分的联合 - 当你根据 `event.type` 匹配时，`data` 有效负载会自动缩小到正确的形状。
## 仅显示父代理响应
子代理事件共享父会话流，并包括信封级别的 `agentId`。 根代理/主代理事件和会话级事件会省略 `agentId`，因此主聊天渲染器可以忽略已设置 `agentId` 的助手事件，并将这些事件转而路由到跟踪界面或进度界面。
TypeScript
```typescript
import type { CopilotSession } from "@github/copilot-sdk";
export function subscribeParentResponse(session: CopilotSession): void {
session.on("assistant.message_delta", (event) => {
if (!event.agentId) {
process.stdout.write(event.data.deltaContent);
}
});
}
```
Python
```python
from copilot import CopilotSession, SessionEvent, SessionEventType
from copilot.session_events import AssistantMessageDeltaData
def subscribe_parent_response(session: CopilotSession) -> None:
def handle(event: SessionEvent) -> None:
if event.type == SessionEventType.ASSISTANT_MESSAGE_DELTA and event.agent_id is None:
data = event.data
if isinstance(data, AssistantMessageDeltaData):
print(data.delta_content, end="", flush=True)
session.on(handle)
```
Go
```golang
package example
import (
"fmt"
copilot "github.com/github/copilot-sdk/go"
)
func subscribeParentResponse(session *copilot.Session) {
session.On(func(event copilot.SessionEvent) {
if event.AgentID != nil {
return
}
if d, ok := event.Data.(*copilot.AssistantMessageDeltaData); ok {
fmt.Print(d.DeltaContent)
}
})
}
```
.NET
```csharp
using System;
using GitHub.Copilot;
static class ParentAgentResponseExample
{
public static void SubscribeParentResponse(CopilotSession session)
{
session.On
(evt =>
{
if (evt.AgentId is null)
{
Console.Write(evt.Data.DeltaContent);
}
});
}
}
```
Java
```java
import com.github.copilot.CopilotSession;
import com.github.copilot.generated.AssistantMessageDeltaEvent;
final class ParentAgentResponseExample {
static void subscribeParentResponse(CopilotSession session) {
session.on(AssistantMessageDeltaEvent.class, event -> {
if (event.getAgentId() == null) {
System.out.print(event.getData().deltaContent());
}
});
}
}
```
Rust
```rust
use github_copilot_sdk::session::Session;
async fn subscribe_parent_response(session: &Session) {
let mut events = session.subscribe();
while let Ok(event) = events.recv().await {
if event.event_type == "assistant.message_delta" && event.agent_id.is_none() {
if let Some(delta) = event.data.get("deltaContent").and_then(|v| v.as_str()) {
print!("{delta}");
}
}
}
}
```
## 助理活动
这些事件会跟踪代理的响应生命周期 - 从轮次开始，经过流式处理块，直到最终消息。
### `assistant.turn_start`
代理开始处理轮次时已发出。
| 数据字段 | 类型 | 必需 | Description |
| ------------------ | -------- | -- | ------------------- |
| `turnId` | `string` | ✅ | 轮次标识符（通常是字符串化的轮次编号） |
| `interactionId` | `string` | | |
| 用于遥测关联的 CAPI 交互 ID | | | |
### `assistant.intent`
短暂。 代理当前正在执行的操作的简短描述，随着其工作的进行而更新。
| 数据字段 | 类型 | 必需 | Description |
| -------- | -------- | -- | ------------------ |
| `intent` | `string` | ✅ | 人类可读的意图（例如“浏览代码库”） |
### `assistant.reasoning`
从模型中得出完整的扩展思维定式。 推理完成后发出。
| 数据字段 | 类型 | 必需 | Description |
| ------------- | -------- | -- | ----------- |
| `reasoningId` | `string` | ✅ | 此推理块的唯一标识符 |
| `content` | `string` | ✅ | 完整的扩展思维文本 |
### `assistant.reasoning_delta`
短暂。 实时流式处理的模型扩展思维增量区块。
| 数据字段 | 类型 | 必需 | Description |
| -------------- | -------- | -- | ------------------------------ |
| `reasoningId` | `string` | ✅ | 匹配相应的 `assistant.reasoning` 事件 |
| `deltaContent` | `string` | ✅ | 要附加到推理内容的文本区块 |
### `assistant.message`
此 LLM 调用的助手完整响应。 可能包括工具调用请求。
| 数据字段 | 类型 | 必需 | Description |
| -------------------------------------- | --------------- | -- | ----------- |
| `messageId` | `string` | ✅ | 此消息的唯一标识符 |
| `content` | `string` | ✅ | 助手的文本响应 |
| `toolRequests` | `ToolRequest[]` | | |
| 助理拟进行的工具调用（请参阅下文） | | | |
| `reasoningOpaque` | `string` | | |
| 加密扩展思维（人类模型）：会话绑定 | | | |
| `reasoningText` | `string` | | |
| 扩展思维中的可读推理文本 | | | |
| `encryptedContent` | `string` | | |
| 加密推理内容（OpenAI 模型）：会话绑定 | | | |
| `phase` | `string` | | |
| 生成阶段（例如， `"thinking"` vs `"response"`） | | | |
| `outputTokens` | `number` | | |
| 来自 API 响应的实际输出令牌计数 | | | |
| `interactionId` | `string` | | |
| 用于遥测的 CAPI 交互 ID | | | |
| `parentToolCallId` | `string` | | |
| Deprecated. 使用信封层级 `agentId` 进行子代理归因 | | | |
\*\*
`ToolRequest` 领域：\*\*
| 领域 | 类型 | 必需 | Description |
| ------------------------- | ------------------------ | -- | -------------------------------------- |
| `toolCallId` | `string` | ✅ | 此工具调用的唯一 ID |
| `name` | `string` | ✅ | 工具名称（例如， `"bash"`、 `"edit"`、 `"grep"`） |
| `arguments` | `object` | | |
| 用于工具的解析参数 | | | |
| `type` | `"function" \| "custom"` | | |
| 调用类型；如果缺失，默认为`"function"` | | | |
### `assistant.message_delta`
短暂。 实时流式处理的助理文本响应的增量区块。
| 数据字段 | 类型 | 必需 | Description |
| ------------------------------------ | -------- | -- | ---------------------------- |
| `messageId` | `string` | ✅ | 匹配相应的 `assistant.message` 事件 |
| `deltaContent` | `string` | ✅ | 要追加到消息的文本片段 |
| `parentToolCallId` | `string` | | |
| Deprecated. 使用信封层级 `agentId` 进行子代理归因 | | | |
### `assistant.turn_end`
代理完成轮次时发出（所有工具执行完成，最终响应已传递）。
| 数据字段 | 类型 | 必需 | Description |
| -------- | -------- | -- | ------------------------------- |
| `turnId` | `string` | ✅ | 匹配相应的 `assistant.turn_start` 事件 |
### `assistant.usage`
短暂。 单个 API 调用的令牌使用情况和成本信息。
| 数据字段 | 类型 | 必需 | Description |
| ---------------------------------------------------------------- | -------------------------------------------------------------------------- | -- | --------------------- |
| `model` | `string` | ✅ | 模型标识符（例如 `"gpt-5.4"`） |
| `inputTokens` | `number` | | |
| 消耗的输入令牌 | | | |
| `outputTokens` | `number` | | |
| 生成的输出令牌 | | | |
| `reasoningTokens` | `number` | | |
| 用于推理/思维链的输出令牌（属于 `outputTokens` 的子集） | | | |
| `cacheReadTokens` | `number` | | |
| 从提示缓存中读取的令牌 | | | |
| `cacheWriteTokens` | `number` | | |
| 写入提示缓存的令牌 | | | |
| `cacheExpiresAt` | `string` | | |
| 此模型调用的提示缓存过期时的 ISO 8601 时间戳 | | | |
| `contentFilterTriggered` | `boolean` | | |
| 响应是被内容筛选阻止还是被截断（`finish_reason === 'content_filter'`） | | | |
| `finishReason` | `string` | | |
| 模型结束原因（例如：`"stop"`、`"length"`、`"tool_calls"`、`"content_filter"`） | | | |
| `cost` | `number` | | |
| 计费的模型乘数成本 | | | |
| `duration` | `number` | | |
| API 调用持续时间（以毫秒为单位） | | | |
| `timeToFirstTokenMs` | `number` | | |
| 从请求发出到收到首个令牌的时间（流式延迟） | | | |
| `interTokenLatencyMs` | `number` | | |
| 连续令牌之间的平均延迟（流式处理吞吐量） | | | |
| `reasoningEffort` | `string` | | |
| 此次调用使用的推理工作量级别（例如：`"low"`、`"medium"`、`"high"`） | | | |
| `initiator` | `string` | | |
| 触发此次调用的原因（例如 `"sub-agent"`）；如果是用户发起的，则为空 | | | |
| `apiCallId` | `string` | | |
| 提供程序的完成 ID（例如 `chatcmpl-abc123`） | | | |
| `serviceRequestId` | `string` | | |
| 用于关联 CAPI 日志的 Copilot 服务请求 ID（`x-copilot-service-request-id`） | | | |
| `apiEndpoint` | `"/chat/completions" \| "/v1/messages" \| "/responses" \| "ws:/responses"` | | |
| 用于模型调用的 API 终结点;对于可观测性和成本归因非常有用。 | | | |
| `ws:/responses` 是响应 API 的 Websocket 变体 | | | |
| `providerCallId` | `string` | | |
| GitHub请求跟踪 ID （`x-github-request-id`） | | | |
| `parentToolCallId` | `string` | | |
| Deprecated. 使用信封层级 `agentId` 进行子代理归因 | | | |
| `quotaSnapshots` | `Record