Fastapi integration package by axelsrz · Pull Request #176 · microsoft/Agents-for-python

axelsrz · 2025-10-16T16:23:16Z

This pull request introduces the initial implementation of the microsoft-agents-hosting-fastapi library, providing FastAPI-based hosting capabilities for Microsoft Agents. The changes establish the package structure, core streaming response functionality, and utilities for handling citations and feedback in conversational AI scenarios.

Key additions and features include:

Core Streaming and Citation Functionality:

Implements the StreamingResponse class, enabling chunked and interactive streaming of messages, citations, and feedback to clients, with support for Teams and Direct Line channels (streaming_response.py).
Adds utility classes for citation handling, including the Citation dataclass and CitationUtil for formatting and extracting citations from text (citation.py, citation_util.py). [1] [2]

FastAPI Hosting Adapters and Process Management:

Defines the AgentHttpAdapter protocol for handling HTTP requests to agents, and provides the start_agent_process async function to bootstrap agent processes with adapters (agent_http_adapter.py, _start_agent_process.py). [1] [2]

Package Structure and Metadata:

Establishes the package structure with __init__.py files and sets up exports for all major components (__init__.py in relevant directories). [1] [2] [3] [4] [5]
Adds an MIT license file for open source compliance.

These changes lay the groundwork for FastAPI-based hosting of Microsoft Agents with robust streaming and citation capabilities.

...soft-agents-hosting-fastapi/microsoft_agents/hosting/fastapi/jwt_authorization_middleware.py

Copilot

Pull Request Overview

This pull request introduces the initial implementation of the microsoft-agents-hosting-fastapi library, providing FastAPI-based hosting capabilities for Microsoft Agents with robust streaming, citation handling, and authorization features.

Key changes include:

Implementation of streaming response functionality with support for Teams and Direct Line channels
JWT authorization middleware and dependency injection patterns for FastAPI
Channel service API endpoints and cloud adapter for processing agent activities

Reviewed Changes

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

Show a summary per file

File	Description
setup.py	Package configuration with FastAPI dependency
pyproject.toml	Project metadata and build configuration
readme.md	Documentation with usage examples
streaming_response.py	Core streaming functionality for chunked responses
citation.py & citation_util.py	Citation handling utilities and data structures
jwt_authorization_middleware.py	JWT authentication middleware for FastAPI
cloud_adapter.py	HTTP adapter for processing agent activities
channel_service_route_table.py	API route definitions for channel service
agent_http_adapter.py	Protocol definition for HTTP adapters
_start_agent_process.py	Function to bootstrap agent processes
init.py files	Package structure and exports
LICENSE	MIT license file

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

...soft-agents-hosting-fastapi/microsoft_agents/hosting/fastapi/jwt_authorization_middleware.py

...-agents-hosting-fastapi/microsoft_agents/hosting/fastapi/app/streaming/streaming_response.py

…rough an exception Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>

…sting/fastapi/app/streaming/streaming_response.py Co-authored-by: Copilot <[email protected]>

Copilot

Pull Request Overview

Copilot reviewed 17 out of 17 changed files in this pull request and generated 4 comments.

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

...soft-agents-hosting-fastapi/microsoft_agents/hosting/fastapi/jwt_authorization_middleware.py

…into users/axsuarez/fast-api-integration

Copilot

Pull Request Overview

Copilot reviewed 24 out of 24 changed files in this pull request and generated 3 comments.

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

test_samples/fastapi/README.md

test_samples/fastapi/authorization_agent.py

libraries/microsoft-agents-hosting-fastapi/microsoft_agents/hosting/fastapi/__init__.py

…into users/axsuarez/fast-api-integration

This reverts commit 3024b7c.

Copilot

Pull Request Overview

Copilot reviewed 28 out of 28 changed files in this pull request and generated 9 comments.

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

test_samples/fastapi/shared/__init__.py

test_samples/fastapi/empty_agent.py

test_samples/fastapi/shared/github_api_client.py

test_samples/fastapi/authorization_agent.py

libraries/microsoft-agents-hosting-fastapi/microsoft_agents/hosting/fastapi/__init__.py

libraries/microsoft-agents-hosting-core/microsoft_agents/hosting/core/app/typing_indicator.py

libraries/microsoft-agents-hosting-core/microsoft_agents/hosting/core/app/agent_application.py

Copilot

Pull Request Overview

Copilot reviewed 28 out of 28 changed files in this pull request and generated 2 comments.

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

libraries/microsoft-agents-hosting-core/microsoft_agents/hosting/core/app/typing_indicator.py

test_samples/fastapi/authorization_agent.py

This reverts commit e7f0cad.

Co-authored-by: Copilot <[email protected]>

Copilot

Pull Request Overview

Copilot reviewed 25 out of 25 changed files in this pull request and generated 2 comments.

Comments suppressed due to low confidence (1)

libraries/microsoft-agents-hosting-fastapi/microsoft_agents/hosting/fastapi/app/streaming/streaming_response.py:1

The magic number 477 should be extracted to a named constant (e.g., MAX_CITATION_ABSTRACT_LENGTH) to improve code readability and maintainability.

# Copyright (c) Microsoft Corporation. All rights reserved.

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

test_samples/fastapi/shared/github_api_client.py

test_samples/fastapi/authorization_agent.py

Co-authored-by: Copilot <[email protected]>

Copilot

Pull Request Overview

Copilot reviewed 25 out of 25 changed files in this pull request and generated 4 comments.

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

test_samples/fastapi/shared/github_api_client.py

test_samples/fastapi/authorization_agent.py

test_samples/fastapi/empty_agent.py

Co-authored-by: Copilot <[email protected]>

Copilot

Pull Request Overview

Copilot reviewed 25 out of 25 changed files in this pull request and generated 5 comments.

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

test_samples/fastapi/authorization_agent.py

test_samples/fastapi/empty_agent.py

...-agents-hosting-fastapi/microsoft_agents/hosting/fastapi/app/streaming/streaming_response.py

test_samples/fastapi/authorization_agent.py

Co-authored-by: Copilot <[email protected]>

Copilot

Pull Request Overview

Copilot reviewed 25 out of 25 changed files in this pull request and generated no new comments.

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

…t rreview fixers

…ed merge conflicts

Copilot

Pull Request Overview

Copilot reviewed 25 out of 25 changed files in this pull request and generated 3 comments.

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

test_samples/fastapi/shared/github_api_client.py

test_samples/fastapi/shared/__init__.py

test_samples/fastapi/authorization_agent.py

Co-authored-by: Copilot <[email protected]>

Copilot

Pull Request Overview

Copilot reviewed 25 out of 25 changed files in this pull request and generated 3 comments.

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

test_samples/fastapi/shared/__init__.py

...-agents-hosting-fastapi/microsoft_agents/hosting/fastapi/app/streaming/streaming_response.py

test_samples/fastapi/shared/cards.py

…sting/fastapi/app/streaming/streaming_response.py Co-authored-by: Copilot <[email protected]>

Co-authored-by: Copilot <[email protected]>

Copilot

Pull Request Overview

Copilot reviewed 25 out of 25 changed files in this pull request and generated no new comments.

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

…com/microsoft/Agents-for-python into users/axsuarez/fast-api-integration

Fastapi integration draft

c7423e8

Copilot AI review requested due to automatic review settings October 16, 2025 16:23

github-advanced-security bot found potential problems Oct 16, 2025

View reviewed changes

...soft-agents-hosting-fastapi/microsoft_agents/hosting/fastapi/jwt_authorization_middleware.py Fixed Show fixed Hide fixed

Copilot AI reviewed Oct 16, 2025

View reviewed changes

Potential fix for code scanning alert no. 11: Information exposure th…

1a6aa8d

…rough an exception Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>

Copilot AI review requested due to automatic review settings October 16, 2025 18:13

Update libraries/microsoft-agents-hosting-fastapi/microsoft_agents/ho…

0a6d895

…sting/fastapi/app/streaming/streaming_response.py Co-authored-by: Copilot <[email protected]>

Copilot AI reviewed Oct 16, 2025

View reviewed changes

axelsrz added 3 commits October 20, 2025 13:20

Merge branch 'main' of https://github.com/microsoft/Agents-for-python …

8b3f33d

…into users/axsuarez/fast-api-integration

Fastapi integration wip

57eccd8

Fastapi integration wip, emtpy agent working

3d4c0fe

Copilot AI review requested due to automatic review settings October 22, 2025 00:01

Copilot AI reviewed Oct 22, 2025

View reviewed changes

test_samples/fastapi/README.md Outdated Show resolved Hide resolved

test_samples/fastapi/authorization_agent.py Outdated Show resolved Hide resolved

libraries/microsoft-agents-hosting-fastapi/microsoft_agents/hosting/fastapi/__init__.py Show resolved Hide resolved

axelsrz added 4 commits October 24, 2025 13:30

Merge branch 'main' of https://github.com/microsoft/Agents-for-python …

bf4a0d1

…into users/axsuarez/fast-api-integration

Fastapi integration wip, auth agent bugfixing

619dd4a

Revert "1. TypingIndicator Concurrency & Argument fixes (#187)"

e7f0cad

This reverts commit 3024b7c.

Fastapi integration tentative, need to validate auth behavior

c72a8eb

Copilot AI review requested due to automatic review settings October 24, 2025 22:47

Copilot AI reviewed Oct 24, 2025

View reviewed changes

Fastapi integration tentative, need to validate auth behavior: nit fix

268d523

axelsrz marked this pull request as ready for review October 24, 2025 22:51

axelsrz requested a review from a team as a code owner October 24, 2025 22:51

Copilot AI review requested due to automatic review settings October 24, 2025 22:51

Copilot AI reviewed Oct 24, 2025

View reviewed changes

libraries/microsoft-agents-hosting-core/microsoft_agents/hosting/core/app/typing_indicator.py Outdated Show resolved Hide resolved

test_samples/fastapi/authorization_agent.py Show resolved Hide resolved

axelsrz and others added 2 commits October 27, 2025 13:48

Reapply "1. TypingIndicator Concurrency & Argument fixes (#187)"

1e0a306

This reverts commit e7f0cad.

Update test_samples/fastapi/README.md

c0807d6

Co-authored-by: Copilot <[email protected]>

Copilot AI review requested due to automatic review settings October 27, 2025 20:57

Copilot AI reviewed Oct 27, 2025

View reviewed changes

test_samples/fastapi/shared/github_api_client.py Show resolved Hide resolved

test_samples/fastapi/authorization_agent.py Show resolved Hide resolved

Update test_samples/fastapi/shared/__init__.py

36bf460

Co-authored-by: Copilot <[email protected]>

Copilot AI review requested due to automatic review settings October 27, 2025 21:03

Copilot AI reviewed Oct 27, 2025

View reviewed changes

Update test_samples/fastapi/shared/github_api_client.py

8174a78

Co-authored-by: Copilot <[email protected]>

Copilot AI review requested due to automatic review settings October 27, 2025 21:05

Copilot AI reviewed Oct 27, 2025

View reviewed changes

Update test_samples/fastapi/authorization_agent.py

e4784cf

Co-authored-by: Copilot <[email protected]>

Copilot AI review requested due to automatic review settings October 27, 2025 21:06

Copilot AI reviewed Oct 27, 2025

View reviewed changes

Fastapi integration tentative, need to validate auth behavior: copilo…

19cf97c

…t rreview fixers

rodrigobr-msft previously approved these changes Oct 27, 2025

View reviewed changes

Fastapi integration tentative, need to validate auth behavior: resolv…

cb48382

…ed merge conflicts

axelsrz dismissed rodrigobr-msft’s stale review via cb48382 October 27, 2025 21:13

Merge branch 'main' into users/axsuarez/fast-api-integration

51e7db4

Copilot AI review requested due to automatic review settings October 27, 2025 21:14

Copilot AI reviewed Oct 27, 2025

View reviewed changes

test_samples/fastapi/shared/github_api_client.py Outdated Show resolved Hide resolved

test_samples/fastapi/shared/__init__.py Outdated Show resolved Hide resolved

test_samples/fastapi/authorization_agent.py Show resolved Hide resolved

Update test_samples/fastapi/shared/github_api_client.py

5e948bc

Co-authored-by: Copilot <[email protected]>

Copilot AI review requested due to automatic review settings October 27, 2025 21:25

Copilot AI reviewed Oct 27, 2025

View reviewed changes

test_samples/fastapi/shared/__init__.py Outdated Show resolved Hide resolved

...-agents-hosting-fastapi/microsoft_agents/hosting/fastapi/app/streaming/streaming_response.py Outdated Show resolved Hide resolved

test_samples/fastapi/shared/cards.py Outdated Show resolved Hide resolved

Update libraries/microsoft-agents-hosting-fastapi/microsoft_agents/ho…

6b9f0f5

…sting/fastapi/app/streaming/streaming_response.py Co-authored-by: Copilot <[email protected]>

Copilot AI review requested due to automatic review settings October 27, 2025 21:26

Update test_samples/fastapi/shared/cards.py

7c3d1af

Co-authored-by: Copilot <[email protected]>

Copilot AI reviewed Oct 27, 2025

View reviewed changes

axelsrz added 2 commits October 27, 2025 14:27

Fastapi integration tentative, need to validate auth behavior: nit fix

a72346c

Merge branch 'users/axsuarez/fast-api-integration' of https://github.…

64fe22e

…com/microsoft/Agents-for-python into users/axsuarez/fast-api-integration

rodrigobr-msft approved these changes Oct 27, 2025

View reviewed changes

axelsrz merged commit 541fe76 into main Oct 27, 2025
10 checks passed

axelsrz deleted the users/axsuarez/fast-api-integration branch October 27, 2025 21:35

Copilot AI mentioned this pull request Dec 2, 2025

Add 0.6.0 Release Notes #270

Closed

Conversation

axelsrz commented Oct 16, 2025

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Uh oh!