Copilot Studio

Интеграция Copilot Studio позволяет использовать агенты Copilot Studio в платформе агента.

В следующем примере показано, как создать агент с помощью 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?"));

Инструменты

Copilot Studio агенты выполняются удаленно: определение агента (разделы, источники знаний, созданные действия, подключаемые модули, серверы MCP) создается на портале Copilot Studio. Клиент Agent Framework Copilot Studio вызывает опубликованный агент и отображает ответы — он not предоставляет типы инструментов Agent Framework (средства функции, интерпретатор кода, поиск файлов, размещенный или локальный MCP) на клиенте. Чтобы расширить возможности агента, настройте эти возможности в самом агенте Copilot Studio.

Замечание

Поддержка Python для агентов Copilot Studio доступна через agent-framework-copilotstudio пакет.

Installation

pip install agent-framework-copilotstudio --pre

Конфигурация

Задайте следующие переменные среды для автоматической настройки:

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

Создание агента Copilot Studio

CopilotStudioAgent автоматически считывает параметры подключения из переменных среды:

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

Инструменты

CopilotStudioAgent вызывает агент Copilot Studio, который выполняется удаленно. Поведение агента — разделы, источники знаний, действия создания, подключаемые модули, серверы MCP — настраивается на портале Copilot Studio, а не в коде Python. Клиент Agent Framework не предоставляет типы инструментов Agent Framework (средства функций, интерпретатор кода, поиск файлов, размещенный или локальный MCP) на клиенте. Чтобы расширить возможности агента, настройте эти возможности в самом агенте Copilot Studio.

Стриминг

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

Дальнейшие шаги

Настраиваемый поставщик