Copilot Studio

Copilot Studio tümleştirmesi, Agent Framework içinde Copilot Studio aracılarını kullanmanızı sağlar.

Aşağıdaki örnekte Copilot Studio kullanarak aracı oluşturma gösterilmektedir:

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

Araçlar

Copilot Studio aracılar uzaktan çalışır: aracı tanımı (konular, bilgi kaynakları, oluşturucu eylemler, eklentiler, MCP sunucuları) Copilot Studio portalında yazılır. Agent Framework Copilot Studio istemcisi yayımlanan aracıyı çağırır ve yanıtlarını ortaya çıkarır; not Aracı Çerçevesi araç türlerini (işlev araçları, kod yorumlayıcı, dosya arama, barındırılan/yerel MCP vb.) istemcide kullanıma sunar. Aracının özelliklerini genişletmek için bu özellikleri Copilot Studio aracısının kendisinde yapılandırın.

Uyarı

Paket aracılığıyla agent-framework-copilotstudio Copilot Studio aracıları için Python desteği sağlanır.

Installation

pip install agent-framework-copilotstudio --pre

Konfigürasyon

Otomatik yapılandırma için aşağıdaki ortam değişkenlerini ayarlayın:

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

Copilot Studio Aracısı oluşturma

CopilotStudioAgent ortam değişkenlerinden bağlantı ayarlarını otomatik olarak okur:

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

Araçlar

CopilotStudioAgent uzaktan çalışan bir Copilot Studio aracısı çağırır. Aracının davranışı (konular, bilgi kaynakları, üretken eylemler, eklentiler, MCP sunucuları) Python kodunuzda değil Copilot Studio portalında yapılandırılır. Agent Framework istemcisi, istemcide Agent Framework araç türlerini (işlev araçları, kod yorumlayıcı, dosya arama, barındırılan/yerel MCP vb. ) kullanıma sunmaz. Aracının özelliklerini genişletmek için bu özellikleri Copilot Studio aracısının kendisinde yapılandırın.

Yayın

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

Sonraki Adımlar

Özel Sağlayıcı