microsoft-agents-copilotstudio-client

What it is and what it does

This package is a Python client for connecting to and interacting with AI agents built in Microsoft Copilot Studio. It bypasses traditional chat channels and provides a direct connection to agents, making it suitable for integrating conversational AI into custom applications, building specialized UIs, or enabling agent-to-agent communication flows. The library is part of the broader Microsoft 365 Agents SDK and handles authentication, connection configuration, and message exchange with Copilot Studio agents.

The client supports multiple connection modes: environment-based configuration using credentials and agent identifiers, or simplified DirectConnect URL mode for streamlined setup. It includes optional diagnostic logging for HTTP communication inspection and experimental endpoint support for pre-release features. The package requires Python 3.10 or later and depends on microsoft-agents-hosting-core for core hosting functionality.

Use it for:

• Embed Copilot Studio agents into custom Python web applications or desktop tools without using Teams or web chat interfaces
• Build agent-to-agent communication flows where one Python service orchestrates interactions with multiple Copilot Studio agents
• Create specialized user interfaces that interact with Copilot Studio agents while maintaining full control over conversation state and presentation
• Integrate enterprise AI agents into backend services or data processing pipelines for automated decision-making or content generation
• Enable diagnostic inspection of agent communication for debugging, monitoring, or compliance logging

Worth the install?

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

Connects Python applications to AI agents created in Microsoft Copilot Studio, enabling direct interaction with agents without traditional chat channel intermediaries.

Yes. The package is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and provides a straightforward way to integrate Copilot Studio agents into Python applications. Install it if you need direct programmatic access to Copilot Studio agents outside traditional chat channels. The single runtime dependency and low install friction make adoption low-risk.

Install

microsoft-agents-copilotstudio-client on PyPI

pip install microsoft-agents-copilotstudio-client

uv add microsoft-agents-copilotstudio-client

poetry add microsoft-agents-copilotstudio-client

Installing microsoft-agents-copilotstudio-client

Before you install

Active maintenance with recent release (15 days old), supports Python 3.10–3.14, and depends on a single runtime package (microsoft-agents-hosting-core) with low install friction.

License in practice

MIT license permits commercial and private use, modification, and distribution with minimal restrictions—suitable for most enterprise and open-source projects.

Quickstart

pip install microsoft-agents-copilotstudio-client

from microsoft_agents_copilotstudio_client import CopilotClient, ConnectionSettings

settings = ConnectionSettings(
    environment_id="your-env-id",
    agent_identifier="your-agent-id"
)
client = CopilotClient(settings, token)

Requires Python 3.10 or later; authentication token and valid Copilot Studio environment/agent identifiers must be obtained separately (typically via MSAL or Entra ID).

Verify before relying

• Whether the package requires Azure/Microsoft 365 credentials or service subscriptions beyond what the documentation shows
• Performance characteristics and latency expectations for agent communication at scale
• Backward compatibility guarantees across minor versions

Package facts

Evidence: microsoft_agents_copilotstudio_client-1.3.0-py3-none-any.whl

Tags

More Application Frameworks packages

Further reading