Meta

• Author: Microsoft Corporation License-Expression: MIT
• Requires: Python >=3.10

Classifiers

• Operating System
  • OS Independent
• Programming Language
  • Python :: 3
  • Python :: 3.10
  • Python :: 3.11
  • Python :: 3.12
  • Python :: 3.13
  • Python :: 3.14

Microsoft Agents Hosting - aiohttp

👁 PyPI version

Integration library for hosting Microsoft 365 Agents using aiohttp. This library provides HTTP adapters, middleware, and utilities for building web-based agent applications with the popular aiohttp framework.

This library bridges the Microsoft 365 Agents SDK with aiohttp, allowing you to create HTTP endpoints that handle agent conversations. It provides everything you need to host agents as web services, including request processing, authentication, and routing.

What is this?

This library is part of the Microsoft 365 Agents SDK for Python - a comprehensive framework for building enterprise-grade conversational AI agents. The SDK enables developers to create intelligent agents that work across multiple platforms including Microsoft Teams, M365 Copilot, Copilot Studio, and web chat, with support for third-party integrations like Slack, Facebook Messenger, and Twilio.

Release Notes

Version	Date	Release Notes
1.0.0	2026-05-22	1.0.0 Release Notes
0.9.0	2026-04-15	0.9.0 Release Notes
0.8.0	2026-02-23	0.8.0 Release Notes
0.7.0	2026-01-21	0.7.0 Release Notes
0.6.1	2025-12-01	0.6.1 Release Notes
0.6.0	2025-11-18	0.6.0 Release Notes
0.5.0	2025-10-22	0.5.0 Release Notes

Packages Overview

We offer the following PyPI packages to create conversational experiences based on Agents:

Package Name	PyPI Version	Description
microsoft-agents-activity	👁 PyPI	Types and validators implementing the Activity protocol spec.
microsoft-agents-hosting-core	👁 PyPI	Core library for Microsoft Agents hosting.
microsoft-agents-hosting-aiohttp	👁 PyPI	Configures aiohttp to run the Agent.
microsoft-agents-hosting-teams	👁 PyPI	Provides classes to host an Agent for Teams.
microsoft-agents-storage-blob	👁 PyPI	Extension to use Azure Blob as storage.
microsoft-agents-storage-cosmos	👁 PyPI	Extension to use CosmosDB as storage.
microsoft-agents-authentication-msal	👁 PyPI	MSAL-based authentication for Microsoft Agents.

Additionally we provide a Copilot Studio Client, to interact with Agents created in CopilotStudio:

Package Name	PyPI Version	Description
microsoft-agents-copilotstudio-client	👁 PyPI	Direct to Engine client to interact with Agents created in CopilotStudio

Installation

pipinstallmicrosoft-agents-hosting-aiohttp

Simple Echo Agent

See the Quickstart sample for full working code.

agents_sdk_config = load_configuration_from_env(environ)

STORAGE = MemoryStorage()
CONNECTION_MANAGER = MsalConnectionManager(**agents_sdk_config)
ADAPTER = CloudAdapter(connection_manager=CONNECTION_MANAGER)
AUTHORIZATION = Authorization(STORAGE, CONNECTION_MANAGER, **agents_sdk_config)

AGENT_APP = AgentApplication[TurnState](
 storage=STORAGE, adapter=ADAPTER, authorization=AUTHORIZATION, **agents_sdk_config
)

@AGENT_APP.activity("message")
async defon_message(context: TurnContext, state: TurnState):
 await context.send_activity(f"You said: {context.activity.text}")

...

start_server(
 agent_application=AGENT_APP,
 auth_configuration=CONNECTION_MANAGER.get_default_connection_configuration(),
)

Error Handling

Customize error responses. Code take from the Quickstart sample.

@AGENT_APP.error
async defon_error(context: TurnContext, error: Exception):
 # This check writes out errors to console log
 # NOTE: In production environment, you should consider logging this to Azure
 # application insights.
 print(f"\n [on_turn_error] unhandled error: {error}", file=sys.stderr)
 traceback.print_exc()

 # Send a message to the user
 await context.send_activity("The bot encountered an error or bug.")

Features

✅ HTTP hosting - Full aiohttp integration for web hosting
✅ JWT authentication - Built-in security with middleware
✅ Agent-to-agent - Support for multi-agent communication
✅ Streaming - Real-time response streaming
✅ Error handling - Comprehensive error management
✅ Development friendly - Hot reload and debugging support

Requirements

• Python 3.10+ (supports 3.10, 3.11, 3.12, 3.13, 3.14)
• aiohttp 3.11.11+
• Microsoft Agents hosting core library

Best Practices

1. Use middleware for cross-cutting concerns like auth and logging
2. Handle errors gracefully with custom error handlers
3. Secure your endpoints with JWT middleware in production
4. Structure routes logically for agent communication

Quick Links

• 📦 All SDK Packages on PyPI
• 📖 Complete Documentation
• 💡 Python Samples Repository
• 🐛 Report Issues

Sample Applications

Name	Description	README
Quickstart	Simplest agent	Quickstart
Auto Sign In	Simple OAuth agent using Graph and GitHub	auto-signin
OBO Authorization	OBO flow to access a Copilot Studio Agent	obo-authorization
Semantic Kernel Integration	A weather agent built with Semantic Kernel	semantic-kernel-multiturn
Streaming Agent	Streams OpenAI responses	azure-ai-streaming
Copilot Studio Client	Console app to consume a Copilot Studio Agent	copilotstudio-client
Cards Agent	Agent that uses rich cards to enhance conversation design	cards

Verified details

These details have been verified by PyPI

Maintainers

👁 Avatar for microsoft from gravatar.com
microsoft

Unverified details

These details have not been verified by PyPI

Project links

• Homepage

• Download URL: microsoft_agents_hosting_aiohttp-1.0.0.tar.gz
• Upload date: May 22, 2026
• Size: 10.7 kB
• Tags: Source
• Uploaded using Trusted Publishing? No
• Uploaded via: RestSharp/106.13.0.0

Hashes for microsoft_agents_hosting_aiohttp-1.0.0.tar.gz

Algorithm	Hash digest
SHA256	dba592bf78c6686cf3f9da6fb561aaecc343b0ecbed92caa4d65f220ead93041
MD5	c9479ad87c66231118285ace736d1661
BLAKE2b-256	c1f60df4be866c614bdbe997e04a22c5d6d51703b76b82ba8a5df39af206c637

See more details on using hashes here.

• Download URL: microsoft_agents_hosting_aiohttp-1.0.0-py3-none-any.whl
• Upload date: May 22, 2026
• Size: 9.9 kB
• Tags: Python 3
• Uploaded using Trusted Publishing? No
• Uploaded via: RestSharp/106.13.0.0

Hashes for microsoft_agents_hosting_aiohttp-1.0.0-py3-none-any.whl

Algorithm	Hash digest
SHA256	3f5460632e86f931daf9b89a3a8747fa5734883d84d21d1a877a7f74e87b870c
MD5	4f05964c222e8680182b228dada9b51e
BLAKE2b-256	ec1f19764b23f5e8a70bb1f853539477961589a11bfd5d4ee6c1ee0582e55292

See more details on using hashes here.