github / github/copilot-sdk

[Feature Request] Allow subagents to override reasoning effort in CustomAgentConfig (parity with Claude Agent SDK)

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

説明

## Summary

Allow custom subagents defined via `CustomAgentConfig` to specify their own reasoning effort independent of the orchestrator session's reasoning. The Claude Agent SDK supports this via an `effort` field on `AgentDefinition`. copilot-sdk's `CustomAgentConfig` does not, so reasoning is fixed at session level and applies uniformly to every subagent invocation.

## Motivation

- Orchestrators often benefit from `high` or `max` reasoning for planning and delegation
- Many subagent tasks are mechanical execution (validation, extraction, format conversion) and do not benefit from deep reasoning, but today pay its latency and cost
- Conversely, security focused or analysis focused subagents may want stronger reasoning than the orchestrator
- Without per subagent control, the tallest reasoning setting propagates to every dispatch

## Current state

- `CustomAgentConfig` (copilot-sdk `types.d.ts`, lines 802 to 833) has no `reasoningEffort` or `effort` field
- Session level `reasoningEffort` in `providerOptions` applies to all subagent dispatches in that session

## Proposed

1. Add optional `reasoningEffort` (or `effort`) field to `CustomAgentConfig`
2. Accept existing values: `low | medium | high | xhigh | max`, plus numeric for models that support it
3. Fall back to session reasoning when omitted
4. Mirror the field in the YAML frontmatter loader (coordinated with github/copilot-cli#2904)

## Precedent

Claude Agent SDK's `AgentDefinition.effort`:
https://code.claude.com/docs/en/agent-sdk/subagents

Identical value vocabulary already in use by this SDK.

## Related

- github/copilot-cli#2904 — Custom Agent YAML Frontmatter Should Support Reasoning Effort (CLI surface for the same feature)
- #1019 — Per agent tool visibility for custom sub agents (same architectural axis)

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

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

調査の方向性

Start with CustomAgentConfig in types.d.ts around lines 802–833, then trace how session-level reasoningEffort in providerOptions reaches custom subagent dispatches. Read the YAML frontmatter loader and related github/copilot-cli#2904 context. Done means the config and YAML surfaces accept the documented effort values and omitted values retain the session setting.

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

評価

技術スタック
typescript, yaml
領域
developer-experience, tooling
issue の種類
機能追加
難易度
4/5
見積もり時間
3〜5日
活発さ
静か
明瞭さ
おおむね明確
初心者へのやさしさ
64/100

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

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