Borrar el contexto es distinto de crear una nueva sesión: conserva la identidad de la sesión, los mensajes del sistema y del desarrollador, la configuración y el registro de eventos, mientras elimina la conversación visible para el modelo.
Importante
clearContext es un primitivo de controlador de herramientas. El entorno de ejecución rechaza las llamadas realizadas cuando no hay ninguna llamada a herramienta en curso, las llamadas con un prompt inicial vacío y las llamadas en sesiones remotas.
Definición de una herramienta de borrado de contexto
Una herramienta adecuada para borrar el contexto debe ser de línea de comandos. De lo contrario, el bucle del agente puede realizar otra llamada de modelo en la ventana recién desactivada antes de iniciar el turno inicializado.
import { approveAll, CopilotClient, defineTool } from "@github/copilot-sdk";
import type { CopilotSession } from "@github/copilot-sdk";
import { z } from "zod";
const client = new CopilotClient();
let session: CopilotSession;
session = await client.createSession({
onPermissionRequest: approveAll,
tools: [
defineTool("clear_context", {
description: "Clear the conversation and start a fresh context window",
parameters: z.object({ prompt: z.string() }),
isTerminal: true,
defer: "never",
handler: async ({ prompt }) => {
const { messagesCleared } =
await session.rpc.history.clearContext({ prompt });
return `Cleared ${messagesCleared} messages.`;
},
}),
],
});
El elemento requerido prompt se convierte en el primer mensaje del usuario en el nuevo contexto. Un borrado correcto emite session.context_cleared con el número de mensajes eliminados y el mensaje inicial.
Comportamiento de la herramienta de línea de comandos
isTerminal finaliza el turno actual del agente solo cuando la herramienta se ejecuta correctamente. Un error, denegación, rechazo, tiempo de espera o error de validación de entrada permanece visible para el modelo para que pueda recuperarse o volver a intentarlo.
La opción sigue las convenciones de nomenclatura de cada idioma:
| SDK | Opción de herramienta |
|---|---|
| Node.js | isTerminal |
| Python | is_terminal |
| Ir | IsTerminal |
| .NET | Copilot |
| Java | |
Tool o @Copilot | |
| Óxido | with_is_terminal(true) |
Utiliza la terminalidad solo para las herramientas cuya finalización con éxito debe poner fin al turno. Las herramientas normales deben dejarla sin configurar.