Mazungumzo ya Msingi na Azure AI Foundry - Mfano wa Mwisho kwa Mwisho

Mfano huu ni programu rahisi ya Spring Boot inayounganisha na mfano wa Azure AI Foundry kwa kutumia uthibitishaji bila funguo (Microsoft Entra ID) na kujaribu usanidi wako. Inatumia ChatClient ya Spring AI.

Jedwali la Yaliyomo

• Mahitaji
• Anza Haraka
• Jinsi Uthibitishaji Unavyofanya Kazi
• Kukimbia Programu
  • Kutumia Maven
  • Kutumia VS Code
  • Matokeo Yanayotarajiwa
• Marejeleo ya Usanidi
  • Mazingira ya Kazi
  • Usanidi wa Spring
• Kutatua Matatizo
  • Masuala ya Kawaida
  • Hali ya Kurekebisha Makosa
• Hatua Zifuatazo
• Rasilimali

Mahitaji

Kabla ya kukimbia mfano huu, hakikisha una:

• Rasilimali ya Azure AI Foundry yenye usambazaji wa gpt-4o-mini — itengeneze kwa kutumia azd up au kwa mkono kupitia mwongozo wa usanidi wa Azure AI Foundry
• Nafasi ya Cognitive Services OpenAI User kwenye rasilimali hiyo (vigezo vya Bicep vinakupa hii)
• Azure CLI (az), umeingia kwa az login
• Java 21+ na Maven 3.9+

Haina hitaji la funguo ya API — uthibitishaji ni bila funguo kupitia Microsoft Entra ID.

Anza Haraka

# 1. Elekea kwenye mradi
cd 02-SetupDevEnvironment/examples/basic-chat-azure

# 2. Ingia ili uthibitishaji usiotumia funguo upate tokeni
az login

# 3. Sanidi mwisho wa huduma
#    - Ikiwa uliendesha `azd up`, .env ilianzishwa kwa ajili yako (ruka hii).
#    - Vinginevyo nakili kiolezo na weka AZURE_OPENAI_ENDPOINT:
cp .env.example .env

# 4. Endesha programu
mvn spring-boot:run

Jinsi Uthibitishaji Unavyofanya Kazi

Mfano huu unathibitisha kwa kutumia Microsoft Entra ID — hakuna funguo ya API.

Wakati spring.ai.azure.openai.endpoint tu imewekwa (na hakuna api-key), Spring AI huunda mteja wa Azure OpenAI kwa kutumia DefaultAzureCredential. Kadi hiyo hujipata tokeni moja kwa moja kutoka kwa kikao chako cha az login kimoja kwa moja, au kutoka kwa kitambulisho kilichosimamiwa unapotumia Azure — hivyo msimbo huo unafanya kazi sehemu zote bila mabadiliko.

Kukimbia Programu

Kutumia Maven

mvn spring-boot:run

Kutumia VS Code

1. Fungua mradi katika VS Code
2. Bonyeza F5 au tumia jopo la "Run and Debug"
3. Chagua usanidi wa "Spring Boot-BasicChatApplication"

Kumbuka: Usanidi wa VS Code hujipakiza faili lako la .env moja kwa moja

Matokeo Yanayotarajiwa

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.

Marejeleo ya Usanidi

Mazingira ya Kazi

Kigezo	Maelezo	Kinahitajika	Mfano
AZURE_OPENAI_ENDPOINT	Anuani ya Foundry (Azure OpenAI)	Ndio	https://my-resource.openai.azure.com/
AZURE_OPENAI_DEPLOYMENT	Jina la usambazaji wa mfano wa mazungumzo	Hapana	gpt-4o-mini (chaguo-msingi)

Hakuna kigezo cha funguo ya API — uthibitishaji ni bila funguo (Microsoft Entra ID kupitia az login).

Usanidi wa Spring

Faili ya application.yml inaweka:

• Anuani ya Huduma: ${AZURE_OPENAI_ENDPOINT} - Kutoka kwa kigezo cha mazingira
• Usambazaji: ${AZURE_OPENAI_DEPLOYMENT:gpt-4o-mini} - Kutoka kwa kigezo cha mazingira na mbadala
• Uthibitishaji: bila funguo — hakuna api-key imewekwa, hivyo Spring AI inatumia DefaultAzureCredential
• Joto: 0.7 - Kudhibiti ubunifu (0.0 = uhakika, 1.0 = ubunifu)
• Hadi Tokeni: 500 - Urefu wa juu wa jibu

Kutatua Matatizo

Masuala ya Kawaida

Kosa: 401 / "PermissionDenied" / makosa ya tokeni

• Endesha az login — uthibitishaji bila funguo unahitaji kuingia kuweza kupata tokeni
• Hakikisha akaunti yako ina nafasi ya Cognitive Services OpenAI User kwenye rasilimali
• Ikiwa umeweka nafasi hiyo hivi karibuni, subiri dakika ili iweze kusambaa
• Thibitisha uko kwenye tena/usanidi sahihi (az account show)

Kosa: "Anuani ya huduma si halali" / makosa ya muunganisho

• Hakikisha AZURE_OPENAI_ENDPOINT ni URL kamili ya msingi (mfano, https://your-resource.openai.azure.com/)
• Angalia usawa wa mshale wa mwisho
• Thibitisha anuani hiyo inalingana na rasilimali uliyotengeneza (azd env get-values)

Kosa: "Usambazaji haukupatikana"

• Thibitisha AZURE_OPENAI_DEPLOYMENT ni jina la usambazaji linalopatikana Azure
• Angalia mfano umewekewa kazi na umeanzishwa
• Jina la usambazaji la chaguo-msingi ni gpt-4o-mini

VS Code: Mazingira ya kazi hayaendi kufululiza

• Hakikisha faili yako ya .env iko kwenye mzizi wa mradi (kando na pom.xml)
• Jaribu kuendesha mvn spring-boot:run kwenye terminal ya VS Code
• Angalia kwamba kuongeza la Java la VS Code limewekwa vizuri

Hali ya Kurekebisha Makosa

Ili kuwezesha kumbukumbu za kina, toa alama kutoka mistari hii katika application.yml:

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

Hatua Zifuatazo

Usanidi Umekamilika! Endelea na safari yako ya kujifunza:

Sura ya 3: Mbinu za Msingi za AI za Uumbaji

Rasilimali

• Nyaraka za Spring AI Azure OpenAI
• Uthibitishaji bila funguo na Microsoft Entra ID
• Portal ya Azure AI Foundry
• Nyaraka za Azure AI Foundry

---

Kionyozo: Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI Co-op Translator. Ingawa tunajitahidi kupata usahihi, tafadhali fahamu kwamba tafsiri za kiotomatiki zinaweza kuwa na makosa au upungufu wa usahihi. Hati ya asili katika lugha yake halisi inapaswa kuchukuliwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya kitaalamu inayofanywa na binadamu inapendekezwa. Hatutojibu kwa kuelewa vibaya au tafsiri potofu zinazotokea kutokana na matumizi ya tafsiri hii.