Java కోసం జనరేటివ్ AI కోసం అభివృద్ధి వాతావరణాన్ని సెటప్ చేయడం

త్వరిత ఆరంభం: కొన్ని నిమిషాల్లో Bicep + azdతో మీ AI మోడల్స్‌ను Azure AI Foundryపై కోడుగా ప్రావిజన్ చేయండి — Azure AI Foundry సెటప్ గైడ్ చూడండి. ప్రమాణీకరణ కీలెస్ (Microsoft Entra ID)గా ఉంటుంది, కాబట్టి ఎలాంటి API కీలు నిర్వహించాల్సిన అవసరం లేదు.

మీరు ఏం నేర్చుకోబోతున్నారు

• AI అప్లికేషన్ల కోసం Java అభివృద్ధి వాతావరణం సెటప్ చేయడం
• మీ ఇష్టమైన అభివృద్ధి వాతావరణాన్ని ఎంచుకోండి మరియు కాన్ఫిగర్ చేయండి (Codespaces తో క్లౌడ్-ఫస్ట్, స్థానిక డెవ్ కంటైనర్ లేదా పూర్తి స్థానిక సెటప్)
• Azure AI Foundry మోడల్‌కు కనెక్ట్ చేసి మీ సెటప్‌ని పరీక్షించండి

కంటెంట్ పట్టిక

• మీరు ఏం నేర్చుకోబోతున్నారు
• పరిచయం
• దశ 1: మీ అభివృద్ధి వాతావరణాన్ని సెటప్ చేయండి
  • అవకాశం A: GitHub Codespaces (సిఫార్సు చేయబడింది)
  • అవకాశం B: స్థానిక డెవ్ కంటైనర్
  • అవకాశం C: మీ ఉన్నతమైన స్థానిక ఇన్‌స్టాలేషన్‌ను వాడండి
• దశ 2: Azure AI Foundryని ప్రావిజన్ చేయండి
• దశ 3: మీ సెటప్‌ని పరీక్షించండి
• త్రుటుల నివారణ
• సారాంశం
• తరువాతి దశలు

పరిచయం

ఈ చాప్టర్ ద్వారా మీరు ఒక అభివృద్ధి వాతావరణాన్ని సెటప్ చేయడం నేర్చుకుంటారు. మేము ఈ కోర్సులో మొత్తం మోడల్స్ కోసం Azure AI Foundry ని వాడతాము. మీరు Bicep మరియు Azure Developer CLI (azd)తో మోడల్స్‌ను కోడుగా ప్రావిజన్ చేస్తారు, తరువాత కీలెస్ ప్రమాణీకరణ (Microsoft Entra ID)తో కనెక్ట్ చేస్తారు — కాపీ చేయాల్సిన లేదా లీక్ అయ్యే ఏ API కీలు ఉండవు.

ఏ స్థానిక సెటప్ అవసరం లేదు! మీరు GitHub Codespacesను వాడవచ్చు, ఇది బ్రౌజర్‌లో పూర్తి అభివృద్ధి వాతావరణాన్ని ఇస్తుంది, అక్కడి నుండే Foundryని ప్రావిజన్ చేయవచ్చు.

మేము ఈ కోర్సు కోసం Azure AI Foundryని వాడతాము ఎందుకంటే:

• కోడుగా ప్రావిజన్ చేయబడుతుంది — ఒక azd upతో ఖాతా మరియు మోడల్ డిప్లాయ్‌మెంట్లను డిప్లాయ్ చేస్తుంది
• కీలెస్ — Azure సైన్-ఇన్ లేదా మేనేజ్‌డ్ ఐడెంటిటీతో ప్రమాణీకరించండి
• ప్రొడక్షన్-రెడీ — అదే కోడ్ స్థానికంగా మరియు Azureలో నడుస్తుంది
• ఫ్లెక్సిబుల్ — కోడ్ మార్చకుండా డిప్లాయ్‌మెంట్ పేరు మారుస్తూ మోడల్స్ మార్చవచ్చు

గమనిక: Azure AI Foundry డిప్లాయ్‌మెంట్లు టోకెన్ ఆధారంగా బిల్ చేయబడతాయి (చెల్లించి వాడండి). ప్రావిజనింగ్, రీజియన్, మరియు ఖర్చు వివరాలకు Azure AI Foundry సెటప్ గైడ్ చూడండి.

దశ 1: మీ అభివృద్ధి వాతావరణాన్ని సెటప్ చేయండి

ఈ జనరేటివ్ AI కోసం Java కోర్సు కోసం అన్ని అవసరమైన టూల్స్ ఉండేలా, సెటప్ సమయాన్ని తగ్గించడానికి మేము ముందుగా కాన్ఫిగర్ చేసిన అభివృద్ధి కంటైనర్ రూపొందించాము. మీకు చాలా ఇష్టమైన అభివృద్ధి విధానాన్ని ఎంచుకోండి:

వాతావరణ సెటప్ ఎంపికలు:

అవకాశం A: GitHub Codespaces (సిఫార్సు చేయబడింది)

2 నిమిషాల్లో కోడింగ్ ప్రారంభించండి - ఎలాంటి స్థానిక సెటప్ అవసరం లేదు!

1. ఈ రిపోజిటరీని మీ GitHub ఖాతాకు Fork చేయండి

   గమనిక: మీరు మౌలిక కాన్ఫిగరేషన్‌ను సవరించాలనుకుంటే Dev Container Configuration చూడండి

2. క్లిక్ చేయండి Code → Codespaces టాబ్ → ... → New with options...
3. డిఫాల్ట్‌లను వాడండి — ఇది ఈ కోర్సు కోసం సృష్టించిన కస్టమ్ డెవ్ కంటైనర్ కాన్ఫిగరేషన్: Generative AI Java Development Environment ను సెలెక్ట్ చేస్తుంది
4. క్లిక్ చేయండి Create codespace
5. వాతావరణం రెడీ అయ్యేవరకు సుమారు 2 నిమిషాలు వేచి ఉండండి
6. Step 2: Provision Azure AI Foundryకి వెళ్లండి

Codespaces లాభాలు:

• ఎలాంటి స్థానిక ఇన్‌స్టాలేషన్ అవసరం లేదు
• బ్రౌజర్ ఉన్న ఏ పరికరంపైనా పని చేస్తుంది
• అన్ని టూల్స్ మరియు డిపెండెన్సీలతో ముందుగా కాన్ఫిగర్ చేయబడ్డది
• వ్యక్తిగత ఖాతాల కోసం నెలకు ఉచితంగా 60 గంటలు
• అన్ని విద్యార్థులకు ఒకరీతి వాతావరణం

అవకాశం B: స్థానిక డెవ్ కంటైనర్

డాకర్‌తో స్థానిక అభివృద్ధిని ఇష్టపడేవారికి

1. ఈ రిపోజిటరీని ఫోర్క్ చేసి మీ స్థానిక మెషీన్‌కు క్లోన్ చేయండి

   గమనిక: మీరు మౌలిక కాన్ఫిగరేషన్‌ను సవరించాలనుకుంటే Dev Container Configuration చూడండి

2. Docker Desktop మరియు VS Code ఇన్‌స్టాల్ చేయండి
3. VS Codeలో Dev Containers extension ఇన్‌స్టాల్ చేయండి
4. VS Codeలో రిపోజిటరీ ఫోల్డర్‌ను ఓపెన్ చేయండి
5. ప్రాంప్ట్ వచ్చినప్పుడు, Reopen in Container క్లిక్ చేయండి (లేదా Ctrl+Shift+P → "Dev Containers: Reopen in Container" ఉపయోగించండి)
6. కంటైనర్ బిల్డ్ అయ్యి ప్రారంభమవ్వడం కోసం వేచి ఉండండి
7. Step 2: Provision Azure AI Foundryకి వెళ్లండి

అవకాశం C: మీ ఉన్నతమైన స్థానిక ఇన్‌స్టాలేషన్‌ను వాడండి

ఉన్న Java వాతావరణాలతో అభివృద్ధి చేసే వారు

అవసరాలు:

• Java 21+
• Maven 3.9+
• VS Code లేదా మీ ఇష్టమైన IDE

స్టెప్స్:

1. ఈ రిపోజిటరీని మీ స్థానిక మెషీన్‌కు క్లోన్ చేయండి
2. ప్రాజెక్ట్‌ను మీ IDEలో ఓపెన్ చేయండి
3. Step 2: Provision Azure AI Foundryకి వెళ్లండి

ప్రో టిప్: మీ మెషీన్ ఉన్నత రిసోర్సులు లేని పక్షంలోనే మీరు స్థానికంగా VS Code వాడాలనుకుంటే, GitHub Codespaces ఉపయోగించండి! మీరు స్థానిక VS Codeని క్లౌడ్ హోస్టెడ్ Codespaceకి కనెక్ట్ చేసుకోవచ్చు, ఇద్దరి లాభాలను పొందడానికి.

దశ 2: Azure AI Foundryని ప్రావిజన్ చేయండి

కోర్సు యొక్క AI మోడల్స్‌ను Azure AI Foundryకి కోడుగా డిప్లాయ్ చేయండి. రిపోజిటరీ రూట్ నుండి:

cd 02-SetupDevEnvironment
azd auth login
az login
azd up

azd వాతావరణం పేరు మరియు రీజియన్ అడగుతుంది, gpt-4o-mini మరియు text-embedding-3-small డిప్లాయ్‌మెంట్లతో Azure AI Foundry ఖాతాను ప్రావిజన్ చేస్తుంది, మరియు ఎండపాయింట్‌ను ఉదాహరణ .env లో రాస్తుంది — అంతటితో కీలెస్ ప్రమాణీకరణ (ఏ API కీలు అవసరం లేదు).

పూర్తి వాక్‌థ్రూ: ప్రిరిక్విజిట్స్, మాన్యువల్ (పోర్టల్) ప్రత్యామ్నాయం, రీజియన్ సూచనలు, మరియు ఖర్చు/క్లీన్-అప్ గమనికల కోసం Azure AI Foundry సెటప్ గైడ్ చూడండి.

దశ 3: మీ సెటప్‌ని పరీక్షించండి

మీ Foundry మోడల్స్ ప్రావిజన్ అయిన తర్వాత, 02-SetupDevEnvironment/examples/basic-chat-azure లో ఉదాహరణ యాప్‌తో కనెక్షన్‌ని పరీక్షించండి.

1. మీ అభివృద్ధి వాతావరణంలో టెర్మినల్ ఓపెన్ చేయండి.

2. ఉదాహరణకు నావిగేట్ అవ్వండి:

   cd 02-SetupDevEnvironment/examples/basic-chat-azure
   

3. మీరు సైన్-ఇన్ అయి ఉన్నారా అని నిర్ధారించుకోండి (కీలెస్ ఆథ్‌కి టోకెన్ అవసరం):

   az login
   

   మీరు azd up పరచినట్లయితే, ఇప్పటికీ మీ ఎండపాయింట్‌తో .env ఫైల్ ఇప్పటికే రాయబడింది.

4. యాప్‌ను రన్ చేయండి:

   mvn clean spring-boot:run
   

gpt-4o-mini మోడల్ నుండి స్పందన కనిపిస్తుందని మీరు చూడగలరు.

ఉదాహరణ కోడ్‌ను అర్థం చేసుకోవడం

examples/basic-chat-azure కింద ఉన్న ఉదాహరణ Spring Boot యాప్, ఇది Spring AI ఉపయోగించి Azure AI Foundryకి కీలెస్ ప్రమాణీకరణతో కనెక్ట్ అవుతుంది.

ఈ కోడ్ ఏమి చేస్తుంది:

• మీ Azure సైన్-ఇన్ (Microsoft Entra ID) ఉపయోగించి Azure AI Foundryకి కనెక్ట్ అవుతుంది — ఏ API కీ అవసరం లేదు
• gpt-4o-mini మోడల్‌కు ప్రాంప్ట్ పంపుతుంది
• AI యొక్క ప్రతిస్పందన గ్రహించి మరియు ప్రదర్శిస్తుంది
• మీ సెటప్ సరిగ్గా పని చేస్తున్నదని ధృవీకరిస్తుంది

ప్రధాన డిపెండెన్సీ (pom.xmlలో):

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-model-azure-openai</artifactId>
</dependency>

కాన్ఫిగరేషన్ (application.yml):

spring:
  ai:
    azure:
      openai:
        # Endpoint only - no api-key. Spring AI uses DefaultAzureCredential (keyless).
        endpoint: ${AZURE_OPENAI_ENDPOINT}
        chat:
          options:
            deployment-name: ${AZURE_OPENAI_DEPLOYMENT:gpt-4o-mini}

సారాంశం

చాలా బాగుంది! ఇప్పుడు మీ వద్ద అన్ని సెటప్ అయింది:

• Bicep + azdతో Azure AI Foundry మోడల్స్‌ను కోడుగా ప్రావిజన్ చేసారు
• మీ Java అభివృద్ధి వాతావరణాన్ని నడుపుతున్నార్లె (Codespaces, dev కంటైనర్లు లేదా స్థానికమైన)
• కీలెస్ ప్రమాణీకరణ (Microsoft Entra ID)తో Azure AI Foundryకి కనెక్ట్ అయ్యారు — ఏ API కీలు వద్దు
• మీ మోడల్‌తో మాట్లాడే సరళమైన ఉదాహరణతో అన్ని పనిచేస్తున్నదని పరీక్షించారు

తర్వాతి దశలు

అధ్యాయం 3: కోర్ జనరేటివ్ AI సాంకేతికతలు

త్రుటుల నివారణ

సమస్యలు ఉన్నాయా? ఇక్కడ కొన్ని సాధారణ సమస్యలు మరియు పరిష్కారాలు:

• ఆథెంటికేషన్ విఫలం అవుతోంది (401/403)?

  • az login నడపండి — ప్రమాణీకరణ కీలెస్‌గా ఉంటుంది కాబట్టి మీరు సైన్-ఇన్ అయి ఉండాలి
  • మీ ఖాతాకు వనరు మీద Cognitive Services OpenAI User పాత్ర ఉందని నిర్ధారించండి
  • మీరు ఇటీవల ప్రావిజన్ చేసినట్లయితే, పాత్ర నియామకం చేరడానికి కొంత సమయం తీసుకోవచ్చు

• Maven కనిపించడంలేదు?

  • dev కంటైనర్లు/Codespaces వాడితే Maven ముందుగానే ఇన్‌స్టాలైన్గా ఉంటుంది
  • స్థానిక సెటప్ కోసం Java 21+ మరియు Maven 3.9+ ఇన్‌స్టాల్ అయ్యాయో చూడండి
  • mvn --versionతో ఇన్‌స్టాలేషన్ ధృవీకరించండి

• azd కనిపించట్లేదు లేదా ప్రావిజనింగ్ విఫలం?

  • Azure Developer CLI ఇన్‌స్టాల్ చేసి azd auth login నడపండి
  • gpt-4o-mini అందుబాటులో ఉన్న ప్రాంతాన్ని ఎంచుకోండి (ఉదా: eastus2)
  • వివరాలు కోసం Azure AI Foundry సెటప్ గైడ్ చూడండి

• Dev కంటైనర్ ప్రారంభమవట్లేదు?

  • Docker Desktop నడుస్తుందో లేదో చూసుకోండి (స్థానిక అభివృద్ధి కోసం)
  • కంటైనర్‌ను తిరిగి బిల్డ్ చేయTry చెయ్యండి: Ctrl+Shift+P → "Dev Containers: Rebuild Container"

• యాప్ కంపైల్ లోపాలు?

  • మీరు సరైన డైరెక్టరీలో ఉన్నారా చూసుకోండి: 02-SetupDevEnvironment/examples/basic-chat-azure
  • క్లీన్ చేసి రీబిల్డ్ చేయTry చెయ్యండి: mvn clean compile

సహాయం కావాలా?: ఇంకా సమస్య ఉంటే, రిపోజిటరీలో ఒక ఇష్యూ ఓపెన్ చేయండి, మేము మీకు సహాయం చేస్తాము.

---

అస్వీకరణ: ఈ పత్రం AI అనువాద సేవ Co-op Translator ఉపయోగించి అనువదించబడింది. మేము ఖచ్చితత్వానికి ప్రయత్నిస్తున్నప్పటికీ, ఆటోమేటెడ్ అనువాదాలు తప్పులు లేదా అసమగ్రతలను కలిగి ఉండవచ్చు. దాని స్వదేశ భాషలో ఉన్న అసలు పత్రాన్ని అధికారం కలిగిన మూలంగా పరిగణించాలి. కీలకమైన సమాచారం కోసం, ప్రొఫెషనల్ మానవ అనువాదాన్ని సిఫారసు చేస్తాము. ఈ అనువాదం ఉపయోగం వల్ల కలిగే ఏవైనా అపార్థాలు లేదా తప్పుదారులు కోసం మేము బాధ్యత వహించము.