microsoft-agents-activity
A protocol library for Microsoft Agents
Decision gist · record as of 2026-08-14
Yes. This is a lightweight, actively maintained protocol library with no security vulnerabilities, permissive licensing, and a single well-known dependency. Install it if you are building agents for Microsoft 365 platforms or integrating with the Microsoft Agents SDK ecosystem. It is also safe to install as a transitive dependency of higher-level hosting packages.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Low install friction with a single pure-Python dependency (pydantic).
- Active maintenance with a release 15 days ago and regular updates since first release in July 2025.
License · maintenance · safety
MIT (permissive) — MIT license permits free use, modification, and distribution with minimal restrictions—suitable for commercial and open-source projects.
last release 2026-07-30 (15 days) · last repo commit 2026-08-13 · 1,036 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 937,638 downloads/mo, #4,689 on PyPI
Alternatives
Verify before relying
pip install microsoft-agents-activity
from microsoft_agents_activity import Activity, ActivityTypes
# Create a message activity
message = Activity(
type=ActivityTypes.message,
text="Hello from agent"
)- Whether the Activity protocol implementation is fully compatible with all Microsoft 365 platforms mentioned or if some require additional hosting packages.
- Whether pydantic version constraints exist that might conflict with other dependencies in a larger project.
What it is and what it does
Microsoft Agents Activity is a protocol library that defines the core types and schemas for building conversational AI agents on Microsoft 365 platforms. It implements the Activity protocol—a messaging standard used across Teams, Copilot Studio, and web chat—providing Pydantic-validated data structures for different communication types (messages, typing indicators, conversation updates, events, invokes, and end-of-conversation signals). The library is the foundational layer of the Microsoft 365 Agents SDK; it does not itself host agents or manage conversation state, but rather supplies the type definitions that other packages in the SDK ecosystem (hosting, storage, authentication) build upon.
Developers use this package when they need to work with agent activities programmatically—parsing incoming messages, constructing outgoing responses with cards and attachments, or integrating custom logic into an agent pipeline. It is typically installed as a dependency of higher-level hosting packages, but can also be used standalone for activity validation or schema-driven development. The library requires Python 3.10 or later and depends only on pydantic.
Use it for
- Define and validate incoming and outgoing agent messages when building a custom agent handler or middleware.
- Construct rich message cards (animations, attachments, interactive elements) to send from an agent to Teams or Copilot Studio.
- Parse activity types (message, typing, conversation update, invoke, event) to route and handle different communication patterns.
- Integrate a custom agent with the Microsoft 365 Agents SDK by using Activity types as the contract between your logic and the hosting layer.
- Validate agent payloads in a testing or integration layer without deploying a full hosting stack.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
This is a lightweight, actively maintained protocol library with no security vulnerabilities, permissive licensing, and a single well-known dependency. Install it if you are building agents for Microsoft 365 platforms or integrating with the Microsoft Agents SDK ecosystem. It is also safe to install as a transitive dependency of higher-level hosting packages.
Install
microsoft-agents-activity on PyPI
Before you install
Low install friction with a single pure-Python dependency (pydantic). Active maintenance with a release 15 days ago and regular updates since first release in July 2025.
Requires Python 3.10 or later.
License in practice
MIT license permits free use, modification, and distribution with minimal restrictions—suitable for commercial and open-source projects.
Quickstart
pip install microsoft-agents-activity
from microsoft_agents_activity import Activity, ActivityTypes
# Create a message activity
message = Activity(
type=ActivityTypes.message,
text="Hello from agent"
)Verify before relying
- Whether the Activity protocol implementation is fully compatible with all Microsoft 365 platforms mentioned or if some require additional hosting packages.
- Whether pydantic version constraints exist that might conflict with other dependencies in a larger project.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagepydantic |
| Maintenance | Actively maintained 15 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 937,638 / month, #4,689 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Operating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: microsoft_agents_activity-1.3.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “microsoft agents activity protocol”
- microsoft-agents-activityProvides core types and schemas implementing the Activity protocol…
- microsoft-agents-hosting-coreProvides the core hosting infrastructure for building conversational…
- microsoft-agents-hosting-fastapiProvides FastAPI integration for building and hosting conversational…
Give your agent the search over MCP, or paste the wish link into any chat.
More Application Frameworks packages
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Textual is a Python framework for building cross-platform user interfaces that run in the terminal or web browser using a modern, component-based API.
Install it if you're developing CLI tools, dashboards, or interactive terminal applications.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Build and connect to Model Context Protocol servers that expose tools, resources, and prompts to LLM applications over stdio, HTTP, or SSE transports.
Install it if you need to build or connect to servers.
Werkzeug is a WSGI utility library providing request/response objects, URL routing, an interactive debugger, HTTP utilities, and a development server for building web applications.
See also microsoft-agents-copilotstudio-client · microsoft-agents-hosting-core · microsoft-agents-hosting-aiohttp · microsoft-teams-cards · microsoft-agents-hosting-teams · microsoft-teams-apps · microsoft-teams-api · unique-toolkit · microsoft-agents-hosting-fastapi · agent-framework-copilotstudio