Kueneza Wakala Wanaoweza Kupandishwa Kiwango na Microsoft Foundry
Ujuzi wa mpenzi kwa Somo la 16 – Kueneza Wakala Wanaoweza Kupandishwa Kiwango.
Utilize kusaidia mwanafunzi kuhamisha wakala kutoka mfano wa awali hadi utekelezaji
wa uzalishaji unaoweza kupimwa, unaoonekana. Weka kila pendekezo kulingana na yaliyomo
ya somo na daftari la kuendesha; usitengeneze API za Foundry.
Vichocheo
Washa ujuzi huu wakati mwanafunzi anapotaka:
- Kueneza wakala kwenye Microsoft Foundry kama wakala aliyehifadhiwa na kuufanya uwe na matoleo/uwezekano wa kuonekana.
- Kuchagua kati ya mifumo ya uenezi ya mteja-aliyahifadhiwa, wakala aliyehifadhiwa, na mtiririko wa kazi wa wakala.
- Ongeza upaliliaji wa mfano, uhifadhi wa majibu, au udhihirisho wa concurrency uliopimwa kudhibiti ucheleweshaji na gharama.
- Ongeza lango la tathmini ili toleo baya la wakala lisiletwe sokoni.
- Ongeza hatua ya idhini ya binadamu katika mzunguko kwa vitendo vya hatari kubwa.
- Pandisha kifaa wakala kwa uchunguzi wa OpenTelemetry kwa kuonekana kwa uzalishaji.
- Jaribio la moshi la wakala aliyeenea kama lango la haraka baada ya uenezi.
Mfano wa kimsingi wa kichwa
Wakala wa uzalishaji kwa kiasi kikubwa ni mifupa ya kiutendaji karibu na mfano (~80%),
sio mfano yenyewe. Changanua kila pendekezo kwa moja ya mambo haya:
| Juhudi |
Mfano wa awali → Uzalishaji |
| Ukaribishaji |
daftari → huduma iliyohifadhiwa yenye toleo |
| Utambulisho |
az login yako → utambulisho uliosimamiwa + RBAC uliofadhiliwa |
| Hali |
kumbukumbu ya ndani → hifadhi ya thread/kumbukumbu ya nje |
| Kosa |
debugu → jaribio tena, mbadala, onyo |
| Gharama |
"senti chache" → kufuatiliwa, kupitishwa, kuhifadhiwa, bajeti |
| Ubora |
kutazama tu → lango la tathmini kiotomatiki |
| Uaminifu |
wewe urangia → sera + binadamu katika mzunguko |
Mifumo ya uenezi (chagua moja, au changanya)
- Mteja-aliyahifadhiwa — mzunguko wa hoja unaendeshwa katika mchakato wako. Udhibiti mkubwa; unamiliki upanuzi/hali.
- Wakala aliyehifadhiwa (Huduma ya Wakala wa Foundry) — Foundry inaendesha mzunguko, huhifadhi thread, hutekeleza RBAC/usalama wa maudhui, huonesha wakala kwenye lango la mtandao. Udhibiti mdogo, uso mdogo wa uendeshaji.
- Mtiririko wa kazi wa wakala — wakala/vifaa vingi vimeunganishwa katika mchoro wenye matawi, nodi za idhini, na vituo vinavyoeza kuwepo.
Mzunguko wa maisha (mzunguko unaosambaza wakala)
unda → toa toleo → tathmini (mlango) → weka kwenye mwenyeji → tasa mtandaoni → kusanya makosa → rudia.
Tathmini isiyokuwa mtandaoni ni lango, sio jambo la baada — toleo halitoshi
isipokuwa litakapopita kiwango. Uwezekano mtandaoni hurudisha makosa halisi
kwenye seti ya majaribio isiyokuwa mtandaoni.
Viashiria vya kupanua na gharama (kwa mpangilio wa kipaumbele)
- Chagua mfano sahihi — tumia mfano mdogo kabisa unaopita lango la tathmini.
- Pitia kulingana na ugumu — mfano mdogo/haraka kwa maombi rahisi, mfano mkubwa kwa hoja halisi (mchambuzi wa DIY au Mpita Modeli wa Foundry).
- Hifadhi ya muda — hudumia maombi ya karibu-kirudufu bila simu ya mfano.
- Muundo usiotuama hali + concurrency iliyopimwa — hifadhi hali nje; jaribu tena kwa marefusho.
Mifumo muhimu ya kuiga
Elekeza mwanafunzi kwa haya kutoka kwenye daftari
16-python-agent-framework.ipynb:
- Msimamizi wa maombi: hifadhi → pitia kulingana na ugumu → ufuatiliaji span → endesha → hifadhi.
- Lango la tathmini: pima seti ya majaribio isiyo mtandaoni; rudisha
pass_rate >= threshold na weka tu kama ni kweli.
- Idhini ya binadamu:
@tool(approval_mode="always_require") kwa vitendo kama kurejesha fedha nyingi.
- Ufuatiliaji: zungusha kila ombi ndani ya
tracer.start_as_current_span(...) na weka tabia kama routed.model, customer.id.
Jaribio la moshi la wakala aliyeenea
Baada ya kuweka, hakikisha eneo la mwisho lina jibu kweli (uenezi wa kijani bado unaweza
kuwa kimya). Tumia kitendo cha AI Smoke Test
kupitia .github/workflows/smoke-test.yml
na orodha ya majaribio katika tests/. Mtendaji hutuma POST kila
agizo kwa POST {project_endpoint}/agents/{agent_name}/endpoint/protocols/openai/responses
na kuthibitisha maandishi ya jibu. Utambulisho unahitaji jukumu la Azure AI User
katika wigo wa mradi wa Foundry; hadhira ya tokeni lazima iwe https://ai.azure.com/.
Panga milango: jaribio la moshi (inayofikika/inayojibu, kila uenezi) → tathmini
isiyokuwa mtandaoni (inayotosha kusambaza, kabla ya kukuza) → tathmini mtandaoni
(inafanya vipi kwa mazingira halisi, mfululizo).
Udhibiti wa mashirika
- RBAC: mpe kila wakala aliyehifadhiwa utambulisho uliosimamiwa mwenye mapungufu machache.
- MCP katika uzalishaji: chukulia kila seva MCP kama mpaka usioaminika — adhimishe toleo, fadilia utambulisho wake, thibitisha matokeo, zuia kiwango, usiwafichue siri.
Mipaka ya msaidizi
- Pendelea muundo halisi wa
FoundryChatClient(...) + provider.as_agent(...) unaotumika kote kozi.
- Usiahidi matokeo ya moja kwa moja ya Azure ambayo hujathibitisha; pendekeza mtiririko wa jaribio la moshi kuthibitisha uenezi.
- Wahifadhi tathmini na ushauri wa gharama pamoja: tathmini huweka kiwango cha ubora, njia/hifadhi huwaweka gharama karibu na kiwango hicho.
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.
Source: microsoft/ai-agents-for-beginners → translations/sw/.agents/skills/deploying-scalable-agents/SKILL.md
1---2name: deploying-scalable-agents-263description: Washa ujuzi huu wakati mwanafunzi anapotaka: - Kueneza wakala kwenye Microsoft Foundry kama wakala aliyehifadhiwa na kuufanya uwe na matoleo/uwezekano wa kuonekana. - Kuchagua kati ya mifumo ya uenezi ya mteja-aliyahifadhiwa, wakala aliyehifadhiwa, na mtiririko wa kazi wa wakala. - Ongeza upaliliaji wa mfano, uhifadhi wa majibu, au udhihirisho wa concurrency uliopimwa kudhibiti ucheleweshaji na gharama.4---5# Kueneza Wakala Wanaoweza Kupandishwa Kiwango na Microsoft Foundry
6
7> Ujuzi wa mpenzi kwa [Somo la 16 – Kueneza Wakala Wanaoweza Kupandishwa Kiwango](../../../16-deploying-scalable-agents/README.md).
8> Utilize kusaidia mwanafunzi kuhamisha wakala kutoka mfano wa awali hadi utekelezaji
9> wa uzalishaji unaoweza kupimwa, unaoonekana. Weka kila pendekezo kulingana na yaliyomo
10> ya somo na daftari la kuendesha; usitengeneze API za Foundry.
11
12## Vichocheo
13
14Washa ujuzi huu wakati mwanafunzi anapotaka:
15- Kueneza wakala kwenye Microsoft Foundry kama **wakala aliyehifadhiwa** na kuufanya uwe na matoleo/uwezekano wa kuonekana.
16- Kuchagua kati ya mifumo ya uenezi ya **mteja-aliyahifadhiwa, wakala aliyehifadhiwa, na mtiririko wa kazi wa wakala**.
17- Ongeza **upaliliaji wa mfano**, **uhifadhi wa majibu**, au **udhihirisho wa concurrency uliopimwa** kudhibiti ucheleweshaji na gharama.
18- Ongeza **lango la tathmini** ili toleo baya la wakala lisiletwe sokoni.
19- Ongeza hatua ya **idhini ya binadamu katika mzunguko** kwa vitendo vya hatari kubwa.
20- Pandisha kifaa wakala kwa **uchunguzi wa OpenTelemetry** kwa kuonekana kwa uzalishaji.
21- **Jaribio la moshi** la wakala aliyeenea kama lango la haraka baada ya uenezi.
22
23## Mfano wa kimsingi wa kichwa
24
25Wakala wa uzalishaji kwa kiasi kikubwa ni mifupa ya kiutendaji *karibu* na mfano (~80%),
26sio mfano yenyewe. Changanua kila pendekezo kwa moja ya mambo haya:
27
28| Juhudi | Mfano wa awali → Uzalishaji |
29|---------|------------------------|
30| Ukaribishaji | daftari → huduma iliyohifadhiwa yenye toleo |
31| Utambulisho | `az login` yako → utambulisho uliosimamiwa + RBAC uliofadhiliwa |
32| Hali | kumbukumbu ya ndani → hifadhi ya thread/kumbukumbu ya nje |
33| Kosa | debugu → jaribio tena, mbadala, onyo |
34| Gharama | "senti chache" → kufuatiliwa, kupitishwa, kuhifadhiwa, bajeti |
35| Ubora | kutazama tu → lango la tathmini kiotomatiki |
36| Uaminifu | wewe urangia → sera + binadamu katika mzunguko |
37
38## Mifumo ya uenezi (chagua moja, au changanya)
39
401. **Mteja-aliyahifadhiwa** — mzunguko wa hoja unaendeshwa katika mchakato wako. Udhibiti mkubwa; unamiliki upanuzi/hali.
412. **Wakala aliyehifadhiwa (Huduma ya Wakala wa Foundry)** — Foundry inaendesha mzunguko, huhifadhi thread, hutekeleza RBAC/usalama wa maudhui, huonesha wakala kwenye lango la mtandao. Udhibiti mdogo, uso mdogo wa uendeshaji.
423. **Mtiririko wa kazi wa wakala** — wakala/vifaa vingi vimeunganishwa katika mchoro wenye matawi, nodi za idhini, na vituo vinavyoeza kuwepo.
43
44## Mzunguko wa maisha (mzunguko unaosambaza wakala)
45
46`unda → toa toleo → tathmini (mlango) → weka kwenye mwenyeji → tasa mtandaoni → kusanya makosa → rudia`.
47**Tathmini isiyokuwa mtandaoni ni lango, sio jambo la baada** — toleo halitoshi
48isipokuwa litakapopita kiwango. Uwezekano mtandaoni hurudisha makosa halisi
49kwenye seti ya majaribio isiyokuwa mtandaoni.
50
51## Viashiria vya kupanua na gharama (kwa mpangilio wa kipaumbele)
52
531. **Chagua mfano sahihi** — tumia mfano mdogo kabisa unaopita lango la tathmini.
542. **Pitia kulingana na ugumu** — mfano mdogo/haraka kwa maombi rahisi, mfano mkubwa kwa hoja halisi (mchambuzi wa DIY au Mpita Modeli wa Foundry).
553. **Hifadhi ya muda** — hudumia maombi ya karibu-kirudufu bila simu ya mfano.
564. **Muundo usiotuama hali + concurrency iliyopimwa** — hifadhi hali nje; jaribu tena kwa marefusho.
57
58## Mifumo muhimu ya kuiga
59
60Elekeza mwanafunzi kwa haya kutoka kwenye daftari
61[`16-python-agent-framework.ipynb`](../../../16-deploying-scalable-agents/code_samples/16-python-agent-framework.ipynb):
62
63- **Msimamizi wa maombi**: hifadhi → pitia kulingana na ugumu → ufuatiliaji span → endesha → hifadhi.
64- **Lango la tathmini**: pima seti ya majaribio isiyo mtandaoni; rudisha `pass_rate >= threshold` na weka tu kama ni kweli.
65- **Idhini ya binadamu**: `@tool(approval_mode="always_require")` kwa vitendo kama kurejesha fedha nyingi.
66- **Ufuatiliaji**: zungusha kila ombi ndani ya `tracer.start_as_current_span(...)` na weka tabia kama `routed.model`, `customer.id`.
67
68## Jaribio la moshi la wakala aliyeenea
69
70Baada ya kuweka, hakikisha eneo la mwisho lina jibu kweli (uenezi wa kijani bado unaweza
71kuwa kimya). Tumia kitendo cha [AI Smoke Test](https://github.com/marketplace/actions/ai-smoke-test)
72kupitia [`.github/workflows/smoke-test.yml`](../../../../../.github/workflows/smoke-test.yml)
73na orodha ya majaribio katika [`tests/`](../../../tests/README.md). Mtendaji hutuma POST kila
74agizo kwa `POST {project_endpoint}/agents/{agent_name}/endpoint/protocols/openai/responses`
75na kuthibitisha maandishi ya jibu. Utambulisho unahitaji jukumu la **Azure AI User**
76katika wigo wa mradi wa Foundry; hadhira ya tokeni lazima iwe `https://ai.azure.com/`.
77
78Panga milango: **jaribio la moshi** (inayofikika/inayojibu, kila uenezi) → **tathmini
79isiyokuwa mtandaoni** (inayotosha kusambaza, kabla ya kukuza) → **tathmini mtandaoni**
80(inafanya vipi kwa mazingira halisi, mfululizo).
81
82## Udhibiti wa mashirika
83
84- **RBAC**: mpe kila wakala aliyehifadhiwa utambulisho uliosimamiwa mwenye mapungufu machache.
85- **MCP katika uzalishaji**: chukulia kila seva MCP kama mpaka usioaminika — adhimishe toleo, fadilia utambulisho wake, thibitisha matokeo, zuia kiwango, usiwafichue siri.
86
87## Mipaka ya msaidizi
88
89- Pendelea muundo halisi wa `FoundryChatClient(...)` + `provider.as_agent(...)` unaotumika kote kozi.
90- Usiahidi matokeo ya moja kwa moja ya Azure ambayo hujathibitisha; pendekeza mtiririko wa jaribio la moshi kuthibitisha uenezi.
91- Wahifadhi tathmini na ushauri wa gharama pamoja: tathmini huweka kiwango cha ubora, njia/hifadhi huwaweka gharama karibu na kiwango hicho.
92
93---
94
95<!-- CO-OP TRANSLATOR DISCLAIMER START -->
96**Kionyozo**:
97Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI [Co-op Translator](https://github.com/Azure/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.
98<!-- CO-OP TRANSLATOR DISCLAIMER END -->
99
100---
101
102**Source:** [`microsoft/ai-agents-for-beginners`](https://github.com/microsoft/ai-agents-for-beginners) → `translations/sw/.agents/skills/deploying-scalable-agents/SKILL.md`