Copilot Studio

L'esempio seguente illustra come creare un agente usando 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 agenti vengono eseguiti in remoto: la definizione dell'agente (argomenti, origini delle informazioni, azioni generative, plug-in, server MCP) viene creata nel portale di Copilot Studio. Il client di Copilot Studio Di Agent Framework richiama l'agente pubblicato e ne espone le risposte, not esporre i tipi di strumento di Agent Framework (strumenti di funzione, interprete del codice, ricerca di file, MCP ospitato/locale e così via) nel client. Per estendere le funzionalità dell'agente, configurare tali funzionalità nell'agente Copilot Studio stesso.

Installazione

pip install agent-framework-copilotstudio --pre

Configurazione

Impostare le variabili di ambiente seguenti per la configurazione automatica:

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

Creare un agente di Copilot Studio

CopilotStudioAgent legge automaticamente le impostazioni di connessione dalle variabili di ambiente:

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 richiama un agente Copilot Studio eseguito in remoto. Il comportamento dell'agente, ad esempio argomenti, origini delle conoscenze, azioni generative, plug-in, server MCP, è configurato nel portale di Copilot Studio, non nel codice Python. Il client di Agent Framework non espone i tipi di strumento di Agent Framework (strumenti per le funzioni, interprete del codice, ricerca di file, MCP ospitato/locale e così via) nel client. Per estendere le funzionalità dell'agente, configurare tali funzionalità nell'agente Copilot Studio stesso.

Trasmissione in diretta

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