ಅಜೂರ್ AI ಫೌಂಡ್ರಿಯಿಂದ ಮೂಲ ಚಾಟ್ - ಸಂಪೂರ್ಣ ಉದಾಹರಣೆ

ಈ ಉದಾಹರಣೆ ಸರಳ ಸ್ಪ್ರಿಂಗ್ ಬೂಟ್ ಅಪ್ಲಿಕೈಶನ್ ಆಗಿದ್ದು, ಅಜೂರ್ AI ಫೌಂಡ್ರಿ ಮಾದರಿಯನ್ನು ಕೀಲೆಸ್ ಪ್ರಮಾಣೀಕರಣ (Microsoft Entra ID) ಬಳಸಿ ಸಂಪರ್ಕಿಸಿ ನಿಮ್ಮ ಸೆಟ್ ಅಪ್‌ನ್ನು ಪರೀಕ್ಷಿಸುತ್ತದೆ. ಇದು Spring AIರ ChatClient ಅನ್ನು ಬಳಸುತ್ತದೆ.

ವಿಷಯಗಳ ಪಟ್ಟಿಕೆ

• ಮೊದಲು ಬೇಕಾಗಿರುವವು
• ತ್ವರಿತ ಪ್ರಾರಂಭ
• ಪ್ರಮಾಣೀಕರಣ ಹೇಗೆ ಕೆಲಸ ಮಾಡುತ್ತದೆ
• ಅಪ್ಲಿಕೈಶನ್ ಚಾಲನೆ
  • ಮೇವನ್ ಬಳಸಿ
  • VS ಕೋಡ್ ಬಳಸಿ
  • ನಿರೀಕ್ಷಿತ ಫಲಿತಾಂಶ
• ರಚನಾ ಸೂಚನೆ
  • ಪರಿಸರ ಚರಗಳು
  • ಸ್ಪ್ರಿಂಗ್ ರಚನೆ
• ಸರಿದೂಗಿಸುವಿಕೆ
  • ಸಾಮಾನ್ಯ ಸಮಸ್ಯೆಗಳು
  • ಡೀಬಗ್ಗಿಂಗ್ ಮೋಡ್
• ಮುಂದಿನ ಹಂತಗಳು
• ಸಂಪನ್ಮೂಲಗಳು

ಮೊದಲೇ ಬೇಕಾಗಿರುವವು

ಈ ಉದಾಹರಣೆ ನಿರ್ವಹಿಸುವ ಮೊದಲು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ:

• gpt-4o-mini ನಿಯೋಜನೆ ಹೊಂದಿರುವ ಅಜೂರ್ AI ಫೌಂಡ್ರಿ ಸಂಪನ್ಮೂಲ — ಅದನ್ನು azd up ಅಥವಾ ಕೈಯಿಂದ ಅಜೂರ್ AI ಫೌಂಡ್ರಿ ಸೆಟ್‌ಅಪ್ ಮಾರ್ಗದರ್ಶಿ ಮೂಲಕ ಒದಗಿಸಿ
• ಆ ಸಂಪನ್ಮೂಲದ ಮೇಲೆ ಕಾಗ್ನಿಟಿವ್ ಸರ್ವೀಸಸ್ ಓಪನ್‌ಎಐ ಬಳಕೆದಾರ ಪಾತ್ರ (ಬೈಸ್ಪ್ ಟೆಂಪ್ಲೇಟುಗಳು ಇದನ್ನು ನಿಮ್ಮಿಗಾಗಿ ನಿಯೋಜಿಸುತ್ತವೆ)
• ಅಜೂರ್ CLI (az), az login ಮೂಲಕ ಸೈನ್ ಇನ್ ಆಗಿರುವುದು
• ಜಾವಾ 21+ ಮತ್ತು ಮೇವನ್ 3.9+

ಯಾವುದೇ API ಕೀ ಅಗತ್ಯವಿಲ್ಲ — ಪ್ರಮಾಣೀಕರಣವು Microsoft Entra ID ಮೂಲಕ ಕೀಲೆಸ್ ಆಗಿದೆ.

ತ್ವರಿತ ಪ್ರಾರಂಭ

# 1. ಯೋಜನೆಗೆ ದಿಕ್ಕುಮಾಡಿ
cd 02-SetupDevEnvironment/examples/basic-chat-azure

# 2. ಟೋಕನ್ ಪಡೆಯಲು ಕೀಲಿಯಿಲ್ಲದ ಪರಿಶೀಲನೆಗೆ ಸೈನ್ ಇನ್ ಮಾಡಿ
az login

# 3. ಎಂಡ್‌ಪಾಯಿಂಟ್ ಅನ್ನು ಹೊಂದಿಸಿ
#    - ನೀವು `azd up` ಓಡಿಸಿದರೆ, .env ನಿಮಗಾಗಿ ಬರೆಯಲ್ಪಟ್ಟಿದೆ (ಇದನ್ನು ಬಿಟ್ಟಿಮಾಡಿ).
#    - ಇಲ್ಲದಿದ್ದರೆ ಟೆಂಪ್ಲೇಟ್ ಅನ್ನು ನಕಲಿಸಿ ಮತ್ತು AZURE_OPENAI_ENDPOINT ಅನ್ನು ಹೊಂದಿಸಿ:
cp .env.example .env

# 4. ಅಪ್ಲಿಕೇಶನ್ ಅನ್ನು ಚಾಲನೆ ಮಾಡು
mvn spring-boot:run

ಪ್ರಮಾಣೀಕರಣ ಹೇಗೆ ಕೆಲಸ ಮಾಡುತ್ತದೆ

ಈ ಉದಾಹರಣೆ Microsoft Entra ID ಮೂಲಕ ಪ್ರಮಾಣೀಕರಿಸುತ್ತದೆ — ಯಾವುದೇ API ಕೀ ಇಲ್ಲ.

ಕೆवल spring.ai.azure.openai.endpoint ಸೆಟ್ ಮಾಡಿರುವಾಗ (ಮತ್ತು api-key ಇಲ್ಲದೆ), Spring AI ಅಜೂರ್ ಓಪನ್‌ಎಐ ಕ್ಲೈಯಂಟ್ ಅನ್ನು DefaultAzureCredential ಬಳಸಿ ರಚಿಸುತ್ತದೆ. ಆ ಕ್ರೆಡೆನ್ಷಿಯಲ್ ನಿಮ್ಮ az login ಸೆಷನ್‌ನಿಂದ ಟೋಕನ್ ಅನ್ನು ಸ್ಥಳೀಯವಾಗಿ ಅಥವಾ ಅಜೂರಿನಲ್ಲಿ ರನ್ ಮಾಡುವಾಗ ನಿರ್ವಹಿತ ಐಡೆಂಟಿಟಿಯಿಂದ ಕಂಡುಹಿಡಿಯುತ್ತದೆ — ಹೀಗಾಗಿ ಅದೇ ಕೋಡ್ ಯಾವುದೇ ಬದಲಾವಣೆ ಇಲ್ಲದೆ ಎರಡೂ ಜಾಗಗಳಲ್ಲಿ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತದೆ.

ಅಪ್ಲಿಕೈಶನ್ ಚಾಲನೆ

ಮೇವನ್ ಬಳಸಿ

mvn spring-boot:run

VS ಕೋಡ್ ಬಳಸಿ

1. ಪ್ರಾಜೆಕ್ಟ್ ಅನ್ನು VS ಕೋಡ್‌ನಲ್ಲಿ ತೆರೆಯಿರಿ
2. F5 ಒತ್ತಿ ಅಥವಾ "ದೌಡಿತ್ಯ ಮತ್ತು ಡೀಬಗ್ಗಿಂಗ್" ಪ್ಯಾನೆಲ್ ಬಳಸಿ
3. "Spring Boot-BasicChatApplication" ರಚನೆಯನ್ನು ಆರಿಸಿಕೊಳ್ಳಿ

ಸೂಚನೆ: VS ಕೋಡ್ ರಚನೆ ಸ್ವಯಂಚಾಲಿತವಾಗಿ ನಿಮ್ಮ .env ಫೈಲ್ ಅನ್ನು ಲೋಡ್ ಮಾಡುತ್ತದೆ

ನಿರೀಕ್ಷಿತ ಫಲಿತಾಂಶ

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.

ರಚನಾ ಸೂಚನೆ

ಪರಿಸರ ಚರಗಳು

ಚರ	ವರ್ಣನೆ	ಅಗತ್ಯ	ಉದಾಹರಣೆ
AZURE_OPENAI_ENDPOINT	ಫೌಂಡ್ರಿ (ಅಜೂರ್ ಓಪನ್‌ಎಐ) ಎಂಡ್‌ಪಾಯಿಂಟ್ URL	ಹೌದು	https://my-resource.openai.azure.com/
AZURE_OPENAI_DEPLOYMENT	ಚಾಟ್ ಮಾದರಿ ನಿಯೋಜನೆ ಹೆಸರು	ಇಲ್ಲ	gpt-4o-mini (ಡೀಫಾಲ್ಟ್)

ಯಾವುದೇ API ಕೀ ಚರ ಇಲ್ಲ — ಪ್ರಮಾಣೀಕರಣವು ಕೀಲೆಸ್ ಆಗಿದೆ (Microsoft Entra ID ಮೂಲಕ az login).

ಸ್ಪ್ರಿಂಗ್ ರಚನೆ

application.yml ಫೈಲ್ ನಲ್ಲಿ:

• ಎಂಡ್‌ಪಾಯಿಂಟ್: ${AZURE_OPENAI_ENDPOINT} - ಪರಿಸರ ಚರದಿಂದ
• ನಿಯೋಜನೆ: ${AZURE_OPENAI_DEPLOYMENT:gpt-4o-mini} - ಪರಿಸರ ಚರದಿಂದ fallback ಜೊತೆಗೆ
• ಅಥ್: ಕೀಲೆಸ್ — ಯಾವುದೇ api-key ಸೆಟ್ ಆಗಿಲ್ಲ, ಆದ್ದರಿಂದ Spring AI DefaultAzureCredential ಅನ್ನು ಬಳಸುತ್ತದೆ
• ತೆಂಪರೇಚರ್: 0.7 - ಸೃಜನಶೀಲತೆಯನ್ನು ನಿಯಂತ್ರಿಸುತ್ತದೆ (0.0 = ನಿರ್ಣಾಯಕ, 1.0 = ಸೃಜನಶೀಲ)
• ಗರಿಷ್ಠ ಟೋಕನ್ಗಳು: 500 - ಗರಿಷ್ಠ ಪ್ರತಿಕ್ರಿಯೆ ವಿಳಾಸ

ಸರಿದೂಗಿಸುವಿಕೆ

ಸಾಮಾನ್ಯ ಸಮಸ್ಯೆಗಳು

ದೋಷ: 401 / "PermissionDenied" / ಟೋಕನ್ ದೋಷಗಳು

• az login ಅನ್ನು ರನ್ ಮಾಡಿ — ಕೀಲೆಸ್ ಅಥ್ ಒಂದು ಸಕ್ರಿಯ ಲಾಗಿನ್ ಅಗತ್ಯವಿದೆ ಟೋಕನ್ ಪಡೆಯಲು
• ನಿಮ್ಮ ಖಾತೆಗೆ ಆ ಸಂಪನ್ಮೂಲದ ಮೇಲೆ ಕಾಗ್ನಿಟಿವ್ ಸರ್ವೀಸಸ್ ಓಪನ್‌ಎಐ ಬಳಕೆದಾರ ಸ್ಥಾನವಿವೆ ಎಂದು ದೃಢಪಡಿಸಿ
• ನೀವು ಪಾತ್ರವನ್ನು ನವೀನೀಕರಿಸಿ ಇದ್ದರೆ, ಅದು ಹರಡಲು ಕೆಲವು ನಿಮಿಷಗಳ ಸಮಯ ಕ್ರಯಿಸಿ
• ನೀವು ಸರಿಯಾದ ಟೆನಂಟ್/ಸಬ್ಸ್ಕ್ರಿಪ್ಷನ್‌ನಲ್ಲಿದ್ದೀರಾ ಎಂದು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ (az account show)

ದೋಷ: "ಎಂಡ್‌ಪಾಯಿಂಟ್ ಮಾನ್ಯವಲ್ಲ" / ಸಂಪರ್ಕ ದೋಷಗಳು

• ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ AZURE_OPENAI_ENDPOINT ಸಂಪೂರ್ಣ ಮೂಲ URL ಆಗಿದ್ದು (ಉದಾಹರಣೆಗೆ, https://your-resource.openai.azure.com/)
• ಕೊನೆಗಿನ ಸ್ಲಾಶ್ ಸुसಂಗತಿಯನ್ನು ಪರಿಶೀಲಿಸಿ
• ಎಂಡ್‌ಪಾಯಿಂಟ್ ನಿಮ್ಮ ನಿಯೋಜಿತ ಸಂಪನ್ಮೂಲಕ್ಕೆ ಹೊಂದಿಕೆಯಾಗುವುದನ್ನು ದೃಢಪಡಿಸಿ (azd env get-values)

ದೋಷ: "ನಿಯೋಜನೆ ಕಂಡುಬಂದಿಲ್ಲ"

• AZURE_OPENAI_DEPLOYMENT ನ ನಿಯೋಜನೆ ಹೆಸರಿನೊಂದಿಗೆ ನಿಮ್ಮ ಅಜೂರ್‌ನಲ್ಲಿ ಹೊಂದಾಣಿಕೆ ಇರುವುದು ಪರಿಶೀಲಿಸಿ
• ಮಾದರಿ ಯಶಸ್ವಿಯಾಗಿ ನಿಯೋಜನೆಗೊಂಡಿದ್ದು ಸಕ್ರಿಯವಿದೆ ಎಂದು ಪರಿಶೀಲಿಸಿ
• ಡೀಫಾಲ್ಟ್ ನಿಯೋಜನೆ ಹೆಸರು gpt-4o-mini

VS ಕೋಡ್: ಪರಿಸರ ಚರಗಳು ಲೋಡ್ ಆಗುತ್ತಿಲ್ಲ

• ನಿಮ್ಮ .env ಫೈಲ್ ಪ್ರಾಜೆಕ್ಟ್ ರೂಟ್ ಡೈರೆಕ್ಟರಿಯಲ್ಲಿ ಇದೆ ಎಂಬುದನ್ನು ಖಚಿತಪಡಿಸಿಕೊಳ್ಳಿ (pom.xml ಮಟ್ಟದಲ್ಲಿ)
• VS ಕೋಡ್‌ನ ಇಂಟಿಗ್ರೇಟೆಡ್ ಟರ್ಮಿನಲಿನಲ್ಲಿ mvn spring-boot:run ರನ್ ಮಾಡಿ ಪ್ರಯತ್ನಿಸಿ
• VS ಕೋಡ್ ಜಾವಾ ವಿಸ್ತರಣೆ ಸರಿಯಾಗಿ ಸ್ಥಾಪಿತವಾಗಿದೆ ಎಂದು ಪರಿಶೀಲಿಸಿ

ಡೀಬಗ್ಗಿಂಗ್ ಮೋಡ್

ವಿಸ್ತೃತ ಲಾಗ್‌ಗಾಗಿ, application.yml ನಲ್ಲಿ ಈ ಸಾಲುಗಳನ್ನು ಅನಕಮೆಂಟ್ ಮಾಡಿ:

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

ಮುಂದಿನ ಹಂತಗಳು

ಸೆಟ್‌ಅಪ್ ಪೂರ್ಣಗೊಂಡಿದೆ! ನಿಮ್ಮ ಅಧ್ಯಯನವನ್ನು ಮುಂದುವರಿಸಿ:

ಅಧ್ಯಾಯ 3: ಕೋರ್ ಜನರೇಟಿವ್ AI ತಂತ್ರಗಳು

ಸಂಪನ್ಮೂಲಗಳು

• Spring AI ಅಜೂರ್ ಓಪನ್‌ಎಐ ಡಾಕ್ಯುಮೆಂಟೇಶನ್
• Microsoft Entra ID ಸಹಿತ ಕೀಲೆಸ್ ಪ್ರಮಾಣೀಕರಣ
• ಅಜೂರ್ AI ಫೌಂಡ್ರಿ ಪೋರ್ಟಲ್
• ಅಜೂರ್ AI ಫೌಂಡ್ರಿ ಡಾಕ್ಯುಮೆಂಟೇಶನ್

---

ಅಸ್ವೀಕಾರ: ಈ ದಸ್ತಾವೇಜು AI ಅನುವಾದ ಸೇವೆ Co-op Translator ಬಳಸಿ ಅನುವಾದಿಸಲಾಗಿದೆ. ನಾವು ನಿಖರತೆಯನ್ನು ಸಾಧಿಸಲು ಪ್ರಯತ್ನಿಸುತ್ತಿದ್ದರೂ, ದಯವಿಟ್ಟು ಗಮನಿಸಿ, ಸ್ವಯಂಚಾಲಿತ ಅನುವಾದಗಳಲ್ಲಿ ದೋಷಗಳು ಅಥವಾ ಅಸಡ್ಡೆಗಳು ಇರಬಹುದು. ಮೂಲ ಭಾಷೆಯಲ್ಲಿರುವ ಮೂಲ ದಸ್ತಾವೇಜು ಪ್ರಾಮಾಣಿಕ ಮೂಲವೆಂದು ಪರಿಗಣಿಸಬೇಕು. ಪ್ರಮುಖ ಮಾಹಿತಿಗಾಗಿ, ವೃತ್ತಿಪರ ಮಾನವ ಅನುವಾದವನ್ನು ಶಿಫಾರಸು ಮಾಡಲಾಗುತ್ತದೆ. ಈ ಅನುವಾದವನ್ನು ಬಳಸುವ ಮೂಲಕ ಉಂಟಾಗುವ ಯಾವುದೇ ತಪ್ಪು ಅರ್ಥಗಳ ಅಥವಾ ತಪ್ಪು ವ್ಯಾಖ್ಯಾನಗಳ ಬಗ್ಗೆ ನಾವು ಹೊಣೆಗಾರರಲ್ಲ.