Copilot Studio

Integracja programu Copilot Studio umożliwia korzystanie z agentów programu Copilot Studio w ramach struktury agentów.

W poniższym przykładzie pokazano, jak utworzyć agenta przy użyciu programu Copilot Studio:

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 agenci są uruchamiani zdalnie: definicja agenta (tematy, źródła wiedzy, akcje generowania, wtyczki, serwery MCP) jest autorem w portalu Copilot Studio. Klient programu Agent Framework Copilot Studio wywołuje opublikowanego agenta i wyświetla odpowiedzi — not uwidacznia typy narzędzi programu Agent Framework (narzędzia funkcji, interpreter kodu, wyszukiwanie plików, hostowane/lokalne mcP itp.) na kliencie. Aby rozszerzyć możliwości agenta, skonfiguruj te możliwości na samym agencie Copilot Studio.

Note

Obsługa języka Python dla agentów programu Copilot Studio jest dostępna za pośrednictwem agent-framework-copilotstudio pakietu.

Instalacja

pip install agent-framework-copilotstudio --pre

Configuration

Ustaw następujące zmienne środowiskowe dla konfiguracji automatycznej:

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

Tworzenie agenta Copilot Studio

CopilotStudioAgent automatycznie odczytuje ustawienia połączenia ze zmiennych środowiskowych:

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 wywołuje agenta Copilot Studio, który działa zdalnie. Zachowanie agenta — tematy, źródła wiedzy, akcje generowania, wtyczki, serwery MCP — jest konfigurowane w portalu Copilot Studio, a nie w kodzie Python. Klient programu Agent Framework nie uwidacznia typów narzędzi programu Agent Framework (narzędzia funkcji, interpreter kodu, wyszukiwanie plików, hostowane/lokalne MCP itp.) na kliencie. Aby rozszerzyć możliwości agenta, skonfiguruj te możliwości na samym agencie Copilot Studio.

Streaming

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()

Note

Obsługa tej funkcji w języku Go będzie dostępna wkrótce. Aktualny status znajdziesz w repozytorium Agent Framework dla Go.

Następne kroki

Dostawca niestandardowy