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. يستدعي عميل إطار عمل العامل Copilot Studio العامل المنشور ويعرض استجاباته - لا يعرض أنواع أدوات إطار العامل (أدوات الوظيفة، ومترجم التعليمات البرمجية، والبحث في الملفات، وMCP المستضاف/المحلي، وما إلى ذلك) في العميل. لتوسيع قدرات العامل، قم بتكوين هذه الإمكانات على عامل Copilot Studio نفسه.

Note

يتوفر الدعم Python لوكلاء Copilot Studio من خلال الحزمةagent-framework-copilotstudio.

التثبيت

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

Note

سيتوفر الدعم لهذه الميزة قريبا. راجع مستودع Agent Framework Go للحصول على أحدث حالة.

الخطوات التالية

موفر مخصص