Skip to content

docs(a2a): register Microsoft Foundry agents over A2A with Entra credentials - #1508

Merged
mateo-berri merged 2 commits into
mainfrom
litellm_a2a_foundry_entra_docs
Sep 18, 2026
Merged

mateo-berri merged 2 commits into
mainfrom
litellm_a2a_foundry_entra_docs

Conversation

@mateo-berri

@mateo-berri mateo-berri commented Sep 17, 2026 •

Copy link
Copy Markdown
Contributor

TLDR

Documents the config.yaml entry for a Microsoft Foundry agent reached over A2A, added in BerriAI/litellm#41511: the agent_card_path litellm_param, the Entra credential fields on the agent, the card discovery order, the capabilities.streaming: false fallback for streaming chat completions, and where a credential LiteLLM mints itself sits in the header merge

Pages touched:

  • docs/providers/azure_ai_agents.md: new "Foundry agents over A2A" section with the config entry, an A2A blocking send, and a chat completions call
  • docs/a2a.md: points agents from the current Foundry portal at that section and names the optional litellm_params block
  • docs/a2a_agent_card.md: the three probe paths, agent_card_path, and what a card without truthy streaming does
  • docs/a2a_agent_headers.md: a minted Authorization wins over static and client-forwarded ones, whatever the casing

Lands with BerriAI/litellm#41511 (LIT-5122)


Note

Low Risk
Documentation-only changes with no runtime or security logic modified in this diff.

Overview
This PR is documentation only, aligned with the A2A/Foundry implementation in BerriAI/litellm#41511. It explains how to register current Microsoft Foundry portal agents via plain A2A (not azure_ai/agents/…), using Entra on the agent’s litellm_params.

docs/providers/azure_ai_agents.md adds Foundry agents over A2A: the A2A endpoint URL, a full config.yaml example with agent_card_path, Entra fields, and capabilities.streaming: false, credential variants (azure_ad_token, user/password, azure_scope), blocking message/send and chat-completions curl examples, and Foundry’s non-streaming behavior.

docs/a2a.md calls out optional per-agent litellm_params and links Foundry portal agents to that section.

docs/a2a_agent_card.md updates card discovery to three probe paths plus agent_card_path, and documents when capabilities.streaming forces blocking send for streaming chat completions.

docs/a2a_agent_headers.md states that LiteLLM-minted Authorization (Entra/Databricks OAuth) overrides static and forwarded client headers, with client Authorization stripped regardless of casing.

Reviewed by Cursor Bugbot for commit a0b323f. Bugbot is set up for automated code reviews on this repo. Configure here.

@vercel

vercel Bot commented Sep 17, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
litellm Ready Ready Preview Sep 18, 2026 1:16am UTC

Request Review

@mateo-berri

Copy link
Copy Markdown
Contributor Author

bugbot run

@cursor cursor Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Stale Bugbot comment from a previous run.

The proxy exchanges an oidc/ federated token only with the tenant_id and
client_id stored on that agent, so the paragraph names them next to the
token instead of leaving the host's AZURE_* variables as the implied
fallback
@mateo-berri

Copy link
Copy Markdown
Contributor Author

bugbot run

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit a0b323f. Configure here.

@mateo-berri
mateo-berri merged commit fa704ad into main Sep 18, 2026
5 checks passed
@mateo-berri
mateo-berri deleted the litellm_a2a_foundry_entra_docs branch September 18, 2026 18:45

This branch was successfully deployed

1 active deployment
Preview — a0b323fe Deployed Sep 18, 2026 by vercel[bot]
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.

1 participant