Azure.AI.Agents.Persistent (.NET)
使用 Azure AI SDK for .NET 建立持久性 AI 代理程式
開發人員需要將持久性 AI 代理程式整合到 .NET 應用程式中，並進行適當的執行緒管理和串流處理。此技能提供完整的 SDK 模式，用於代理程式 CRUD、對話流程、函式呼叫，以及使用 Azure AI 代理程式進行檔案搜尋。
下載技能 ZIP
在 Claude 中上傳
前往 設定 → 功能 → 技能 → 上傳技能
開啟並開始使用
測試它
正在使用「Azure.AI.Agents.Persistent (.NET)」。 建立具有程式碼解譯器啟用的數學家教代理程式
預期結果:
代理程式建立成功，ID 為 'asst_abc123'。代理程式已設定使用 gpt-4o-mini 模型和 CodeInterpreterTool。指示：'您是個人數學家教。撰寫並執行程式碼來回答數學問題。' 準備好建立執行緒並處理使用者訊息。
正在使用「Azure.AI.Agents.Persistent (.NET)」。 從代理程式串流回應使用者關於求解 3x + 11 = 14 的問題
預期結果:
串流輸出：'要解 3x + 11 = 14，我需要找出 x。首先，從兩邊減去 11：3x = 3。然後除以 3：x = 1。讓我用程式碼驗證這一點。' 執行完成，最終答案顯示 x 等於 1。
安全審計
安全Documentation-only skill with no executable code. Static analysis found 0 security issues with risk score 0/100. The SKILL.md file contains legitimate Azure SDK usage examples for agent creation, thread management, streaming, and function calling. No security concerns identified.
品質評分
你能建構什麼
建立數學家教代理程式
建立一個使用程式碼解譯器解決數學問題的持久性代理程式。使用者透過執行緒訊息提交問題，代理程式會執行 Python 程式碼來計算答案並提供逐步解釋。
文件搜尋助理
實作具有向量儲存體檔案搜尋功能的代理程式，以回答關於已上傳文件的問題。上傳檔案、建立向量儲存體，並透過自然語言對話進行查詢。
具有函式呼叫的天氣機器人
建構一個透過函式定義呼叫外部天氣 API 的代理程式。定義工具結構描述、處理 RequiresAction 回應，並將格式化天氣資料回傳給使用者。
試試這些提示
使用 Azure.AI.Agents.Persistent SDK 建立持久性 AI 代理程式。代理程式應使用 gpt-4o-mini 模型，並指示其扮演有用的助理。展示使用 DefaultAzureCredential 的驗證和基本代理程式建立程式碼。
展示如何使用 CreateRunStreamingAsync 即時串流代理程式回應。包括處理 MessageContentUpdate 和執行狀態事件，例如 RunCreated 和 RunCompleted。
建立具有取得天氣資料自訂函式工具的代理程式。使用 JSON 結構描述參數定義 FunctionToolDefinition、處理 RequiresAction 狀態，並將工具輸出提交回執行。
為代理程式設定檔案搜尋功能。上傳文件檔案、使用檔案 ID 建立向量儲存體、設定 FileSearchToolResource，並建立可搜尋文件以回答問題的代理程式。
最佳實務
- 務必使用 'using' 陳述式或明確處置來釋放資源
- 輪詢代理程式執行時，每次狀態檢查之間延遲 500ms 以避免速率限制
- 完成後刪除執行緒、代理程式和向量儲存體以清理資源
避免
- 呼叫代理程式 API 時不要略過 RequestFailedException 的錯誤處理
- 避免直接在應用程式程式碼中硬編碼認證或端點 URL
- 避免沒有延遲的緊密輪詢，這可能會觸發速率限制