技能 azure-ai-projects-ts
📦

azure-ai-projects-ts

安全

使用 Azure AI Projects SDK 建構 AI 應用程式

Azure AI Projects SDK 簡化了使用代理、連線和評估建構 AI 應用程式的流程。此技能提供全面的 TypeScript 範例,用於 Azure AI Foundry 開發。

支援: Claude Codex Code(CC)
🥉 74 青銅
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「azure-ai-projects-ts」。 建立具有自訂指示的基本代理以進行客戶支援

預期結果:

  • 代理建立成功:customer-support-agent v1.0
  • 模型:gpt-4o
  • 工具:無
  • 狀態:準備就緒可部署

正在使用「azure-ai-projects-ts」。 列出依 OpenAI 發布者篩選的可用模型部署

預期結果:

  • gpt-4o - OpenAI - 狀態:已部署
  • gpt-4-turbo - OpenAI - 狀態:已部署
  • text-embedding-3-large - OpenAI - 狀態:已部署

安全審計

安全
v1 • 2/24/2026

Static analyzer produced false positives by misinterpreting markdown code block delimiters (```) as shell commands. The file contains only documentation and code examples for the official Azure AI Projects SDK. URLs are placeholder examples with template values. Environment variable access follows standard best practices. No executable code or security risks present.

1
已掃描檔案
295
分析行數
0
發現項
1
審計總數
未發現安全問題
審計者: claude

品質評分

38
架構
100
可維護性
87
內容
50
社群
100
安全
91
規範符合性

你能建構什麼

企業 AI 代理開發

建構具生產就緒的 AI 代理,具有程式碼解譯器、檔案搜尋和網頁搜尋功能,適用於企業工作流程。

RAG 應用程式設定

設定 Azure AI Search 索引和代理,用於自訂文件集合的檢索增強生成。

AI 評估管線

設定評估器和資料集,以衡量和改善 AI 模型在不同指標上的效能。

試試這些提示

基本代理建立
使用 Azure AI Projects SDK 建立基本 AI 代理,回應使用者問題並提供有用的答案。包含適當的認證和錯誤處理。
具有檔案搜尋功能的代理
建構可使用 Azure AI Search 搜尋已上傳文件的 AI 代理。包含建立索引、上傳檔案和設定具有檔案搜尋工具的代理的步驟。
多工具代理設定
建立結合程式碼解譯器、檔案搜尋和自訂函式工具的 AI 代理。展示如何處理工具執行和回應聚合。
評估管線設定
使用 Azure AI 評估器設定完整的評估管線。包含資料集上傳、指標設定和結果分析,以衡量代理效能。

最佳實務

  • 使用 getOpenAIClient() 方法進行聊天完成、對話和檔案操作
  • 使用 createVersion 對代理進行版本控制,以實現可重複和可追蹤的部署
  • 不再需要時刪除代理和對話以清理資源
  • 將憑證儲存在環境變數中,並使用連線進行安全存取
  • 依 modelPublisher 篩選部署以有效尋找特定模型類型

避免

  • 硬編碼憑證而非使用環境變數或連線
  • 建立未版本化的代理,使回滾和追蹤變得困難
  • 使用後讓對話和代理版本保持活動狀態,累積成本
  • 忽略網路操作和 API 呼叫的錯誤處理

常見問題

使用此 SDK 需要哪些 Azure 資源?
您需要在 Azure AI Foundry 中擁有 Azure AI 專案。這需要 Azure 訂閱和您所在區域的 Azure AI 服務存取權限。
Azure AI Projects 的認證如何運作?
使用 DefaultAzureCredential 進行自動認證。它支援 Azure CLI、受控身分識別和服務主體。設定 AZURE_AI_PROJECT_ENDPOINT 環境變數。
我可以在沒有 Azure 訂閱的情況下使用此技能嗎?
不行。Azure AI Projects SDK 需要有效的 Azure 訂閱和 Azure AI 專案。測試可能有免費層選項可用。
代理和 OpenAI 用戶端之間有什麼區別?
代理提供更高层次的抽象,具有內建工具和記憶體。OpenAI 用戶端提供直接存取聊天完成和低階 API 功能。
如何為我的代理新增自訂工具?
使用名稱、說明和 JSON 結構描述參數定義函式工具。使用 tools 陣列在建立代理版本時註冊它們。
此技能可以在我的系統上執行程式碼嗎?
不行。此技能僅提供文件和程式碼範例。程式碼解譯器工具在 Azure 的沙盒環境中執行,而非您的本機系統。

開發者詳情

檔案結構

📄 SKILL.md