스킬 agent-framework
📦

agent-framework

안전 🔑 환경 변수

使用 Microsoft Agent Framework 建構 AI 代理程式

使用 Microsoft Agent Framework SDK 建立 AI 代理程式和多代理程式工作流程。此技能可使用工具、HTTP 伺服器支援和 VSCode 偵錯設定來建立企業 AI 應用程式的代理程式專案結構。

지원: Claude Codex Code(CC)
🥉 76 브론즈
1

스킬 ZIP 다운로드

2

Claude에서 업로드

설정 → 기능 → 스킬 → 스킬 업로드로 이동

3

토글을 켜고 사용 시작

테스트해 보기

"agent-framework" 사용 중입니다. 建立一個名為 'WeatherAgent' 可以查詢天氣的代理程式

예상 결과:

此技能會產生:具有固定 agent-framework 版本的 requirements.txt、包含 ChatAgent 設定和天氣工具的 main.py、適用於 FOUNDRY_PROJECT_ENDPOINT 和 FOUNDRY_MODEL_DEPLOYMENT_NAME 的 .env 檔案範本、用於偵錯的 .vscode/launch.json 和 .vscode/tasks.json

"agent-framework" 사용 중입니다. 建構 Writer-Reviewer 工作流程

예상 결과:

此技能會產生:建立內容的 Writer 執行器、提供回饋的 Reviewer 執行器、連接兩個代理程式的 WorkflowBuilder 設定、處理即時輸出的 run_stream 事件處理

보안 감사

안전
v1 • 2/21/2026

This is an official Microsoft skill for creating AI agents using Microsoft Agent Framework SDK. The static scanner flagged 165 potential issues, but evaluation confirms all are false positives. The flagged backtick patterns are Markdown code fences in documentation files. The skill appropriately uses .env files for storing Azure Foundry credentials (FOUNDRY_PROJECT_ENDPOINT, FOUNDRY_MODEL_DEPLOYMENT_NAME), which is a standard and secure practice for credential management.

7
스캔된 파일
785
분석된 줄 수
2
발견 사항
1
총 감사 수
중간 위험 문제 (1)
Environment File Access
The skill creates .env files to store Azure Foundry project endpoint and model deployment name credentials.

위험 요인

🔑 환경 변수 (1)
감사자: claude

품질 점수

45
아키텍처
100
유지보수성
87
콘텐츠
50
커뮤니티
100
보안
91
사양 준수

만들 수 있는 것

企業 AI 應用程式開發

在企業 Azure 環境中建構具有類型安全、檢查點和編排的生產級 AI 代理程式。

多代理程式工作流程原型設計

使用 Writer-Reviewer 模式、循環和人類介入互動來建立和測試多代理程式工作流程。

VSCode 偵錯設定

使用 AI Toolkit Agent Inspector 設定本機偵錯,以進行互動式代理程式測試和疑難排解。

이 프롬프트를 사용해 보세요

建立基本代理程式
建立一個使用 Microsoft Agent Framework 的新 AI 代理程式,可以回應使用者查詢。包含 HTTP 伺服器模式支援。
建立具有工具的代理程式
使用函式呼叫模式建構具有自訂工具的代理程式。為代理程式新增至少 2 個自訂工具。
建立多代理程式工作流程
建立多代理程式工作流程,包含生成內容的 Writer 代理程式和提供回饋的 Reviewer 代理程式。使用工作流程建構器模式。
建立循環工作流程
建構多代理程式循環工作流程,讓 Teacher 代理程式和 Student 代理程式互動。包含最多 5 次迭代的回合制控制。

모범 사례

  • 始終使用固定的 SDK 版本(agent-framework 為 1.0.0b260107)以避免預覽版發布造成破壞性變更
  • 使用虛擬環境(.venv)來隔離相依套件並避免衝突
  • 將 HTTP 伺服器模式設定為預設進入點,以獲得更好的偵錯和容器化支援
  • 在 .env 檔案中固定環境變數,但提醒使用者在執行前更新值

피하기

  • 使用未啟用虛擬環境的裸 'python' 或 'pip' 命令
  • 當使用者需要 HTTP 端點存取時跳過伺服器模式
  • 使用舊版的 AzureAIAgentClient 而非目前的 AzureAIClient
  • 未固定 SDK 版本導致預覽版發布造成破壞性變更

자주 묻는 질문

此技能支援什麼程式語言?
此技能僅支援 Python。Microsoft Agent Framework SDK for JavaScript/TypeScript 需要不同的技能。
我需要 Azure 訂閱嗎?
是的,您需要具有已部署模型的 Azure AI Foundry 專案。此技能會幫助您設定 FOUNDRY_PROJECT_ENDPOINT 和 FOUNDRY_MODEL_DEPLOYMENT_NAME 環境變數。
我可以在本機偵錯代理程式嗎?
是的,此技能會產生用於使用 AI Toolkit Agent Inspector 進行偵錯的 .vscode 設定。這提供互動式偵錯和訊息流程視覺化。
這裡的 MCP 是什麼?
MCP(模型內容通訊協定)是將 AI 代理程式連接到外部工具的標準。此技能支援 stdio 型和 HTTP 型的 MCP 工具。
為什麼要固定 SDK 版本?
agent-framework SDK 處於預覽版(測試版)。版本 1.0.0b260107 是穩定的版本。後續版本可能會有破壞性變更,例如類別重新命名(AgentRunResponseUpdate vs AgentResponseUpdate)。
什麼是代理程式即伺服器模式?
此模式使用 azure-ai-agentserver 套件將您的代理程式/工作流程包裝在 HTTP 伺服器中。它支援容器化、部署至 Azure Foundry,以及與其他服務整合。