Copilot Studio

En el ejemplo siguiente se muestra cómo crear un agente mediante 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?"));

Herramientas

Copilot Studio agentes se ejecutan de forma remota: la definición del agente (temas, orígenes de conocimiento, acciones generativas, complementos, servidores MCP) se crea en el portal de Copilot Studio. El cliente de Copilot Studio Agent Framework invoca al agente publicado y expone sus respuestas: not expone los tipos de herramientas de Agent Framework (herramientas de función, intérprete de código, búsqueda de archivos, MCP hospedado/local, etc.) en el cliente. Para ampliar las funcionalidades del agente, configure esas funcionalidades en el propio agente de Copilot Studio.

Instalación

pip install agent-framework-copilotstudio --pre

Configuración

Establezca las siguientes variables de entorno para la configuración automática:

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

Creación de un agente de Copilot Studio

CopilotStudioAgent lee automáticamente la configuración de conexión de las variables de entorno:

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

Herramientas

CopilotStudioAgent invoca un agente de Copilot Studio que se ejecuta de forma remota. El comportamiento del agente (temas, orígenes de conocimiento, acciones generativas, complementos, servidores MCP) está configurado en el portal de Copilot Studio, no en el código de Python. El cliente de Agent Framework no expone los tipos de herramientas de Agent Framework (herramientas de función, intérprete de código, búsqueda de archivos, MCP hospedado o local, etc.) en el cliente. Para ampliar las funcionalidades del agente, configure esas funcionalidades en el propio agente de Copilot Studio.

Transmisión en línea

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