deploying-scalable-agents
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-11-07
- Stars
- ★ 8.0w
- Forks
- 2.6w
01 前言 Front Matter
- name
- deploying-scalable-agents
- license
- MIT
02 资源文件 11
- 参考文档forms.md9.2 KB
- 许可证LICENSE.txt1.4 KB
- 参考文档reference.md16.3 KB
- 脚本scripts/check_bounding_boxes_test.py8.6 KB
- 脚本scripts/check_bounding_boxes.py3.1 KB
- 脚本scripts/check_fillable_fields.py362 B
- 脚本scripts/convert_pdf_to_images.py1.1 KB
- 脚本scripts/create_validation_image.py1.6 KB
- 脚本scripts/extract_form_field_info.py6.0 KB
- 脚本scripts/fill_fillable_fields.py4.7 KB
- 脚本scripts/fill_pdf_form_with_annotations.py3.5 KB
03 SKILL.md 正文
Microsoft Foundry ഉപയോഗിച്ച് സ്കെയ്ലബിള് ഏജന്റുകള് വിന്യസിക്കല്
പാഠം 16 – സ്കെയ്ലബിള് ഏജന്റുകള് വിന്യസിക്കല് അതിന്റെ സഹായത്തിന് ഏജന്റിന്റെ കഴിവ്. ഒരു പഠിതാവിന് ഏജന്റിനെ പ്രോട്ടോട്ടൈപ്പ് നിന്നു സ്കെയ്ലബിള്, നിരീക്ഷണയോഗ്യമായ ഉത്പാദന വിന്യസത്തിലേക്ക് നീക്കാന് സഹായിക്കാന് ഇതിനെ ഉപയോഗിക്കുക. ഓരോ ശുപാര്ശയും പാഠം ഉള്ളടക്കത്തിലിലും പ്രവര്ത്തനശീലമായ നോട്ട് ബുകിലും ആധാരമാക്കുക; Foundry APIകള് കണ്ടുപിടിക്കരുത്.
ട്രിഗറുകള്
പഠിതാവ് താഴെ പറയുന്ന വീതം ആഗ്രഹിക്കുന്നപ്പോഴാണ് ഈ കഴിവ് സജീവമാക്കുക:
- ഒരു ഏജന്റിനെ Microsoft Foundryയില് ഹോസ്റ്റഡ് ഏജന്റായി വിന്യസിച്ച് അത് പതിപ്പാക്കി/നിരീക്ഷണയോഗ്യമായതായി നിര്മിക്കുക.
- ക്ലയന്റ്-ഹോസ്റ്റഡ്, ഹോസ്റ്റഡ്-എജന്റും, ഏജന്റ-വര്ക്ഫ്ലോയും എന്നിങ്ങനെ വിന്യാസ മാതൃകകളില് തിരഞ്ഞെടുക്കുക.
- വെട്ടിപ്പ് നിയന്ത്രിക്കുന്നതിന് മോഡല് റൂട്ടിങ്, റിസ്പോണ്സ് കാഷിംഗ് അല്ലെങ്കില് ബൗണ്ടഡ് കോൺകറൻസി ചേര്ക്കുക.
- ഒരു പൊള്ള തിരഞ്ഞെടുക്കല് വിലയിരുത്തല് ഗേറ്റ് ചേര്ക്കുക എന്നതുകൊണ്ടാണ് മോശം ഏജന്റ് പതിപ്പ് നിങ്ങള്ക്ക് ലഭിക്കാതെ നില്ക്കുന്നത്.
- ഉന്നത-അപകട സാധ്യതയുള്ള പ്രവൃത്തികള്ക്ക് മനുഷ്യന്റെ അംഗീകാരം ഘട്ടം ചേര്ക്കുക.
- ഉത്പാദന നിരീക്ഷണത്തിനായി ഏജന്റിനെ OpenTelemetry ട്രേസിങ്ങ് ഉപയോഗിച്ച് സജ്ജമാക്കുക.
- വിന്യസിച്ച ഏജന്റിനെ ഒരു വേഗത്തിലുള്ള പോസ്റ്റ്-ഡിപ്ലോയ് ഗേറ്റായിട്ടുള്ള സ്മോക്ക്-ടെസ്റ്റ് നടത്തുക.
പ്രാഥമിക മാനസിക മാതൃകം
ഉത്പാദന ഏജന്റ് പ്രധാനമായി മോഡലിന്റെ ചുറ്റുമുള്ള പ്രവർത്തനഘടനയാണ് (~80%), മോഡലല്ല. ഓരോ ശുപാര്ശയും താഴെ പറയുന്ന വിഷയങ്ങളില് ഒന്നില് ബന്ധിപ്പിക്കുക:
| വിഷയം | പ്രോട്ടോട്ടൈപ്പ് → ഉത്പാദനം |
|---|---|
| ഹോസ്റ്റിംഗ് | നോട്ട്ബുക്ക് → പതിപ്പു നേടിയ ഹോസ്റ്റഡ് സേവനം |
| തിരിച്ചറിയല് | നിങ്ങളുടെ az login → മാനേജുചെയ്യപ്പെട്ട തിരിച്ചറിയല് + സ്കോപ്പ് ചെയ്യപ്പെട്ട RBAC |
| നില | ഓര്മയില് → ബാഹ്യമായ ത്രെഡ് / മെമ്മറി സ്റ്റോര് |
| വീഴ്ച | ട്രേസ്ബാക്ക് → റെട്രൈകള്, ഫാള്ബാക്കുകള്, അറിയിപ്പുകള് |
| ചെലവ് | "ഒരു சில സെന്റുകള്" → ട്രാക്കചെയ്ത്, റൂട്ടുചെയ്ത്, കാഷ് ചെയ്തു, ബജറ്റ് ചെയ്ത |
| ഗുണമേന്മ | കണക്ക് നോക്കല് → ഓട്ടോമേറ്റഡ് വിലയിരുത്തല് ഗേറ്റ് |
| വിശ്വാസം | നിങ്ങള് അംഗീകരിക്കുന്നു → നയം + മനുഷ്യന്റെ അംഗീകാരം |
വിന്യാസ മാതൃകകള് (ഒന്ന് തിരഞ്ഞെടുക്കുക അല്ലെങ്കില് സംയോജിപ്പിക്കുക)
- ക്ലയന്റ്-ഹോസ്റ്റഡ് — റീസണിങ് ലൂപ്പ് നിങ്ങളുടെ പ്രോസസിലാണ് നടത്തുന്നത്. പരമാവധി നിയന്ത്രണം; സ്കെയിലിംഗ്/സ്റ്റേറ്റ് உം നിങ്ങള്ക്കു സ്വന്തമാണ്.
- ഹോസ്റ്റഡ് ഏജന്റ് (Foundry Agent Service) — Foundry ലൂപ്പ് ഹോസ്റ്റ് ചെയ്യുന്നു, ത്രെഡ്സ് സ്റ്റോര് ചെയ്യുന്നു, RBAC/ഉള്ളടക്കസുരക്ഷ പാലിക്കുന്നു, ഏജന്റിനെ പോര്ട്ടലില് കാണിക്കുന്നു. കുറവ് നിയന്ത്രണം, വളരെ കുറവ് പ്രവർത്തന പരിധി.
- ഏജന്റ്സ് വര്ക്ക്ഫ്ലോ — ബ്രാഞ്ചിംഗ്, അംഗീകാരം നോട്ടുകള്, സ്ഥിരമായ ചെക്ക്പോയിന്റുകളുള്ള ഗ്രാഫായി നിരവധി ഏജന്റുകളെയും ഉപകരണങ്ങളെയും ചേര്ത്തിരിക്കുന്നത്.
ജീവിതചക്രം (ഏജന്റിനെ ഷിപ്പ് ചെയ്യുന്ന ലൂപ്പ്)
create → version → evaluate (gate) → deploy hosted → observe online → collect failures → repeat.
ഓഫ്ലൈന് വിലയിരുത്തല് ഒരു ഗേറ്റാണ്, വഴക്കരുത് — ഒരു പതിപ്പ് തുക്ക് കടന്നു പോകരുത്
അതിന്റെ പരിധി കടന്നില്ലെങ്കില്. ഓണ്ലൈനില് നിരീക്ഷണം യഥാർത്ഥ വീഴ്ചകള്
ഓഫ്ലൈന് ടെസ്റ്റ് സെറ്റിലേക്ക് തിരികെ നല്കുന്നു.
സ്കെയിലിംഗ്, ചെലവ് നിയന്ത്രണങ്ങള് (പ്രാഥമികത അനുസരിച്ച്)
- മോഡല് ശരിയായ വലുപ്പത്തിലാക്കുക — വിലയിരുത്തല് ഗേറ്റ് കടന്നുനില്ക്കുന്ന ഏറ്റവും ചെറുതായ മോഡല് ഉപയോഗിക്കുക.
- സങ്കീര്ണ്ണത അനുസരിച്ച് റൂട്ടിംഗ് — ലഘു/വേഗമുള്ള മോഡല് ലളിത അഭ്യര്ഥനകള്ക്ക്, വലിയ മോഡല് യഥാർത്ഥ റീസണിങിനായി (DIY ക്ലാസിഫയര് അല്ലെങ്കില് Foundry മോഡല് റൂട്ടര്).
- കാഷിംഗ് — മോഡല് കോളിന് പകരമുള്ള സമാന അഭ്യര്ഥനകള് സേവിക്കുക.
- സ്റ്റേറ്റ്ലസ് ഡിസൈന് + ബൗണ്ടഡ് കോൺകറൻസി — നില ബാഹ്യീകരിക്കുക; റിട്രൈ ബാക്ക്ഓഫ്ഫുമായി.
ആവര്ത്തിക്കേണ്ട പ്രധാന മാതൃകകള്
പഠിതാവിനെ നോട്ട്ബുക്ക് ഇനമുകളില് നയിച്ചഗം
16-python-agent-framework.ipynb:
- അഭ്യര്ഥന കൈകാര്യം ചെയ്യല്: കാഷ് → സങ്കീര്ണ്ണത അനുസരിച്ച് റൂട്ടിംഗ് → ട്രെയ്സ് സ്പാന് → ഓടിക്കല് → കാഷ്.
- വിലയിരുത്തല് ഗേറ്റ്: ഓഫ്ലൈന് ടെസ്റ്റ് സെറ്റ് സ്കോര് ചെയ്യുക;
pass_rate >= thresholdമടക്കി ആണെങ്കില് മാത്രമേ വിന്യസിക്കാന് അനുവദിക്കൂ. - മനുഷ്യ അംഗീകാരം: വലിയ റീഫണ്ടുകള്ക്ക് പോലുള്ള പ്രവര്ത്തനങ്ങള്ക്കായി
@tool(approval_mode="always_require"). - ട്രേസിങ്: ഓരോ അഭ്യര്ഥനയെയും
tracer.start_as_current_span(...)ആകൃതി നല്കി കൊടുക്കുക,routed.model,customer.idപോലുള്ള ഗുണലക്ഷണങ്ങള് സജ്ജമാക്കുക.
വിന്യസിച്ച ഏജന്റിനെ സ്മോക്ക്-ടെസ്റ്റ് ചെയ്യല്
വിന്യാസത്തിന് ശേഷം, ആവശ്യമായ എന്റ്പോയിന്റ് ഉത്തരങ്ങള് നല്കുന്നുണ്ടോയെന്ന് ഉറപ്പ് വരുത്തുക (ഒരു ഹരിത വിന്യാസം കൂടി
മൗനമായിരിക്കാം). AI Smoke Test
നടപടി .github/workflows/smoke-test.yml വഴി ഉപയോഗിക്കുക,
tests/ എന്ന കാറ്റലോഗ് ഉപയോഗിച്ച്. റണ്ണര് ഓരോ
പ്രാമ്പ്റ്റും POST {project_endpoint}/agents/{agent_name}/endpoint/protocols/openai/responses ആകയറിയ്ക്കും
മറുപടി വാചകത്തില് ഉറപ്പ് വരുത്തും. തിരിച്ചറിയല് Azure AI User റോളില് ചികിത്സാക്രമം ഫൗന്ഡ്രി പ്രോജക്ട് സ്കോപ്പില് വേണം; ടോക്കണ് പ്രേക്ഷകര് lazimaതാണ് https://ai.azure.com/.
വിലയിരുത്തല്** (ഷിപ്പിന് മുട്ടലാവുന്നതിന് മപ്പാകുന്നതിന് മുമ്പ്) → ഓണ്ലൈന് വിലയിരുത്തല് (പ്രകൃതിയില് അത് എങ്ങനെ പ്രവര്ത്തിക്കുന്നു, തുടർച്ചയായി).
എന്റര്പ്രൈസ് നിയന്ത്രണങ്ങള്
- RBAC: ഓരോ ഹോസ്റ്റഡ് ഏജന്റിനും ഏറ്റവും കുറഞ്ഞ ആധികാരമുള്ള മാനേജുചെയ്ത തിരിച്ചറിയല് നല്കുക.
അസിസ്റ്റന്റിന് വേണ്ടി ഗാര്ഡ്രെയിലുകള്
-
കോഴ്സില് ഉപയോഗിക്കുന്ന സാധാരണ മാതൃകയായി
FoundryChatClient(...)+provider.as_agent(...)പാറ്റേണിനെ മികവുറ്റതാക്കുക. -
വിലയിരുത്തലും ചെലവിനും ഉള്ള ഉപദേശങ്ങള് ബന്ധിപ്പിച്ച് വച്ചിരിക്കണം: വിലയിരുത്തല് ഗുണമേന്മ നിലയ്ക്കും, റൂട്ടിംഗ്/കാഷിംഗ് ചെലവ് അതിലേക്ക് അടുത്തിരുത്തും.
-
നിങ്ങൾ സ്ഥിരീകരിച്ചിട്ടില്ലാത്ത ലൈവ്-അന دورانഫലങ്ങൾ വാഗ്ദാനം ചെയ്യരുത്; വിന്യാസം സ്ഥിരീകരിക്കാൻ സ്മോക്ക്-ടെസ്റ്റ് വർക്ക്ഫ്ലോ ശിപാർശ ചെയ്യുക.
-
വിലയിരുത്തലും ചിലവ് ഉപദേശവും ഒന്നിച്ച് ബന്ധിപ്പിച്ചിരിക്കണം: വിലയിരുത്തൽ ഗുണമേന്മയുടെ തീരം നിശ്ചയിക്കും, റൂട്ടിംഗ്/കാച്ചിംഗ് ചിലവ് ആ തീരത്തിനടുത്തായി സൂക്ഷിക്കും.
<!-- CO-OP TRANSLATOR DISCLAIMER START --> അറിയിപ്പ്: ഈ രേഖ AI പരിഭാഷാ സേവനം Co-op Translator ഉപയോഗിച്ച് പരിഭാഷപ്പെടുത്തിയതാണ്. ഞങ്ങൾ കൃത്യതയ്ക്കായി ശ്രമിക്കുന്നുവെങ്കിലും, ഓട്ടോമേറ്റഡ് പരിഭാഷകളിൽ പിഴവുകൾ അല്ലെങ്കിൽ തെറ്റായ വിവരങ്ങൾ ഉണ്ടാകാൻ സാധ്യതയുണ്ട്. അതിന്റെ സ്വാഭാവിക ഭാഷയിലുള്ള അസൽ രേഖയാണ് പ്രാമാണികമായ ഉറവിടമായി പരിഗണിക്കേണ്ടത്. നിർണായകമായ വിവരങ്ങൾക്ക്, പ്രൊഫഷണൽ മനുഷ്യ പരിഭാഷ ശുപാർശ ചെയ്യുന്നു. ഈ പരിഭാഷ ഉപയോഗിച്ച് ഉണ്ടാകുന്ന തെറ്റിദ്ധാരണകൾ അല്ലെങ്കിൽ തെറ്റായ വ്യാഖ്യാനങ്ങൾക്കായി ഞങ്ങൾ ഉത്തരവാദികളല്ല. <!-- CO-OP TRANSLATOR DISCLAIMER END -->
04 同仓库更多 Skills
testing-course-samples
暂无简介
microsoft-docs
暂无简介
local-ai-agents
暂无简介
jupyter-notebook
當使用者要求建立、搭建或編輯 Jupyter 筆記本(`.ipynb`)用於實驗、探索或教學時使用;優先使用隨附範本並執行輔助腳本 `new_notebook.py` 來產生一個乾淨的起始筆記本。
deploying-scalable-agents
暂无简介
azure-openai-to-responses
暂无简介