Microsoft 365 Agents SDK for Python
Build async, multichannel agents for Teams, Microsoft 365, and Copilot Studio.
The documentation recommends environment-held secrets, MSAL, JWT middleware, and explicit Graph authentication, and it shows the intended token use. However, it does not define least-privilege scopes, user confirmation, token lifecycle or log redaction, complete external data-flow disclosure, or rollback. MemoryStorage is only flagged for replacement in production. Main risks are visible but governance is incomplete, so points are deducted.
Core hosting, routing, streaming, and error-handling paths are illustrated, and streaming cleanup uses finally. However, examples have omitted or potentially unresolved dependencies/imports such as Activity, the Copilot example conflicts with the broad async-with rule, API signatures require external verification, and no skill-specific tests or abnormal-input diagnostics are provided. Under static calibration the score is capped at 10 and is reduced for these gaps.
Trigger phrases, Python audience, Teams/M365/Copilot Studio scenarios, and major capabilities are reasonably clear. Non-fit boundaries, deployment prerequisites, authentication-mode boundaries, and input/output contracts are under-specified, with no Chinese-language or mainland-China reachability guidance. The scenario is clear but semantic and environment-fit evidence is limited, so points are deducted.
The skill includes metadata, installation instructions, environment variables, layered examples, best practices, reference links, and a capabilities reference. MIT licensing and Microsoft attribution are clear. It lacks an explicit maintainer, changelog, compatibility matrix, dependency pinning, troubleshooting guidance, and complete resource-cleanup instructions; some guidance also depends on external MCP access. Points are deducted for these maintenance and usability gaps.
The material directly covers aiohttp hosting, routing, streaming, OAuth, and the Copilot Studio client, making it useful as implementation guidance. However, several snippets require users to fill in imports, configuration, version checks, and production security details, and no directly verified representative output or end-to-end result is supplied. Static calibration caps effectiveness at 7, which is awarded as the ceiling but not exceeded.
The files provide traceable Microsoft Learn, GitHub sample, and PyPI references, plus repository-level CI/test material. Those materials do not demonstrate executed verification of this skill's key paths, and there are no skill-specific tests, pinned dependency versions, or documented cross-checks. Evidence is auditable but limited, so points are deducted.
- Verify current SDK API signatures and package versions before implementation; the document explicitly requires external Microsoft Docs MCP and PyPI verification.
- Do not treat the snippets as production-ready: enforce least-privilege OAuth/Graph scopes, prevent token logging, and define user consent, data purpose, storage, and recovery behavior.
- Check every example for imports, asynchronous resource cleanup, and CopilotClient shutdown; MemoryStorage is intended only for development.
- If the environment cannot reach Microsoft/Azure services, Graph, Copilot Studio, or the external documentation MCP, core operation and verification may be blocked.
What it does & when to use it
This skill gives coding agents implementation guidance for the Microsoft 365 Agents SDK for Python. It covers aiohttp hosting, AgentApplication routing, streaming responses, MSAL authentication, Microsoft Graph calls, and the Copilot Studio client. It includes installation commands, environment-variable templates, complete code patterns, and production-oriented practices. It fits developers building Python agents for Microsoft 365, Teams, or Copilot Studio.
It instructs a coding agent to install the Microsoft Agents SDK Python packages, configure connection and tenant settings, and produce an aiohttp application using CloudAdapter, AgentApplication, TurnContext, storage, and routing handlers. The examples cover conversation updates, string and regex message routes, invoke activities, error handling, OAuth-protected routes, Microsoft Graph requests, Azure OpenAI streaming, and direct Copilot Studio conversations. Before implementation, it directs the agent to verify current API signatures through the microsoft-docs MCP and confirm package versions on PyPI.
- A Python developer building an aiohttp-hosted multichannel agent for Teams or Microsoft 365.
- A team routing commands, messages, and activity types through AgentApplication decorators.
- A developer adding MSAL-based sign-in, token retrieval, Microsoft Graph access, and sign-out flows.
- A team integrating Azure OpenAI streaming responses into a Microsoft 365 agent.
- A developer connecting directly to a Copilot Studio agent from Python and streaming conversation actions.
Pros & cons
- Provides end-to-end Python patterns from package installation and environment configuration to the aiohttp server entry point.
- Covers routing, OAuth, Microsoft Graph, Azure OpenAI streaming, and Copilot Studio integration.
- Emphasizes async handlers, explicit authentication managers, context-managed resources, and guaranteed stream cleanup.
- Released under the MIT license and installable through the repository’s skill collection.
- The examples require several Microsoft Agents packages along with aiohttp, MSAL, Azure Identity, and the OpenAI client.
- The instructions require checking the current documentation and PyPI versions, so examples should not be treated as immutable API guarantees.
- The provided material does not include a dedicated test suite or platform compatibility evidence for this individual skill.
- CopilotClient is documented as not implementing the context-manager protocol, and the token-cache implementation is only a placeholder in the example.
How to install
Install the collection with npx skills add microsoft/skills, then select m365-agents-py in the wizard. The README says skills are installed in the selected coding agent directory, such as .github/skills/ for GitHub Copilot. The repository source path for this skill is .github/plugins/azure-sdk-python/skills/m365-agents-py/SKILL.md. For the generated application, install the listed Microsoft Agents SDK packages plus python-dotenv and aiohttp with pip.
How to use
Give the coding agent a request such as: “Build an aiohttp-hosted Teams agent with the Microsoft 365 Agents SDK for Python, AgentApplication routing, MSAL authentication, and message handlers.” Ask it to verify the latest signatures for AgentApplication, start_agent_process, and authentication options, and to confirm the relevant PyPI package versions. Supply the required client, secret, and tenant environment variables, plus Azure OpenAI or Copilot Studio variables when those integrations are needed.
Compared to similar skills
The README identifies .NET and TypeScript Microsoft 365 Agents SDK skills in the same repository, but this profile covers only the Python skill.