Skip to content

.NET: Azure AI Projects agent-mode silently ignores per-request tools (AG-UI/ChatOptions.Tools) #2959

@MaciejSzczepanskiRedslim

Description

Summary

When using [AIProjectClient.CreateAIAgentAsync(...)]. During runs, tools provided per request (e.g., via AG-UI frontend tool definitions) are silently dropped and never reach the model/service request. This makes AG-UI “frontend tools” unusable with Azure AI Projects agents unless they were baked into the server-side agent definition at creation/version time.

Why this matters

AG-UI expects to be able to provide tool definitions per request (especially client-side / frontend tools).
Today this fails silently: the agent runs, but never calls/uses the provided tools because the model never sees them.
The silent ignore is hard to diagnose and looks like “tools don’t work”.

The per-request tools never show up in the model request context, so the agent never calls them.
No error/warning is produced.
Expected behavior (pick one)
Option A (strict): If per-request tools are supplied in agent-mode, explaining they are not supported and that tools must be added to the server-side agent definition/version.
Option B (support): Allow per-request tool augmentation (union) so AG-UI frontend tools work with agent-mode.

Root cause / code pointers

The Azure AI Projects agent-mode client intentionally clears non-overridable options in GetAgentEnabledChatOptions.

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

Status

No status

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions