Copilot Studio

Integrace aplikace Copilot Studio umožňuje používat agenty Copilot Studio v rámci rozhraní Agent Framework.

Následující příklad ukazuje, jak vytvořit agenta pomocí Copilot Studia:

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 agenti běží vzdáleně: definice agenta (témata, zdroje znalostí, generování akcí, moduly plug-in, servery MCP) se vytváří na portálu Copilot Studio. Klient agenta Copilot Studio vyvolá publikovaný agent a zobrazí jeho odpovědi – not vystavit typy nástrojů Agent Framework (nástroje funkcí, interpret kódu, vyhledávání souborů, hostovaný/místní MCP atd.) v klientovi. Pokud chcete rozšířit možnosti agenta, nakonfigurujte tyto funkce v samotném agentovi Copilot Studio.

Note

Podpora Pythonu pro agenty Copilot Studio je dostupná prostřednictvím agent-framework-copilotstudio balíčku.

Instalace

pip install agent-framework-copilotstudio --pre

Configuration

Pro automatickou konfiguraci nastavte následující proměnné prostředí:

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

Vytvoření agenta Copilot Studio

CopilotStudioAgent Automaticky čte nastavení připojení z proměnných prostředí:

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 vyvolá agenta Copilot Studio, který běží vzdáleně. Chování agenta – témata, zdroje znalostí, generování akcí, moduly plug-in, servery MCP – se konfiguruje na portálu Copilot Studio, ne ve vašem Python kódu. Klient Agent Framework nezpřístupňuje typy nástrojů Agent Framework (nástroje funkcí, interpret kódu, vyhledávání souborů, hostované nebo místní MCP atd.) v klientovi. Pokud chcete rozšířit možnosti agenta, nakonfigurujte tyto funkce v samotném agentovi 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

Podpora této funkce v Go již brzy. Nejnovější stav najdete v úložišti Agent Framework Go .

Další kroky

Vlastní zprostředkovatel