Copilot Studio

Das folgende Beispiel zeigt, wie Sie einen Agent mit Copilot Studio erstellen:

using System;
using Azure.Identity;
using Microsoft.Agents.AI;
using Microsoft.Agents.AI.CopilotStudio;

// Create a Copilot Studio agent using the IChatClient pattern
// Requires: dotnet add package Microsoft.Agents.AI.CopilotStudio --prerelease
var copilotClient = new CopilotStudioChatClient(
    environmentId: "<your-environment-id>",
    agentIdentifier: "<your-agent-id>",
    credential: new AzureCliCredential());

AIAgent agent = copilotClient.AsAIAgent(
    instructions: "You are a helpful enterprise assistant.");

Console.WriteLine(await agent.RunAsync("What are our company policies on remote work?"));

Tools

Copilot Studio Agents remote ausgeführt werden: Die Agentdefinition (Themen, Wissensquellen, generative Aktionen, Plug-Ins, MCP-Server) wird im Copilot Studio-Portal erstellt. Das Agent Framework Copilot Studio-Client ruft den veröffentlichten Agent auf und zeigt seine Antworten an – er führt not Verfügbarmachen von Agent Framework-Tooltypen (Funktionstools, Codedolmetscher, Dateisuche, gehostet/lokal MCP usw.) auf dem Client aus. Um die Funktionen des Agents zu erweitern, konfigurieren Sie diese Funktionen für den Copilot Studio Agent selbst.

Installation

pip install agent-framework-copilotstudio --pre

Konfiguration

Legen Sie die folgenden Umgebungsvariablen für die automatische Konfiguration fest:

COPILOTSTUDIOAGENT__ENVIRONMENTID="<your-environment-id>"
COPILOTSTUDIOAGENT__SCHEMANAME="<your-agent-schema-name>"
COPILOTSTUDIOAGENT__AGENTAPPID="<your-client-id>"
COPILOTSTUDIOAGENT__TENANTID="<your-tenant-id>"

Erstellen eines Copilot Studio-Agents

CopilotStudioAgent liest Verbindungseinstellungen automatisch aus Umgebungsvariablen:

import asyncio
from agent_framework.microsoft import CopilotStudioAgent

async def main():
    agent = CopilotStudioAgent()

    result = await agent.run("What are our company policies on remote work?")
    print(result)

asyncio.run(main())

Tools

CopilotStudioAgent ruft einen Copilot Studio Agent auf, der remote ausgeführt wird. Das Verhalten des Agents – Themen, Wissensquellen, generative Aktionen, Plug-Ins, MCP-Server – ist im Copilot Studio-Portal konfiguriert, nicht in Ihrem Python Code. Der Agent Framework-Client macht keine Agent Framework-Tooltypen (Funktionstools, Codedolmetscher, Dateisuche, gehostete/lokale MCP usw.) auf dem Client verfügbar. Um die Funktionen des Agents zu erweitern, konfigurieren Sie diese Funktionen für den Copilot Studio Agent selbst.

Streamen

async def streaming_example():
    agent = CopilotStudioAgent()

    print("Agent: ", end="", flush=True)
    async for chunk in agent.run("What is the largest city in France?", stream=True):
        if chunk.text:
            print(chunk.text, end="", flush=True)
    print()