Skip to content

Python: Introduce the Copilot Studio Agent #11851

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 18 commits into from
May 6, 2025

Conversation

moonbox3
Copy link
Contributor

@moonbox3 moonbox3 commented May 2, 2025

Motivation and Context

Semantic Kernel Python currently has a demo showing how to interact with a Copilot Studio Agent; however, that uses the DirectLine API. This PR introduces a Semantic Kernel CoilotStudioAgent that leverages the team's new microsoft.agents.copilotstudio.client. One must first have a Copilot Studio Agent created via the portal; and once ready, they can reference it with the proper App Registration and Agent metadata. Interacting with the Agent can leverage Microsoft Copilot Studio's knowledge sources and internal tools.

Description

Add support for the CopilotStudioAgent.

  • Provide getting started samples
  • Introduces a detailed README on what is required for setup and interacting with the agent.
  • The current version of the CopilotStudioAgent does not support calling another Copilot Studio Agent via a skill.
  • Authentication for the agent is limited to interactive right now. Once service-to-service auth is support via the client, we will add this into SK.
  • Closes Python: create a Copilot Studio Agent #11607

Contribution Checklist

@moonbox3 moonbox3 added python Pull requests for the Python Semantic Kernel agents labels May 2, 2025
@moonbox3 moonbox3 self-assigned this May 2, 2025
@moonbox3 moonbox3 requested a review from a team as a code owner May 2, 2025 05:42
@markwallace-microsoft
Copy link
Member

markwallace-microsoft commented May 2, 2025

Python Unit Test Overview

Tests Skipped Failures Errors Time
3479 6 💤 0 ❌ 0 🔥 1m 45s ⏱️

Copy link
Member

@eavanvalkenburg eavanvalkenburg left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Love it!

@moonbox3 moonbox3 enabled auto-merge May 6, 2025 10:08
@moonbox3 moonbox3 added this pull request to the merge queue May 6, 2025
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks May 6, 2025
@eavanvalkenburg eavanvalkenburg added this pull request to the merge queue May 6, 2025
Merged via the queue into microsoft:main with commit 1a187b0 May 6, 2025
28 checks passed
@github-project-automation github-project-automation bot moved this to Sprint: Done in Semantic Kernel May 6, 2025
glorious-beard pushed a commit to glorious-beard/semantic-kernel that referenced this pull request May 6, 2025
### Motivation and Context

Semantic Kernel Python currently has a demo showing how to interact with
a Copilot Studio Agent; however, that uses the `DirectLine API`. This PR
introduces a Semantic Kernel `CoilotStudioAgent` that leverages the
team's new `microsoft.agents.copilotstudio.client`. One must first have
a Copilot Studio Agent created via the portal; and once ready, they can
reference it with the proper App Registration and Agent metadata.
Interacting with the Agent can leverage Microsoft Copilot Studio's
knowledge sources and internal tools.

<!-- Thank you for your contribution to the semantic-kernel repo!
Please help reviewers and future users, providing the following
information:
  1. Why is this change required?
  2. What problem does it solve?
  3. What scenario does it contribute to?
  4. If it fixes an open issue, please link to the issue here.
-->

### Description

Add support for the `CopilotStudioAgent`. 
- Provide getting started samples
- Introduces a detailed README on what is required for setup and
interacting with the agent.
- The current version of the `CopilotStudioAgent` does not support
calling another Copilot Studio Agent via a skill.
- Authentication for the agent is limited to interactive right now. Once
service-to-service auth is support via the client, we will add this into
SK.
- Closes microsoft#11607

<!-- Describe your changes, the overall approach, the underlying design.
These notes will help understanding how your code works. Thanks! -->

### Contribution Checklist

<!-- Before submitting this PR, please make sure: -->

- [X] The code builds clean without any errors or warnings
- [X] The PR follows the [SK Contribution
Guidelines](https://github.com/microsoft/semantic-kernel/blob/main/CONTRIBUTING.md)
and the [pre-submission formatting
script](https://github.com/microsoft/semantic-kernel/blob/main/CONTRIBUTING.md#development-scripts)
raises no violations
- [X] All unit tests pass, and I have added new tests where possible
- [X] I didn't break anyone 😄
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
agents documentation python Pull requests for the Python Semantic Kernel
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

Python: create a Copilot Studio Agent
4 participants