Azure AI Foundry ile Temel Sohbet - Uçtan Uca Örnek

July 2, 2026 · View on GitHub

Bu örnek, Azure AI Foundry modeline anahtarsız kimlik doğrulama (Microsoft Entra ID) kullanarak bağlanan ve kurulumu test eden basit bir Spring Boot uygulamasıdır. Spring AI'nin ChatClient'ını kullanır.

İçindekiler

Ön Koşullar

Bu örneği çalıştırmadan önce şunlara sahip olduğunuzdan emin olun:

  • gpt-4o-mini dağıtımı bulunan bir Azure AI Foundry kaynağı — azd up ile veya manuel olarak Azure AI Foundry kurulum kılavuzu üzerinden temin edin
  • O kaynakta Cognitive Services OpenAI User rolü (Bicep şablonları bunu sizin için atar)
  • Azure CLI (az), az login ile oturum açılmış
  • Java 21+ ve Maven 3.9+

API anahtarı gerekmez — kimlik doğrulama Microsoft Entra ID üzerinden anahtarsızdır.

Hızlı Başlangıç

# 1. Projeye gidin
cd 02-SetupDevEnvironment/examples/basic-chat-azure

# 2. Anahtarsız kimlik doğrulaması bir token alabilmesi için giriş yapın
az login

# 3. Uç noktayı yapılandırın
#    - Eğer `azd up` komutunu çalıştırdıysanız, .env dosyası sizin için yazıldı (bunu atlayın).
#    - Aksi takdirde şablonu kopyalayın ve AZURE_OPENAI_ENDPOINT ayarlayın:
cp .env.example .env

# 4. Uygulamayı çalıştırın
mvn spring-boot:run

Kimlik Doğrulama Nasıl Çalışır

Bu örnek, Microsoft Entra ID ile kimlik doğrulaması yapar — API anahtarı yoktur.

Sadece spring.ai.azure.openai.endpoint ayarlandığında (api-key olmadan) Spring AI, Azure OpenAI istemcisini DefaultAzureCredential ile oluşturur. Bu kimlik bilgisi otomatik olarak yerelde az login oturumunuzdan veya Azure'da çalışan yönetilen kimlikten bir belirteç bulur — böylece aynı kod her iki yerde de değişiklik yapmadan çalışır.

Uygulamayı Çalıştırma

Maven ile

mvn spring-boot:run

VS Code ile

  1. Projeyi VS Code'da açın
  2. F5 tuşuna basın veya "Çalıştır ve Hata Ayıkla" panelini kullanın
  3. "Spring Boot-BasicChatApplication" yapılandırmasını seçin

Not: VS Code yapılandırması .env dosyanızı otomatik yükler

Beklenen Çıktı

Starting Basic Chat with Azure OpenAI...
Environment variables loaded successfully
Connecting to Azure OpenAI...
Sending prompt: What is AI in a short sentence? Max 100 words.

AI Response:
================
AI, or Artificial Intelligence, is the simulation of human intelligence in machines programmed to think and learn like humans.
================

Success! Azure OpenAI connection is working correctly.

Yapılandırma Referansı

Ortam Değişkenleri

DeğişkenAçıklamaGerekliÖrnek
AZURE_OPENAI_ENDPOINTFoundry (Azure OpenAI) uç nokta URL'siEvethttps://my-resource.openai.azure.com/
AZURE_OPENAI_DEPLOYMENTSohbet modeli dağıtım adıHayırgpt-4o-mini (varsayılan)

API anahtarı değişkeni yoktur — kimlik doğrulama anahtarsızdır (Microsoft Entra ID üzerinden az login).

Spring Yapılandırması

application.yml dosyası yapılandırır:

  • Uç Nokta: ${AZURE_OPENAI_ENDPOINT} - Ortam değişkeninden
  • Dağıtım: ${AZURE_OPENAI_DEPLOYMENT:gpt-4o-mini} - Ortam değişkeninden, yedekli
  • Kimlik Doğrulama: Anahtarsız — api-key ayarlanmadı, bu yüzden Spring AI DefaultAzureCredential kullanır
  • Sıcaklık: 0.7 - Yaratıcılığı kontrol eder (0.0 = belirleyici, 1.0 = yaratıcı)
  • Maksimum Token: 500 - Maksimum yanıt uzunluğu

Sorun Giderme

Yaygın Sorunlar

Hata: 401 / "PermissionDenied" / belirteç hataları
  • az login komutunu çalıştırın — anahtarsız kimlik doğrulama bir belirteç almak için aktif oturum gerektirir
  • Hesabınızda kaynağa yönelik Cognitive Services OpenAI User rolü olduğundan emin olun
  • Rolü yeni atadıysanız, yayılması için birkaç dakika bekleyin
  • Doğru kiracı/abone altında olduğunuzu doğrulayın (az account show)
Hata: "Uç nokta geçerli değil" / bağlantı hataları
  • AZURE_OPENAI_ENDPOINT değişkeninin tam temel URL (örneğin https://your-resource.openai.azure.com/) olduğundan emin olun
  • Sonundaki eğik çizgi tutarlılığını kontrol edin
  • Uç noktanın sağladığınız kaynakla eşleştiğini doğrulayın (azd env get-values)
Hata: "Dağıtım bulunamadı"
  • AZURE_OPENAI_DEPLOYMENT değişkeninin Azure’daki geçerli bir dağıtım adıyla eşleştiğini kontrol edin
  • Modelin başarıyla dağıtıldığını ve aktif olduğunu doğrulayın
  • Varsayılan dağıtım adı gpt-4o-mini’dir
VS Code: Ortam değişkenleri yüklenmiyor
  • .env dosyanızın proje kök dizininde (pom.xml ile aynı seviyede) olduğundan emin olun
  • VS Code entegrasyon terminalinde mvn spring-boot:run komutunu deneyin
  • VS Code Java eklentisinin doğru yüklendiğini kontrol edin

Hata Ayıklama Modu

Ayrıntılı günlükleme için application.yml içindeki bu satırların yorumunu kaldırın:

logging:
  level:
    org.springframework.ai: DEBUG
    com.azure: DEBUG

Sonraki Adımlar

Kurulum Tamamlandı! Öğrenme yolculuğunuza devam edin:

3. Bölüm: Temel Üretken AI Teknikleri

Kaynaklar

Feragatname: Bu belge, AI çeviri hizmeti Co-op Translator kullanılarak çevrilmiştir. Doğruluk için çaba sarf etsek de, otomatik çevirilerin hata veya yanlışlık içerebileceğini lütfen unutmayınız. Orijinal belge, kendi dilinde yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilir. Bu çevirinin kullanımı sonucu ortaya çıkabilecek yanlış anlamalardan veya yanlış yorumlamalardan sorumlu değiliz.