agent-framework-copilotstudio

What it is and what it does

This package provides a Copilot Studio agent for the Microsoft Agent Framework, allowing you to call published copilots from Copilot Studio environments within your application code. It wraps the authentication and client setup required to interact with copilots via the Power Platform API, using MSAL for token acquisition and aiohttp for async HTTP communication.

You configure it with Azure AD app registration credentials and Copilot Studio environment details (either via environment variables or explicit parameters), then call the agent's run() method with a query string to get results back. The package handles token management and connection pooling, including tuning of aiohttp's buffer size for large payloads from Copilot Studio activities.

Use it for:

• Embed published Copilot Studio copilots into backend services or applications that need to call them programmatically.
• Build multi-agent orchestration workflows where a Copilot Studio copilot is one participant in a larger agent framework.
• Integrate Copilot Studio copilots with async Python applications that require non-blocking I/O.
• Automate interactions with copilots in batch or event-driven scenarios without a UI.
• Route queries to Copilot Studio copilots from a custom agent application using the Agent Framework abstraction.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Integrates Microsoft Copilot Studio published copilots into applications via the Agent Framework, enabling async interaction with copilots through a unified agent interface.

Yes, if you need to call Copilot Studio copilots from Python code. The package is actively maintained, has low install friction, carries a permissive license, and integrates cleanly with the Agent Framework ecosystem. Note that it is in beta (1.0.0b260813); verify stability of its dependencies before production use.

Install

agent-framework-copilotstudio on PyPI

pip install agent-framework-copilotstudio

uv add agent-framework-copilotstudio

poetry add agent-framework-copilotstudio

Installing agent-framework-copilotstudio

Before you install

Low friction: pure Python wheel with four runtime dependencies (agent-framework-core, aiohttp, msal, microsoft-agents-copilotstudio-client). Active maintenance as of 2026-08-14 with no known vulnerabilities.

License in practice

MIT license (permissive); no restrictions on commercial or private use.

Quickstart

import asyncio
from agent_framework.microsoft import CopilotStudioAgent

async def main():
    agent = CopilotStudioAgent()
    result = await agent.run("What is the capital of France?")
    print(result)

asyncio.run(main())

Requires Azure AD app registration with Power Platform API permissions, a Copilot Studio environment with a published copilot, and environment variables set: COPILOTSTUDIOAGENT__ENVIRONMENTID, COPILOTSTUDIOAGENT__SCHEMANAME, COPILOTSTUDIOAGENT__AGENTAPPID, COPILOTSTUDIOAGENT__TENANTID.

Verify before relying

• Whether agent-framework-core and microsoft-agents-copilotstudio-client are stable or also in beta.
• Stability guarantees for the 1.0.0b260813 beta version before production deployment.

Package facts

Evidence: agent_framework_copilotstudio-1.0.0b260813-py3-none-any.whl

Tags

More Application Frameworks packages

Further reading