Skip to content

[dotnet-port] Align agentmode tool names and instructions with .NET - #268

Merged
Quim Muntal (qmuntal) merged 1 commit into
mainfrom
dotnet-port/agentmode-tool-names-alignment-7428d9b884e17844
Jun 11, 2026
Merged

[dotnet-port] Align agentmode tool names and instructions with .NET#268
Quim Muntal (qmuntal) merged 1 commit into
mainfrom
dotnet-port/agentmode-tool-names-alignment-7428d9b884e17844

Conversation

@qmuntal

Copy link
Copy Markdown
Member

Rename AgentMode_Set/AgentMode_Get tools to mode_set/mode_get to match the cross-SDK alignment made in microsoft/agent-framework#6071.

Also update the default instructions and default mode descriptions to match the .NET AgentModeProvider as of that same PR:

  • Add 'check mode after user input' note to instructions.
  • Add 'Mandatory Mode based Workflow' section.
  • Expand plan/execute default mode descriptions with step-by-step processes.
  • Change mode rendering in instructions from bullet points to section headers (#### mode_name) matching .NET BuildInstructions output.

Rename AgentMode_Set/AgentMode_Get tools to mode_set/mode_get to match
the cross-SDK alignment made in microsoft/agent-framework#6071.

Also update the default instructions and default mode descriptions to
match the .NET AgentModeProvider as of that same PR:
- Add 'check mode after user input' note to instructions.
- Add 'Mandatory Mode based Workflow' section.
- Expand plan/execute default mode descriptions with step-by-step processes.
- Change mode rendering in instructions from bullet points to section
  headers (#### mode_name) matching .NET BuildInstructions output.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings June 10, 2026 10:53
@qmuntal
Quim Muntal (qmuntal) requested a review from a team as a code owner June 10, 2026 10:53

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR aligns the Go agent-mode harness with the cross-SDK naming and instruction conventions used by the .NET AgentModeProvider, including tool name normalization (mode_set/mode_get) and updated default instruction/mode-description content.

Changes:

  • Renamed the agent mode tools from AgentMode_Set/AgentMode_Get to mode_set/mode_get.
  • Updated the default agent-mode instruction template and expanded the default plan/execute mode descriptions to match the .NET workflow guidance and formatting.
  • Extended unit tests to validate the new tool names and instruction rendering format.
Show a summary per file
File Description
docs/dotnet-go-sdk-feature-comparison.md Notes the agent-mode alignment status and references the cross-SDK change.
agent/harness/agentmode/agentmode.go Renames mode tools and updates default instructions + mode rendering to section-header format.
agent/harness/agentmode/agentmode_test.go Updates tool-name assertions and adds coverage for instruction content/format.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

  • Files reviewed: 3/3 changed files
  • Comments generated: 1

| OpenTelemetry for agents | Agent/workflow observability samples and OpenTelemetry workflow builder extension. | `agent/opentelemetry`, `workflow/observability/opentelemetry`, workflow builder instrumentation via `WithTelemetry`, trace context propagation in workflow context. | Aligned | API shape differs: Go passes a tracer from the OpenTelemetry adapter separately from `TelemetryOptions` and keeps workflow observability internals unexported. |
| Evaluation | Agent evaluation extensions, eval checks, local/function evaluators, conversation splitters, workflow evaluation samples, Foundry quality samples. | No evaluation package. | .NET only | No Go equivalent found. |
| Harness utilities | Agent mode, file access, file memory, file store, subagents, todo, tool approval harness providers. | `agent/harness/agentmode`, `agent/harness/todo`, `agent/harness/toolapproval`, `agent/harness/toolautocall`. | Partial | Go now has packaged harness support for agent mode, todo tracking, tool approval, and tool auto-call. It still lacks file access, file memory, file store, and subagent harness utilities. |
| Harness utilities | Agent mode, file access, file memory, file store, subagents, todo, tool approval harness providers. | `agent/harness/agentmode`, `agent/harness/todo`, `agent/harness/toolapproval`, `agent/harness/toolautocall`. | Partial | Go now has packaged harness support for agent mode, todo tracking, tool approval, and tool auto-call. It still lacks file access, file memory, file store, and subagent harness utilities. Agent mode tool names (`mode_set`/`mode_get`), default instructions, and mode descriptions are aligned with .NET (#6071). |
@github-actions

Copy link
Copy Markdown
Contributor

Cross-SDK Parity Review

This PR is a clean and correct port of the .NET changes from microsoft/agent-framework#6071. No cross-repo consistency issues were found.

Verified against dotnet/src/Microsoft.Agents.AI/Harness/AgentMode/AgentModeProvider.cs:

Change Go (this PR) .NET upstream Status
Tool names mode_set / mode_get mode_set / mode_get ✅ Aligned
Default instructions Matches template exactly DefaultInstructions constant ✅ Aligned
Instructions format for modes #### mode_name headers AppendLine($"#### {mode.Name}") ✅ Aligned
plan mode description Step-by-step process (7 steps) Identical ✅ Aligned
execute mode description Step-by-step process (5 steps) Identical ✅ Aligned
Mandatory Mode based Workflow section Present Present ✅ Aligned
Mode-check-after-user-input bullet Present Present ✅ Aligned

Python: The Python SDK has no equivalent AgentMode harness feature, so there is no Python parity concern.

The PR description is accurate: tool names, instructions, and mode descriptions are now semantically and textually aligned with the .NET AgentModeProvider.

Generated by Go API Consistency Review Agent for issue #268 · ● 3M ·

@qmuntal
Quim Muntal (qmuntal) merged commit db307f3 into main Jun 11, 2026
17 checks passed
@qmuntal
Quim Muntal (qmuntal) deleted the dotnet-port/agentmode-tool-names-alignment-7428d9b884e17844 branch June 11, 2026 07:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[dotnet-port] Align agentmode tool names and instructions with .NET

3 participants