المهارات agent-framework-azure-ai-py
📦

agent-framework-azure-ai-py

آمن ⚡ يحتوي على سكربتات⚙️ الأوامر الخارجية🌐 الوصول إلى الشبكة

建置 Azure AI Foundry 代理程式

使用 Microsoft Agent Framework Python SDK 在 Azure AI Foundry 上建立持久化 AI 代理程式。此技能提供程式碼範例,用於建置具有託管工具、函式工具和對話執行緒的代理程式。

يدعم: Claude Codex Code(CC)
📊 71 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "agent-framework-azure-ai-py". 建立基本的 Azure AI 代理程式

النتيجة المتوقعة:

代理程式將使用 AzureAIAgentsProvider 建立。然後可以使用設定的指示和工具處理使用者查詢並回傳回應。

استخدام "agent-framework-azure-ai-py". 西雅圖的天氣如何?

النتيجة المتوقعة:

西雅圖天氣:72°F,晴朗

استخدام "agent-framework-azure-ai-py". 計算 20 的階乘

النتيجة المتوقعة:

代理程式使用 HostedCodeInterpreterTool 執行 Python 程式碼並回傳結果:2432902008176640000

التدقيق الأمني

آمن
v1 • 2/24/2026

All 57 static findings are false positives. The skill contains only documentation and code examples for building Azure AI Foundry agents using the Microsoft Agent Framework Python SDK. The detected patterns (import statements, async context managers, markdown backticks, placeholder URLs) are legitimate documentation elements, not security risks.

1
الملفات التي تم فحصها
339
الأسطر التي تم تحليلها
3
النتائج
1
إجمالي عمليات التدقيق
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
20
المجتمع
100
الأمان
100
الامتثال للمواصفات

ماذا يمكنك بناءه

建置客戶服務代理程式

建立持久化 AI 代理程式,在多次互動中維持對話上下文

具工具的研究助理

建置能夠搜尋網頁、執行程式碼並分析結果的代理程式

企業工作流程自動化

建立透過 MCP 工具與企業系統整合的代理程式

جرّب هذه الموجهات

基本代理程式設定
使用 agent-framework-azure-ai-py 技能建立名為 'MyAgent' 的 Azure AI Foundry 代理程式,指示為 'You are a helpful assistant'。
具函式工具的代理程式
建立一個能夠取得天氣資訊的代理程式。定義一個 get_weather 函式,接受 location 參數並回傳天氣資料。
具託管工具的代理程式
使用 HostedCodeInterpreterTool 和 HostedWebSearchTool 建置一個能夠執行 Python 程式碼並搜尋網頁的代理程式。
多回合對話
建立一個使用執行緒管理在多個回合中維持對話上下文的代理程式。

أفضل الممارسات

  • 一律使用 async 上下文管理器 (async with) 以進行適當的資源清理
  • 直接將函式傳遞給 tools 參數 - 它們會自動轉換為 AIFunction
  • 對函式參數使用 Annotated[type, Field(description=...)] 以提供清晰的描述
  • 對多回合對話使用 get_new_thread() 以維持上下文

تجنب

  • 不要在 async 函式中使用同步操作 - 這會導致死結
  • 避免硬編碼憑證 - 請使用 AzureCliCredential 或 DefaultAzureCredential
  • 不要跳過 async 上下文管理器 - 對提供者一律使用 'async with'
  • 避免直接傳遞非 async 函式而沒有適當的包裝

الأسئلة المتكررة

什麼是 Azure AI Foundry?
Azure AI Foundry 是 Microsoft 的平台,用於大規模建置、部署和管理 AI 應用程式和代理程式。
我需要 Azure 訂閱嗎?
是的,您需要已配置 Azure AI Foundry 的 Azure 訂閱才能使用此技能。
支援哪些驗證方法?
開發時使用 AzureCliCredential,生產部署時使用 DefaultAzureCredential。
我可以將 Claude Code 與 Azure AI 代理程式一起使用嗎?
是的,此技能可與 Claude、Codex 和 Claude Code 搭配使用,用於建置 Azure AI Foundry 代理程式。
什麼是託管工具?
託管工具是 Azure 管理的功能,包括代理程式可使用的程式碼解譯器、檔案搜尋和網頁搜尋。
如何管理對話狀態?
使用執行緒物件 (get_new_thread()) 在多次代理程式互動中維持對話上下文。

تفاصيل المطور

بنية الملفات

📄 SKILL.md