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)** Estos SDK usan tipos de datos independientes por evento (por ejemplo, `AssistantMessageDeltaData`), por lo que solo existen los campos pertinentes en cada tipo.
>
> \[!TIP]
> **(.NET)** El SDK de .NET usa clases de datos independientes y fuertemente tipadas por evento (por ejemplo, `AssistantMessageDeltaData`), por lo que solo existen los campos pertinentes en cada tipo.
>
> \[!TIP]
> **(TypeScript)** El SDK de TypeScript utiliza una unión discriminada: cuando se realiza una coincidencia con `event.type`, la carga `data` se restringe automáticamente a la forma correcta.
## Representar solo la respuesta del agente primario
Los eventos de los subagentes comparten el flujo de la sesión principal e incluyen `agentId` en el nivel de sobre. Los eventos del agente raíz/principal y los eventos en el nivel de sesión omiten `agentId`, por lo que los renderizadores del chat principal pueden ignorar los eventos del asistente en los que se ha establecido `agentId` y, en su lugar, redirigir dichos eventos a trazas o a la interfaz de usuario de progreso.
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}");
}
}
}
}
```
## Eventos del asistente
Estos eventos realizan un seguimiento del ciclo de vida de respuesta del agente, desde el inicio del turno mediante fragmentos transmitidos en streaming hasta el mensaje final.
### `assistant.turn_start`
Se genera cuando el agente inicia a procesar un turno.
| Campo de datos | Tipo | Obligatorio | Description |
| ------------------------------------------------------------ | -------- | ----------- | ------------------------------------------------------------------ |
| `turnId` | `string` | ✅ | Identificador de turno (normalmente un número de turno con cadena) |
| `interactionId` | `string` | | |
| Id. de interacción de CAPI para la correlación de telemetría | | | |
### `assistant.intent`
Efímero. Descripción breve de lo que el agente está haciendo actualmente, actualizado a medida que funciona.
| Campo de datos | Tipo | Obligatorio | Description |
| -------------- | -------- | ----------- | ---------------------------------------------------------------------------- |
| `intent` | `string` | ✅ | Intención comprensible para humanos (p. ej., "Explorando la base de código") |
### `assistant.reasoning`
Bloque completo de razonamiento ampliado del modelo. Emitido después de finalizar el razonamiento.
| Campo de datos | Tipo | Obligatorio | Description |
| -------------- | -------- | ----------- | -------------------------------------------------- |
| `reasoningId` | `string` | ✅ | Identificador único de este bloque de razonamiento |
| `content` | `string` | ✅ | Texto completo de pensamiento avanzado |
### `assistant.reasoning_delta`
Efímero. Fragmento incremental del razonamiento ampliado del modelo, transmitido en tiempo real.
| Campo de datos | Tipo | Obligatorio | Description |
| -------------- | -------- | ----------- | ------------------------------------------------------------------ |
| `reasoningId` | `string` | ✅ | Coincide con el evento correspondiente `assistant.reasoning` . |
| `deltaContent` | `string` | ✅ | Fragmento de texto que se va a anexar al contenido de razonamiento |
### `assistant.message`
Respuesta completa del asistente para esta llamada al LLM. Puede incluir solicitudes de invocación de herramientas.
| Campo de datos | Tipo | Obligatorio | Description |
| ------------------------------------------------------------------------------------ | --------------- | ----------- | ----------------------------------- |
| `messageId` | `string` | ✅ | Identificador único de este mensaje |
| `content` | `string` | ✅ | Respuesta de texto del asistente |
| `toolRequests` | `ToolRequest[]` | | |
| Llamadas a herramientas que el asistente desea realizar (ver abajo) | | | |
| `reasoningOpaque` | `string` | | |
| Pensamiento extendido cifrado (modelos antrópicos); vinculado a sesión | | | |
| `reasoningText` | `string` | | |
| Texto de razonamiento legible a partir del pensamiento ampliado | | | |
| `encryptedContent` | `string` | | |
| Contenido de razonamiento cifrado (modelos de OpenAI); vinculado a la sesión | | | |
| `phase` | `string` | | |
| Fase de generación (por ejemplo, `"thinking"` frente a `"response"`) | | | |
| `outputTokens` | `number` | | |
| Recuento real de tokens de salida de la respuesta de la API | | | |
| `interactionId` | `string` | | |
| ID de interacción de CAPI para telemetría | | | |
| `parentToolCallId` | `string` | | |
| Deprecated. Utilizar `agentId` en el nivel de sobre para la atribución de subagentes | | | |
\*\*
`ToolRequest` campos:\*\*
| Campo | Tipo | Obligatorio | Description |
| ----------------------------------------------------------------------------- | ------------------------ | ----------- | -------------------------------------------------------------------- |
| `toolCallId` | `string` | ✅ | Identificador único para esta llamada de herramienta |
| `name` | `string` | ✅ | Nombre de la herramienta (por ejemplo, `"bash"`, `"edit"`, `"grep"`) |
| `arguments` | `object` | | |
| Argumentos analizados para la herramienta | | | |
| `type` | `"function" \| "custom"` | | |
| Tipo de llamada; el valor predeterminado es `"function"` cuando está ausente. | | | |
### `assistant.message_delta`
Efímero. Fragmento incremental de la respuesta de texto del asistente, transmitido en tiempo real.
| Campo de datos | Tipo | Obligatorio | Description |
| ------------------------------------------------------------------------------------ | -------- | ----------- | ------------------------------------------------------------ |
| `messageId` | `string` | ✅ | Coincide con el evento correspondiente `assistant.message` . |
| `deltaContent` | `string` | ✅ | Fragmento de texto que se va a anexar al mensaje |
| `parentToolCallId` | `string` | | |
| Deprecated. Utilizar `agentId` en el nivel de sobre para la atribución de subagentes | | | |
### `assistant.turn_end`
Se genera cuando el agente finaliza un turno (todas las ejecuciones de herramientas se completan y se entrega la respuesta final).
| Campo de datos | Tipo | Obligatorio | Description |
| -------------- | -------- | ----------- | --------------------------------------------------------------- |
| `turnId` | `string` | ✅ | Coincide con el evento correspondiente `assistant.turn_start` . |
### `assistant.usage`
Efímero. Información de costos y uso de tokens para una llamada API individual.
| Campo de datos | Tipo | Obligatorio | Description |
| --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | ----------- | --------------------------------------------------- |
| `model` | `string` | ✅ | Identificador del modelo (por ejemplo, `"gpt-5.4"`) |
| `inputTokens` | `number` | | |
| Tokens de entrada consumidos | | | |
| `outputTokens` | `number` | | |
| Tokens de salida generados | | | |
| `reasoningTokens` | `number` | | |
| Tokens de salida usados para el razonamiento o la cadena de pensamiento (subconjunto de `outputTokens`) | | | |
| `cacheReadTokens` | `number` | | |
| Tokens leídos de la caché de solicitud | | | |
| `cacheWriteTokens` | `number` | | |
| Tokens escritos para solicitar caché | | | |
| `cacheExpiresAt` | `string` | | |
| Marca de tiempo ISO 8601 cuando caduca la caché de indicaciones para esta llamada al modelo | | | |
| `contentFilterTriggered` | `boolean` | | |
| Indica si la respuesta se ha bloqueado o truncado mediante el filtrado de contenido (`finish_reason === 'content_filter'`) | | | |
| `finishReason` | `string` | | |
| Motivo de finalización del modelo (por ejemplo, `"stop"`, `"length"`, `"tool_calls"`, `"content_filter"`) | | | |
| `cost` | `number` | | |
| Coste del multiplicador de modelos para la facturación | | | |
| `duration` | `number` | | |
| Duración de la llamada API en milisegundos | | | |
| `timeToFirstTokenMs` | `number` | | |
| Tiempo desde el envío de solicitudes hasta el primer token recibido (latencia de streaming) | | | |
| `interTokenLatencyMs` | `number` | | |
| Latencia media entre tokens consecutivos (rendimiento de streaming) | | | |
| `reasoningEffort` | `string` | | |
| Nivel de esfuerzo de razonamiento usado para esta llamada (por ejemplo, `"low"`, `"medium"`, `"high"`) | | | |
| `initiator` | `string` | | |
| Lo que desencadenó esta llamada (por ejemplo, `"sub-agent"`); ausente para el iniciado por el usuario | | | |
| `apiCallId` | `string` | | |
| Identificador de finalización del proveedor (por ejemplo, `chatcmpl-abc123`) | | | |
| `serviceRequestId` | `string` | | |
| Identificador de solicitud de servicio de Copilot (`x-copilot-service-request-id`) para la correlación del registro de CAPI | | | |
| `apiEndpoint` | `"/chat/completions" \| "/v1/messages" \| "/responses" \| "ws:/responses"` | | |
| Punto de conexión de API usado para la llamada de modelo; útil para la observabilidad y la atribución de costos. | | | |
| `ws:/responses` es la variante websocket de la API de respuestas. | | | |
| `providerCallId` | `string` | | |
| ID de trazado de solicitudes de GitHub (`x-github-request-id`) | | | |
| `parentToolCallId` | `string` | | |
| Deprecated. Utilizar `agentId` en el nivel de sobre para la atribución de subagentes | | | |
| `quotaSnapshots` | `Record