Aracılığıyla paylaş


Microsoft Foundry hızlı başlangıç

Bu hızlı başlangıçta Foundry'de modelleri ve aracıları kullanmaya başlarsınız.

Şunu yapacaksınız:

  • Modelden yanıt oluşturma
  • Tanımlı bir komut ile bir aracıyı oluştur
  • Bir temsilciyle çok tur konuşma yapın

Önkoşullar

  • Microsoft Foundry'de dağıtılan bir model. Modeliniz yoksa, ilk hızlı başlangıç: Microsoft Foundry kaynaklarını ayarlama işlemini tamamlayın.
  • Prepare your development environment bölümünde açıklandığı gibi gerekli dil çalışma zamanları, genel araçlar ve Visual Studio Code uzantıları.

Ortam değişkenlerini ayarlama ve kodu alma

Proje uç noktanızı ortam değişkeni olarak depolayın. Ayrıca bu değerleri betiklerinizde kullanmak üzere ayarlayın.

- Python and JavaScript

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

- C# and Java

ProjectEndpoint = <endpoint copied from welcome screen>
AgentName = "MyAgent"
  • Python
  • C#
  • TypeScript
  • Java
  • REST API
  • Dökümhane portalı

Aşağıdaki adımları izleyin veya kodu alın:

Kodu alma

Python betiklerinizi çalıştırmadan önce kimlik doğrulaması yapmak için CLI az login komutunu kullanarak oturum açın.

Yükleme ve kimlik doğrulaması

Burada gösterildiği gibi paketlerin doğru sürümünü yüklediğinizden emin olun.

  • Python
  • C#
  • TypeScript
  • Java
  • REST API
  • Dökümhane portalı
  1. Geçerli sürümü yükleyin. Bu sürüm , Foundry projeleri (yeni) API'sini kullanır.

    pip install azure-ai-projects>=2.0.0
    
  2. Python betiklerinizi çalıştırmadan önce kimlik doğrulaması yapmak için CLI az login komutunu kullanarak oturum açın.

Tavsiye

Kod, Azure AI Projeleri 2.x kullanır ve Azure AI Projeleri 1.x ile uyumlu değildir. Azure AI Projects 1.x sürümü için Foundry (klasik) belgelerini görüntüleyin.

Modelle sohbet etme

Modelle etkileşim kurmak, yapay zeka uygulamalarının temel yapı taşıdır. Giriş gönderin ve modelden bir yanıt alın:

  • Python
  • C#
  • TypeScript
  • Java
  • REST API
  • Dökümhane portalı
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}")

Kodu çalıştırdıktan sonra konsolda model tarafından oluşturulan bir yanıt görürsünüz (örneğin, kısa bir şiir veya isteminize yanıt). Bu, proje uç noktanızın, kimlik doğrulamanızın ve model dağıtımınızın düzgün çalıştığını onaylar.

Tavsiye

Kod, Azure AI Projeleri 2.x kullanır ve Azure AI Projeleri 1.x ile uyumlu değildir. Azure AI Projects 1.x sürümü için Foundry (klasik) belgelerini görüntüleyin.

Bir aracı oluştur

Dağıtılan modelinizi kullanarak bir aracı oluşturun.

Ajan temel davranışı tanımlar. Oluşturulduktan sonra, her seferinde yönergeleri yinelemeden kullanıcı etkileşimlerinde tutarlı yanıtlar sağlar. Aracıları istediğiniz zaman güncelleştirebilir veya silebilirsiniz.

  • Python
  • C#
  • TypeScript
  • Java
  • REST API
  • Dökümhane portalı
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})")

Çıktı, ajanının başarıyla oluşturulduğunu doğrular. SDK sekmeleri için, konsola yazdırılan aracı adını ve kimliğini görürsünüz.

Tavsiye

Kod, Azure AI Projeleri 2.x kullanır ve Azure AI Projeleri 1.x ile uyumlu değildir. Azure AI Projects 1.x sürümü için Foundry (klasik) belgelerini görüntüleyin.

Temsilciyle sohbet edin

Daha önce oluşturulan "MyAgent" adlı aracıyı kullanarak bir soru ve ilgili bir izleme sorarak etkileşime geçin. Konuşma, bu etkileşimler arasında geçmişi korur.

  • Python
  • C#
  • TypeScript
  • Java
  • REST API
  • Dökümhane portalı
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=FOUNDRY_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": FOUNDRY_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": FOUNDRY_AGENT_NAME, "type": "agent_reference"}},
    input="And what is the capital city?",
)
print(response.output_text)

Ajanın her iki isteğe verdiği yanıtları görüyorsunuz. İzleme yanıtı, aracının konuşma geçmişini sırayla koruduğunu gösterir.

Tavsiye

Kod, Azure AI Projeleri 2.x kullanır ve Azure AI Projeleri 1.x ile uyumlu değildir. Azure AI Projects 1.x sürümü için Foundry (klasik) belgelerini görüntüleyin.

Kaynakları temizle

Oluşturduğunuz kaynaklardan herhangi birine artık ihtiyacınız yoksa projenizle ilişkili kaynak grubunu silin.

  • Azure portalında kaynak grubunu seçin ve ardından Delete öğesini seçin. Kaynak grubunu silmek istediğinizi onaylayın.

Sonraki adım

Prototip oluşturma fikri - Kurumsal aracı oluşturma ve değerlendirme