Copilot Studio

L'integrazione di Copilot Studio consente di usare gli agenti di Copilot Studio all'interno di Agent Framework.

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.

Annotazioni

Il supporto python per gli agenti di Copilot Studio è disponibile tramite il agent-framework-copilotstudio pacchetto .

Installation

pip install agent-framework-copilotstudio --pre

Configuration

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

Per la configurazione esplicita, usare agent_identifier:

agent = CopilotStudioAgent(
    environment_id="<your-environment-id>",
    agent_identifier="<your-agent-schema-name>",
    client_id="<your-client-id>",
    tenant_id="<your-tenant-id>",
)

Il nome precedente bot_identifier non è supportato. Non passare instructions a CopilotStudioAgent; creare istruzioni, argomenti, origini delle conoscenze e azioni in Copilot Studio.

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.

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

Annotazioni

Il supporto per questa funzionalità sarà presto disponibile. Vedere il repository di Agent Framework Go per lo stato più aggiornato.

Passaggi successivi

Provider personalizzato