Observability has moved. This repository no longer builds or releases the Agent365 observability packages. Use Microsoft OpenTelemetry Distro (
microsoft-opentelemetryon PyPI). Existing consumers must follow the Observability migration guide; this is not a drop-in replacement. Notifications, Runtime, and Tooling remain here.
Use the information in this README to contribute to this open-source project. To learn about using this SDK in your projects, refer to the Microsoft Agent 365 Developer documentation.
The Microsoft Agent 365 SDK extends the Microsoft 365 Agents SDK with enterprise-grade notifications, runtime utilities, and tooling for building production-ready agents for M365, Teams, Copilot Studio, and Webchat.
The Microsoft Agent 365 SDK in this repository focuses on three core areas:
- Notifications: Agent notification services and models for handling user notifications
- Runtime: Core utilities and extensions for agent runtime operations
- Tooling: Developer tools and utilities for building sophisticated agent applications
Please help improve the Microsoft Agent 365 SDK and CLI by taking our survey: Agent365 SDK Integration Feedback Survey
This project is currently in active development. Packages are published to PyPI as they become available.
The best way to consume this SDK is via our PyPI packages found here: pypi.org. All packages begin with microsoft-agents-a365.
- Python 3.10 or later
- pip or uv package manager
- Git
-
Clone the repository:
git clone https://github.com/microsoft/Agent365-python.git cd Agent365-python -
Create a virtual environment:
python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
-
Build the packages:
Bash (macOS/Linux):
export AGENT365_PYTHON_SDK_PACKAGE_VERSION="0.1.0" export PYTHONPATH="$PWD/versioning/helper" uv sync --locked --all-extras --dev output="$(mktemp -d)" uv build --all-packages --wheel --out-dir "$output" uv run --frozen --no-sync python scripts/verify_release_artifacts.py "$output" --version "$AGENT365_PYTHON_SDK_PACKAGE_VERSION"
PowerShell (Windows):
# Set the version $env:AGENT365_PYTHON_SDK_PACKAGE_VERSION = "0.1.0" # Use a new, empty output directory for each build (PowerShell) $env:PYTHONPATH = Join-Path (Get-Location) "versioning\helper" uv sync --locked --all-extras --dev $output = Join-Path ([System.IO.Path]::GetTempPath()) ("agent365-wheels-" + [guid]::NewGuid()) uv build --all-packages --wheel --out-dir $output uv run --frozen --no-sync python scripts\verify_release_artifacts.py $output --version $env:AGENT365_PYTHON_SDK_PACKAGE_VERSION
-
Run tests:
pytest tests/
- libraries/microsoft-agents-a365-notifications: Microsoft Agent 365 Notifications SDK - Agent notification services and models
- libraries/microsoft-agents-a365-runtime: Microsoft Agent 365 Runtime - Core runtime utilities and extensions
- libraries/microsoft-agents-a365-tooling: Microsoft Agent 365 Tooling SDK - Agent tooling and MCP integration
- libraries/microsoft-agents-a365-tooling-extensions-agentframework: Agent Framework tooling extensions
- libraries/microsoft-agents-a365-tooling-extensions-azureaifoundry: Azure AI Foundry tooling extensions
- libraries/microsoft-agents-a365-tooling-extensions-googleadk: Google ADK tooling extensions
- libraries/microsoft-agents-a365-tooling-extensions-openai: OpenAI tooling extensions
- libraries/microsoft-agents-a365-tooling-extensions-semantickernel: Semantic Kernel tooling extensions
- For sample applications, see the Microsoft Agent 365 SDK Samples repository
- tests/: Unit and integration tests
For issues, questions, or feedback:
- Issues: Please file issues in the GitHub Issues section
- Documentation: See the Microsoft Agents 365 developer documentation
- Security: For security issues, please see SECURITY.md
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
The core SDK for building conversational AI agents for Microsoft 365 platforms.
- Microsoft 365 Agents SDK - C# /.NET repository
- Microsoft 365 Agents SDK - NodeJS /TypeScript repository
- Microsoft 365 Agents SDK - Python repository
- Microsoft 365 Agents documentation
Enterprise-grade extensions for notifications, runtime utilities, and developer tools. Python observability is maintained separately in the Microsoft OpenTelemetry Distro.
- Microsoft Agent 365 SDK - C# /.NET repository
- Microsoft Agent 365 SDK - Python repository - You are here
- Microsoft Agent 365 SDK - Node.js/TypeScript repository
- Microsoft Agent 365 SDK Samples repository
- Microsoft Agent 365 developer documentation
Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.
Copyright (c) Microsoft Corporation. All rights reserved.
Licensed under the MIT License - see the LICENSE file for details.