github / github/copilot-sdk

Feature Request: preserve structured entities in prompts and responses

Abierto
#2,685 0 comentarios 0 reacciones 0 asignados Ver en GitHub
Lenguaje dominante
Java
Estrellas
10.5k
Forks
1.5k
Merge medio
1 d 11 h
PR fusionados (30 d)
128

Descripción

## Problem

Prompts and responses are treated as plain text or Markdown. When a host application passes in a message that contains structured entities — references to users, groups, other agents, or platform-specific objects — those entities are flattened to text. Their identity is lost, so the agent cannot act on them reliably.

The same limitation applies in reverse. The agent cannot emit a structured reference that the host application can render as a real, functional entity. This prevents workflows in which the agent should notify a specific owner, hand off to another agent, or link a platform object when work is blocked or complete.

## What is missing

- Inbound structured entities are not exposed to the session with stable identity metadata.
- There is no supported way for the agent to emit a structured reference in its response.
- There is no capability negotiation, so a host cannot discover which entity types are supported.

## Proposed behavior

- Prompts can carry typed entity annotations — an identifier, a type, and a display name — alongside their text representation.
- The agent receives those entities as structured data rather than only as rendered text.
- Responses can include structured references that the host application renders natively.
- Unsupported entity types produce a clear capability error rather than silent flattening.

## Example scenarios

**Notifying a human owner.** A host application passes a message that references a specific user as the owner of a component. The agent completes an investigation and returns a response that references that same user as a structured entity, so the host can render it as a real reference and notify them.

**Agent-to-agent communication.** A chat channel has several agents installed: the Copilot agent plus one or more custom agents that hold domain knowledge, such as a service-ownership agent or a telemetry agent. Partway through a task, the agent determines it needs information only one of those other agents can answer. It should be able to address that agent as a structured entity in its response, so the host platform delivers the question to it and the reply returns to the same conversation. Today the agent name is flattened to plain text, so the other agent is never invoked and the handoff silently fails.

## Acceptance criteria

- Typed entities survive the round trip from host to session to response.
- Supported entity types are discoverable through capability negotiation.
- Agent-to-agent references are addressable, not merely rendered as text.
- Unsupported types fail explicitly.

Guía de contribución

Abrir la guía de contribución

Línea de trabajo

No files or tests are named. Start by locating the session prompt and response entry points, then trace how entity annotations and capabilities could travel from host to session to response. Done means typed entities survive the round trip, supported types are discoverable, agent references are addressable, and unsupported types fail explicitly.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
java
Área
api, backend-api-design
Tipo de issue
Nueva funcionalidad
Dificultad
5/5
Tiempo estimado
Más de una semana
Estado de actividad
Activo
Claridad
Bastante claro
Aptitud para principiantes
25/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.