Microsoft Foundry السريع

في هذه البداية السريعة ستبدأ باستخدام النماذج والوكلاء في 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. تأكد أنك تريد حذف مجموعة الموارد.

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