Copilot Studio

A integração do Copilot Studio permite-lhe usar agentes do Copilot Studio dentro do Agent Framework.

O exemplo seguinte mostra como criar um agente usando o 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

Os agentes do Copilot Studio funcionam remotamente: a definição do agente (tópicos, fontes de conhecimento, ações gerativas, plugins, servidores MCP) é criada no portal do Copilot Studio. O Agent Framework Copilot Studio cliente invoca o agente publicado e apresenta as suas respostas — not expõe os tipos de ferramentas do Agent Framework (ferramentas funcionais, interpretador de código, pesquisa de ficheiros, MCP alojado/local, etc.) no cliente. Para expandir as capacidades do agente, configure essas capacidades no próprio agente do Copilot Studio.

Observação

O suporte para Python para agentes do Copilot Studio está disponível através do agent-framework-copilotstudio pacote.

Instalação

pip install agent-framework-copilotstudio --pre

Configuração

Defina as seguintes variáveis de ambiente para configuração automática:

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

Crie um Agente do Copilot Studio

CopilotStudioAgent Lê automaticamente as definições de ligação das variáveis de 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 invoca um agente Copilot Studio que corre remotamente. O comportamento do agente — tópicos, fontes de conhecimento, ações generativas, plugins, servidores MCP — está configurado no portal do Copilot Studio, não no seu código Python. O cliente do Agent Framework não expõe os tipos de ferramentas do Agent Framework (ferramentas de função, interpretador de código, pesquisa de ficheiros, MCP alojado/local, etc.) no cliente. Para expandir as capacidades do agente, configure essas capacidades no próprio agente do Copilot Studio.

Serviço de 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()

Próximos passos

Fornecedor Personalizado