Copilot Studio

A Copilot Studio integrációja lehetővé teszi a Copilot Studio-ügynökök használatát az Ügynök keretrendszeren belül.

Az alábbi példa bemutatja, hogyan hozhat létre ügynököt a Copilot Studióval:

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?"));

Eszközök

Copilot Studio ügynökök távolról futnak: az ügynökdefiníció (témakörök, tudásbázisok, generatív műveletek, beépülő modulok, MCP-kiszolgálók) a Copilot Studio portálon találhatók. Az Ügynök-keretrendszer Copilot Studio ügyfél meghívja a közzétett ügynököt, és felfedi a válaszait – not teszi elérhetővé az Ügynök keretrendszer eszköztípusait (függvényeszközök, kódértelmező, fájlkeresés, üzemeltetett/helyi MCP stb.) az ügyfél számára. Az ügynök képességeinek kibővítéséhez konfigurálja ezeket a képességeket a Copilot Studio ügynökön.

Megjegyzés:

A Csomagon keresztül elérhető a Copilot Studio-ügynökök Python-támogatása agent-framework-copilotstudio .

Telepítés

pip install agent-framework-copilotstudio --pre

Configuration

Állítsa be a következő környezeti változókat az automatikus konfigurációhoz:

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

Copilot Studio-ügynök létrehozása

CopilotStudioAgent Automatikusan beolvassa a kapcsolati beállításokat a környezeti változókból:

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

Eszközök

CopilotStudioAgent távoli futtatású Copilot Studio-ügynököt hív meg. Az ügynök viselkedése – témakörök, tudásbázisok, generatív műveletek, beépülő modulok, MCP-kiszolgálók – a Copilot Studio portálon van konfigurálva, nem a Python kódban. Az Agent Framework-ügyfél nem teszi elérhetővé az Ügynök-keretrendszer eszköztípusokat (függvényeszközök, kódértelmező, fájlkeresés, üzemeltetett/helyi MCP stb.) az ügyfélnél. Az ügynök képességeinek kibővítéséhez konfigurálja ezeket a képességeket a Copilot Studio ügynökön.

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

Megjegyzés:

A funkció Go-támogatása hamarosan érkezik. A legújabb állapotot az Agent Framework Go-adattárában tekinthet meg.

Következő lépések

Egyéni szolgáltató