Mwongozo wa haraka wa Microsoft Foundry Agent Service umeandikwa kwa ajili ya Python. Unaficha mifumo ya ndani ya Azure ndani ya muundo wa awali.

Mwongozo wa kuanza haraka (quickstart) wa Microsoft Foundry Agent Service umeandikwa kwa ajili ya Python. Unajificha mifumo ya ndani ya Azure ndani ya muundo (scaffolding) mzito kiasi kwamba unaweza kumaliza mafunzo bila kujua ni rasilimali zipi zilikuwa zimeundwa hasa. Ukijenga kwa kutumia .NET, unaanza na upungufu: sampuli zinaelekeza upande usio sahihi, majina ya vifurushi yanabadilika bila onyo, na mabadiliko ya hivi karibuni ya jina kutoka Azure AI Foundry kwenda Microsoft Foundry yameacha seti mbili za nyaraka zikishindana kwenye matokeo ya utafutaji.

Hivi karibuni nilijenga agent wangu wa kwanza kwa C#. Huduma hii inafanya kazi vizuri mara tu unapoweka pembeni mambo yasiyo ya lazima na kutenganisha hatua muhimu kutoka kwenye mkanganyiko wa toleo la majaribio (preview-version). Hii hapa ni ramani ambayo nilitamani ningekuwa nayo siku ya kwanza.

Rasilimali Nne Unazohitaji Hali Halisi

Hauhitaji huduma kadhaa za Azure ili kuendesha Prompt Agent ya msingi. Unahitaji vitu vinne tu, na CLI inavifanya kuonekana kwa njia ambayo vitabu vya Python (notebooks) haviwezi.

Kwanza, rasilimali ya Foundry yenye aina ya AIServices. Hii hufanya kazi kama uwezo mkuu (parent capacity) kwa modeli utakazozitumia. Pili, project ndani ya rasilimali hiyo. Project ndiyo upeo ambapo maelezo ya agent wako, mada za mazungumzo (conversation threads), na mipangilio ya utoaji (deployment settings) hukaa. Tatu, deployed model. Bila utoaji (deployment) hai, agent hana endpoint ya kuitumia. Nne, role assignment kwa ajili ya utambulisho wako mwenyewe ili SDK iweze kujithibitisha (authenticate) dhidi ya project hiyo.

Hivyo tu. Hakuna kundi la Kubernetes, hakuna compute maalum, hakuna Redis cache inayodhibitiwa kwa mkono kwa ajili ya historia ya mazungumzo.

Prompt Agents Dhidi ya Hosted Agents

Foundry inakupa njia mbili za kuendesha agent. Usichague chaguo tata zaidi kama chaguo lako la kawaida.

Prompt Agents ni njia rahisi zaidi. Unachagua modeli, unaandika maelekezo ya mfumo (system instructions), na Foundry inakuendeshea agent huyo. Huisimami compute, kontena, au mantiki ya uelekezaji (routing logic). Hii inafaa kwa zana za ndani, bot za helpdesk, na majibu ya maswali ya moja kwa moja kutoka kwenye nyaraka.

Hosted Agents zinakutaka uandike kodi ya programu, uifunge kama kontena, na kuiunganisha kwenye Foundry. Unachagua njia hii tu pale unapohitaji mantiki maalum ya biashara ambayo Foundry haiwezi kuielezea kupitia maelekezo (prompts) na zana zilizojengwa ndani, kama vile kuitia wito API ya ndani yenye uthibitisho (authentication) usio wa kawaida.

Mwongozo huu unajikita kwenye Prompt Agents kwa sababu ndiyo njia ya haraka zaidi ya kuthibitisha kuwa mipangilio yako ya .NET iko sahihi kabla ya kuwekeza kwenye faili za Docker na usimamizi (orchestration).

Kusanidi Kutoka kwenye Command Line

Kutumia CLI inakulazimu kuona kila rasilimali, jambo ambalo ndilo mwongozo wa Python unaloficha. Tengeneza kikundi cha rasilimali (resource group) katika East US 2. Uchaguzi wa eneo (region) ni muhimu hapa. Foundry inatoa msaada wa zana kwa njia isiyo sawa, na East US 2 kwa sasa ina seti pana zaidi ya zana. Ukichagua eneo ambalo halina code interpreter au zana za utafutaji faili, agizo lako la kutengeneza agent litafeli kwa kutoa hitilafu isiyoeleweka kuhusu uwezo usioingilika.

Tengeneza rasilimali ya Foundry ukitumia flag ya --allow-project-management. Bila flag hiyo, rasilimali itabaki kama endpoint ya huduma za kognitivi inayojitegemea na haitakubali utoaji wenye upeo wa project (project-scoped deployments) ambao agent wanahitaji. Kisha tengeneza project, toa modeli yako, na jipatie jukumu la Foundry User.

Tumia GUID thabiti ya jukumu badala ya jina la kuonyesha (display name):

53ca6127-db72-4b80-b1b0-d745d6d5456d

Majina ya majukumu husambaa kupitia Azure Active Directory kwa kasi tofauti kulingana na tenant. Shirika moja linaweza kuona Foundry User kwenye portal leo; lingine halitaiona kwa siku kadhaa. GUID inaelekeza moja kwa moja kwenye ufafanuzi na haitafeli wakati wa usambazaji. Maelezo haya moja yanaweza kukuokoa saa moja ya kurekebisha hitilafu za ruhusa iliyokataliwa (permission-denied) ambazo zinaonekana kama matatizo ya sera (policy) lakini kwa kweli ni matatizo ya utatuzi wa lebo (label-resolution).

Epuka Kifurushi cha NuGet Kisicho Sahihi

Hapa ndipo watengenezaji wa .NET mara nyingi wanapokwama. Utaona marejeleo ya Azure.AI.Projects.OpenAI katika vipande vya kodi (snippets) vya zamani. Kifurushi hicho ni cha majaribio tu (preview-only), na kinashindana na Azure.AI.Extensions.OpenAI. Vyote viwili vinafafanua mbinu za nyongeza (extension methods) na aina (types) katika namespaces zinazofanana. Ukivifunga pamoja, ujenzi (build) wako utafeli kwa hitilafu za marejeleo yenye utata (ambiguous reference errors) ambazo