Skip to content

Sample : a2a-in-teams#401

Merged
MehakBindra merged 19 commits intomainfrom
mehak/a2a-new
Apr 25, 2026
Merged

Sample : a2a-in-teams#401
MehakBindra merged 19 commits intomainfrom
mehak/a2a-new

Conversation

@MehakBindra
Copy link
Copy Markdown
Contributor

This pull request introduces a new example in examples/a2a-test demonstrating two symmetric Microsoft Teams bots (Alice and Bob) that relay questions and answers using the official a2a-sdk and Adaptive Cards. The implementation is modularized into clear components for A2A communication, card construction, bot logic, and state management. The README and dependencies are updated to reflect the new architecture and usage.

The most important changes are:

New A2A Example Architecture and Implementation

  • Added a comprehensive example with two Teams bots (bot_a.py and bot_b.py) that can relay questions to each other over A2A, using Adaptive Cards for human-in-the-loop answers. Each bot can both send and receive questions, and route replies back to the original asker. [1] [2]

A2A Communication Layer

  • Introduced a2a_client.py for outbound A2A message sending, which resolves the peer’s agent card and sends a single message using the a2a-sdk.
  • Added a2a_executor.py implementing an AgentExecutor that routes incoming A2A ask and reply messages to the appropriate Teams conversation, updating bot state as needed.
  • Added a2a_server.py to wrap the executor in an A2AStarletteApplication for serving A2A requests.

Adaptive Card Construction

  • Added cards.py with builder functions for the "ask" and "reply" Adaptive Cards, embedding routing metadata so no per-question state is needed on the receiving bot.

Documentation and Dependency Updates

  • Overhauled README.md to document the new flow, file structure, operator requirements, and setup instructions.
  • Updated pyproject.toml to reflect new dependencies (a2a-sdk, uvicorn, httpx, etc.) and renamed the package for clarity.

Copilot AI review requested due to automatic review settings April 23, 2026 00:52
@MehakBindra MehakBindra changed the title a2a-in-teams Sample : a2a-in-teams Apr 23, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a new examples/a2a-test sample that demonstrates two symmetric Microsoft Teams bots (Alice/Bob) exchanging “ask” and “reply” messages over A2A, using Adaptive Cards for human-in-the-loop responses.

Changes:

  • Introduces modular A2A components (a2a_client, a2a_executor, a2a_server) plus shared Adaptive Card builders and a small in-memory bot state object.
  • Adds two runnable bot entrypoints (bot_a.py, bot_b.py) that can both send “ask” requests and handle “reply” callbacks.
  • Updates the example README and pyproject.toml dependencies to match the new architecture.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 14 comments.

Show a summary per file
File Description
examples/a2a-test/src/state.py Adds BotState for operator conversation tracking and outbound qid→conversation mapping.
examples/a2a-test/src/cards.py Adds Adaptive Card builders for ask/reply with embedded routing metadata.
examples/a2a-test/src/a2a_client.py Adds a simple one-shot outbound A2A sender using a2a-sdk + httpx.
examples/a2a-test/src/a2a_executor.py Adds server-side A2A dispatch logic for ask/reply and pushes cards into Teams.
examples/a2a-test/src/a2a_server.py Wraps the executor in an A2AStarletteApplication and exposes an agent card/handler.
examples/a2a-test/src/bot_a.py Adds Alice bot: Teams handler + A2A server + card-action reply routing.
examples/a2a-test/src/bot_b.py Adds Bob bot: symmetric to Alice with separate ports and peer config.
examples/a2a-test/src/main.py Removes the prior single-file weather-oriented sample implementation.
examples/a2a-test/pyproject.toml Renames the example project and updates dependencies for the new approach.
examples/a2a-test/README.md Documents the new two-bot flow, file structure, and run instructions.

Comment thread examples/a2a-test/src/bot_b.py Outdated
Comment thread examples/a2a-test/src/bot_b.py Outdated
Comment thread examples/a2a-test/src/bot_b.py
Comment thread examples/a2a-test/src/state.py Outdated
Comment thread examples/a2a-test/src/cards.py Outdated
Comment thread examples/a2a-test/src/bot_b.py Outdated
Comment thread examples/a2a-test/src/state.py Outdated
Comment thread examples/a2a-test/src/a2a_client.py Outdated
Comment thread examples/a2a-test/src/bot_a.py Outdated
Comment thread examples/a2a-test/src/bot_a.py Outdated
MehakBindra and others added 5 commits April 22, 2026 18:04
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…utor.py (Ruff B018)

Agent-Logs-Url: https://github.com/microsoft/teams.py/sessions/ceb8bbad-5e0d-4c3e-ae9e-9436b3a2ac1e

Co-authored-by: MehakBindra <83925928+MehakBindra@users.noreply.github.com>
…in bot_b.py

Agent-Logs-Url: https://github.com/microsoft/teams.py/sessions/45ac9cb6-3bfe-47e4-aefe-d18efa2cb742

Co-authored-by: MehakBindra <83925928+MehakBindra@users.noreply.github.com>
Comment thread examples/a2a-test/src/a2a_client.py
Comment thread examples/a2a-test/README.md Outdated
Comment thread examples/a2a-test/src/bot_b.py
Comment thread examples/a2a-test/src/a2a_executor.py Outdated
Comment thread examples/a2a-test/src/a2a_executor.py Outdated
Comment thread examples/a2a-test/src/a2a_executor.py Outdated
Comment thread examples/a2a-test/src/bot_a.py Outdated
Comment thread examples/a2a-test/src/agent.py
Comment thread examples/a2a-test/src/agent.py
Comment thread examples/a2a-test/src/bot_a.py Outdated
MehakBindra and others added 2 commits April 24, 2026 16:56
Co-authored-by: Copilot <copilot@github.com>
@MehakBindra MehakBindra merged commit 433699a into main Apr 25, 2026
7 checks passed
@MehakBindra MehakBindra deleted the mehak/a2a-new branch April 25, 2026 00:03
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.

5 participants