Microsoft Foundry Agent Service యొక్క quickstart Python కోసం వ్రాయబడింది. ఇది Azure అంతర్గత సెటప్‌ను ఎంత దట్టమైన నిర్మాణంలో దాచిపెడుతుందంటే, ఏ వనరులు (resources) నిజంగా సృష్టించబడ్డాయో తెలియకుండానే మీరు ట్యుటోరియల్‌ను పూర్తి చేయవచ్చు. మీరు .NET పై నిర్మిస్తుంటే, మీరు ఒక అడ్డంకితో ప్రారంభిస్తారు: శాంపిల్స్ తప్పు దిశను సూచిస్తాయి, ప్యాకేజీ పేర్లు హెచ్చరిక లేకుండా మారుతాయి, మరియు Azure AI Foundry నుండి Microsoft Foundry కి జరిగిన ఇటీవలి రీబ్రాండింగ్ వల్ల సెర్చ్ రిజల్ట్స్‌లో రెండు రకాల డాక్యుమెంటేషన్లు పోటీ పడుతున్నాయి.

నేను ఇటీవల C# లో నా మొదటి ఏజెంట్‌ను నిర్మించాను. అనవసరమైన గందరగోళాన్ని తొలగించి, ముఖ్యమైన దశలను ప్రివ్యూ-వెర్షన్ గందరగోళం నుండి వేరు చేస్తే, ఈ సర్వీస్ బాగా పనిచేస్తుంది. మొదటి రోజు నాకు ఏ మ్యాప్ ఉంటే బాగుండేదో, అదే ఇక్కడ ఇస్తున్నాను.

మీకు నిజంగా అవసరమైన నాలుగు వనరులు (Resources)

ప్రాథమిక Prompt Agent ను నడపడానికి మీకు డజన్ల కొద్దీ Azure సర్వీసులు అవసరం లేదు. మీకు ఖచ్చితంగా నాలుగు అంశాలు అవసరం, మరియు Python నోట్‌బుక్‌లు చేయలేని విధంగా CLI వాటిని స్పష్టంగా చూపిస్తుంది.

మొదటిది, AIServices kind తో కూడిన Foundry resource. మీరు పిలిచే మోడల్స్ కోసం ఇది పేరెంట్ కెపాసిటీగా పనిచేస్తుంది. రెండవది, ఆ రిసోర్స్ లోపల ఒక project. మీ ఏజెంట్ నిర్వచనాలు, సంభాషణ థ్రెడ్‌లు మరియు డిప్లాయ్‌మెంట్ సెట్టింగ్‌లు ఉండే పరిధి (scope) ఈ ప్రాజెక్ట్. మూడవది, ఒక deployed model. యాక్టివ్ డిప్లాయ్‌మెంట్ లేకపోతే, ఏజెంట్‌కు పిలవడానికి (invoke) ఎండ్‌పాయింట్ ఉండదు. నాలుగవది, మీ స్వంత ఐడెంటిటీ కోసం ఒక role assignment, తద్వారా SDK ప్రాజెక్ట్‌తో అథెంటికేట్ చేయగలదు.

అంతే. Kubernetes క్లస్టర్ అవసరం లేదు, కస్టమ్ కంప్యూట్ అవసరం లేదు, సంభాషణ చరిత్ర కోసం మాన్యువల్‌గా నిర్వహించబడే Redis క్యాచీ అవసరం లేదు.

Prompt Agents వర్సెస్ Hosted Agents

ఏజెంట్‌లను నడపడానికి Foundry మీకు రెండు మార్గాలను అందిస్తుంది. సంక్లిష్టమైన ఆప్షన్‌ను డిఫాల్ట్‌గా ఎంచుకోవద్దు.

Prompt Agents సరళమైన మార్గం. మీరు ఒక మోడల్‌ను ఎంచుకుంటారు, సిస్టమ్ సూచనలను రాస్తారు మరియు Foundry మీ కోసం ఏజెంట్‌ను నడుపుతుంది. మీరు కంప్యూట్, కంటైనర్లు లేదా రూటింగ్ లాజిక్‌ను నిర్వహించాల్సిన అవసరం లేదు. ఇది ఇంటర్నల్ టూల్స్, హెల్ప్‌డెస్క్ బాట్‌లు మరియు డాక్యుమెంట్‌లపై నేరుగా ప్రశ్నలు అడిగే పనులకు సరిపోతుంది.

Hosted Agents కోసం మీరు అప్లికేషన్ కోడ్‌ను వ్రాయాలి, దానిని కంటైనర్‌గా ప్యాకేజీ చేయాలి మరియు దానిని Foundryకి అనుసంధానించాలి. ప్రాంప్ట్‌లు మరియు బిల్ట్-ఇన్ టూల్స్ ద్వారా Foundry వ్యక్తీకరించలేని కస్టమ్ బిజినెస్ లాజిక్ (ఉదాహరణకు, నాన్-స్టాండర్డ్ అథెంటికేషన్‌తో ఇంటర్నల్ APIని పిలవడం) మీకు అవసరమైనప్పుడు మాత్రమే ఈ మార్గాన్ని ఎంచుకోండి.

ఈ గైడ్ Prompt Agents పై దృష్టి పెడుతుంది, ఎందుకంటే మీరు Docker ఫైల్‌లు మరియు ఆర్కెస్ట్రేషన్ కోసం పెట్టుబడి పెట్టే ముందు, మీ .NET సెటప్ సరిగ్గా ఉందో లేదో తనిఖీ చేయడానికి ఇవి అత్యంత వేగవంతమైన మార్గం.

కమాండ్ లైన్ నుండి సెటప్ చేయడం

CLIని ఉపయోగించడం వల్ల ప్రతి రిసోర్స్ మీకు కనిపిస్తుంది, Python quickstart దాచిపెట్టేది కూడా ఇదే. East US 2 లో ఒక రిసోర్స్ గ్రూప్‌ను సృష్టించండి. ఇక్కడ రీజియన్ ఎంపిక ముఖ్యం. Foundry టూల్ సపోర్ట్‌ను అసమానంగా విడుదల చేస్తుంది, మరియు ప్రస్తుతం East US 2 లోనే అత్యంత విస్తృతమైన సపోర్ట్ ఉంది. మీరు కోడ్ ఇంటర్‌ప్రెటర్ లేదా ఫైల్ సెర్చ్ టూల్స్ లేని రీజియన్‌ను ఎంచుకుంటే, మీ ఏజెంట్ క్రియేషన్ కాల్ సపోర్ట్ చేయని సామర్థ్యాల గురించి అస్పష్టమైన ఎర్రర్‌తో విఫలమవుతుంది.

--allow-project-management ఫ్లాగ్‌తో Foundry రిసోర్స్‌ను సృష్టించండి. ఆ ఫ్లాగ్ లేకపోతే, రిసోర్స్ ఒక స్టాండ్‌అలోన్ కోగ్నిటివ్ సర్వీసెస్ ఎండ్‌పాయింట్‌గా మిగిలిపోతుంది మరియు ఏజెంట్‌లకు అవసరమైన ప్రాజెక్ట్-స్కోప్డ్ డిప్లాయ్‌మెంట్లను అంగీకరించదు. ఆ తర్వాత ప్రాజెక్ట్‌ను సృష్టించండి, మీ మోడల్‌ను డిప్లాయ్ చేయండి మరియు మీకు Foundry User రోల్‌ను కేటాయించండి.

డిస్‌ప్లే నేమ్ కు బదులుగా స్టేబుల్ role GUIDని ఉపయోగించండి:

53ca6127-db72-4b80-b1b0-d745d6d5456d

టెనెంట్ ని బట్టి రోల్ పేర్లు Azure Active Directory లో వేర్వేరు వేగంతో వ్యాప్తి చెందుతాయి. ఒక సంస్థ ఈరోజు పోర్టల్‌లో Foundry User ను చూస్తుంది; మరొక సంస్థ కొన్ని రోజుల వరకు చూడలేదు. GUID నేరుగా నిర్వచనానికి సూచిస్తుంది మరియు రోల్ రోల్‌అవుట్ సమయంలో విఫలం కాదు. ఈ చిన్న వివరమే పాలిసీ సమస్యలుగా కనిపించే కానీ నిజానికి లేబుల్-రిజల్యూషన్ సమస్యలుగా ఉండే permission-denied ఎర్రర్‌లను డీబగ్ చేయడానికి మీరు గంటల సమయాన్ని ఆదా చేయగలదు.

తప్పు NuGet ప్యాకేజీని నివారించండి

.NET డెవలపర్లు ఇక్కడే తరచుగా ఇబ్బంది పడతారు. పాత స్నిప్పట్స్‌లో Azure.AI.Projects.OpenAI గురించి రిఫరెన్స్‌లు కనిపిస్తాయి. ఆ ప్యాకేజీ కేవలం ప్రివ్యూ-ఓన్లీ, మరియు అది Azure.AI.Extensions.OpenAI తో ఓవర్‌ల్యాప్ అవుతుంది. రెండూ ఒకే విధమైన నేమ్‌స్పేస్‌లలో ఎక్స్‌టెన్షన్ మెథడ్స్ మరియు టైప్స్‌ను నిర్వచిస్తాయి. మీరు వాటిని పక్కపక్కనే ఇన్‌స్టాల్ చేస్తే, మీ బిల్డ్ అస్పష్టమైన రిఫరెన్స్ ఎర్రర్‌లతో విఫలమవుతుంది