github / github/copilot-sdk

Feature Request: preserve structured entities in prompts and responses

オープン
#2,685 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る
主要言語
Java
スター
10.5k
フォーク
1.5k
平均マージ
1日 11時間
マージ済み PR(30日)
128

説明

## 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.

コントリビューションガイド

コントリビューションガイドを開く

調査の方向性

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.

索引モデルが issue の本文から書いたものです。

評価

技術スタック
java
領域
api, backend-api-design
issue の種類
機能追加
難易度
5/5
見積もり時間
1週間以上
活発さ
活発
明瞭さ
おおむね明確
初心者へのやさしさ
25/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。