مشاركة عبر


بدء التشغيل السريع لمايكروسوفت فاوندري

في هذه البداية السريعة ستبدأ باستخدام النماذج والوكلاء في Foundry.

أنت سوف:

  • توليد استجابة من نموذج
  • إنشاء وكيل مع طلب معرف
  • أجر محادثة متعددة الأدوار مع الوكيل

المتطلبات المسبقه

حدد متغيرات البيئة واحصل على الكود

قم بتخزين نقطة نهاية مشروعك كمتغير بيئتي. قم أيضا بتعيين هذه القيم لاستخدامها في البرامج النصية الخاصة بك.

PROJECT_ENDPOINT=<endpoint copied from welcome screen>
AGENT_NAME="MyAgent"

اتبع أدناه أو احصل على الرمز:

سجل الدخول باستخدام أمر CLI az login للمصادقة قبل تشغيل سكريبتات Python.

التثبيت والمصادقة

تأكد من تثبيت النسخة الصحيحة من الحزم كما هو موضح هنا.

  1. تثبيت النسخة الحالية من azure-ai-projects. يستخدم هذا الإصدار واجهة برمجة تطبيقات مشاريع Foundry (الجديدة).

    pip install azure-ai-projects>=2.0.0
    
  2. سجل الدخول باستخدام أمر CLI az login للمصادقة قبل تشغيل سكريبتات Python.

نصيحة

يستخدم الكود Azure مشاريع الذكاء الاصطناعي 2.x وهو غير متوافق مع مشاريع الذكاء الاصطناعي Azure 1.x. انظر وثائق Foundry (الكلاسيكية) لإصدار مشاريع الذكاء الاصطناعي Azure 1.x.

الدردشة مع عارضة أزياء

التفاعل مع النموذج هو اللبنة الأساسية لتطبيقات الذكاء الاصطناعي. أرسل مدخلا وتلقي استجابة من النموذج:

from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient

# Format: "https://resource_name.ai.azure.com/api/projects/project_name"
PROJECT_ENDPOINT = "your_project_endpoint"

# Create project and openai clients to call Foundry API
project = AIProjectClient(
    endpoint=PROJECT_ENDPOINT,
    credential=DefaultAzureCredential(),
)
openai = project.get_openai_client()

# Run a responses API call
response = openai.responses.create(
    model="gpt-5-mini",  # supports all Foundry direct models
    input="What is the size of France in square miles?",
)
print(f"Response output: {response.output_text}")

بعد تشغيل الكود، ترى استجابة مولدة بواسطة نموذج في وحدة التحكم (على سبيل المثال، قصيدة قصيرة أو إجابة على طلبك). هذا يؤكد أن نقطة نهاية مشروعك، والمصادقة، ونشر النموذج تعمل بشكل صحيح.

نصيحة

يستخدم الكود Azure مشاريع الذكاء الاصطناعي 2.x وهو غير متوافق مع مشاريع الذكاء الاصطناعي Azure 1.x. انظر وثائق Foundry (الكلاسيكية) لإصدار مشاريع الذكاء الاصطناعي Azure 1.x.

إنشَاء مندوب

قم بإنشاء وكيل باستخدام النموذج المنشور.

يحدد الوكيل السلوك الأساسي. بمجرد إنشائها ، يضمن استجابات متسقة في تفاعلات المستخدم دون تكرار التعليمات في كل مرة. يمكنك تحديث الوكلاء أو حذفهم في أي وقت.

from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient
from azure.ai.projects.models import PromptAgentDefinition

# Format: "https://resource_name.ai.azure.com/api/projects/project_name"
PROJECT_ENDPOINT = "your_project_endpoint"
AGENT_NAME = "your_agent_name"

# Create project client to call Foundry API
project = AIProjectClient(
    endpoint=PROJECT_ENDPOINT,
    credential=DefaultAzureCredential(),
)

# Create an agent with a model and instructions
agent = project.agents.create_version(
    agent_name=AGENT_NAME,
    definition=PromptAgentDefinition(
        model="gpt-5-mini",  # supports all Foundry direct models"
        instructions="You are a helpful assistant that answers general questions",
    ),
)
print(f"Agent created (id: {agent.id}, name: {agent.name}, version: {agent.version})")

تؤكد النتائج أن الوكيل تم إنشاؤه. بالنسبة لتبويب SDK، ترى اسم الوكيل ومعرفه مطبوعين على وحدة التحكم.

نصيحة

يستخدم الكود Azure مشاريع الذكاء الاصطناعي 2.x وهو غير متوافق مع مشاريع الذكاء الاصطناعي Azure 1.x. انظر وثائق Foundry (الكلاسيكية) لإصدار مشاريع الذكاء الاصطناعي Azure 1.x.

الدردشة مع وكيل

استخدم العامل الذي تم إنشاؤه مسبقا باسم "MyAgent" للتفاعل عن طريق طرح سؤال ومتابعة ذات صلة. تحتفظ المحادثة بالتاريخ عبر هذه التفاعلات.

from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient

# Format: "https://resource_name.ai.azure.com/api/projects/project_name"
PROJECT_ENDPOINT = "your_project_endpoint"
AGENT_NAME = "your_agent_name"

# Create project and openai clients to call Foundry API
project = AIProjectClient(
    endpoint=PROJECT_ENDPOINT,
    credential=DefaultAzureCredential(),
)
openai = project.get_openai_client()

# Create a conversation for multi-turn chat
conversation = openai.conversations.create()

# Chat with the agent to answer questions
response = openai.responses.create(
    conversation=conversation.id,
    extra_body={"agent_reference": {"name": AGENT_NAME, "type": "agent_reference"}},
    input="What is the size of France in square miles?",
)
print(response.output_text)

# Ask a follow-up question in the same conversation
response = openai.responses.create(
    conversation=conversation.id,
    extra_body={"agent_reference": {"name": AGENT_NAME, "type": "agent_reference"}},
    input="And what is the capital city?",
)
print(response.output_text)

ترى ردود الوكيل على كلتا الطلبات. يظهر الرد اللاحق أن العميل يحافظ على سجل المحادثات عبر الأدوار.

نصيحة

يستخدم الكود Azure مشاريع الذكاء الاصطناعي 2.x وهو غير متوافق مع مشاريع الذكاء الاصطناعي Azure 1.x. انظر وثائق Foundry (الكلاسيكية) لإصدار مشاريع الذكاء الاصطناعي Azure 1.x.

تنظيف الموارد

إذا لم تعد بحاجة إلى أي من الموارد التي قمت بإنشائها، فاحذف مجموعة الموارد المقترنة بمشروعك.

  • في بوابة Azure، اختر مجموعة الموارد، ثم اختر Delete. تأكد من رغبتك في حذف مجموعة الموارد.

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