microsoft-foundry
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseMicrosoft Foundry Skill
Microsoft Foundry 技能
This skill provides expert guidance for Microsoft Foundry. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
本技能提供Microsoft Foundry相关的专业指导,覆盖故障排查、最佳实践、决策指引、架构与设计模式、限制与配额、安全、配置、集成与编码模式以及部署相关内容,同时结合了本地速查内容与远程文档拉取能力。
How to Use This Skill
如何使用本技能
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,), useL35-L120with the specified lines. For categories with file links (e.g.,read_file), use[security.md](security.md)on the linked reference fileread_file
IMPORTANT for Agent: Ifis more than 3 months old, suggest the user pull the latest version from the repository. Ifmetadata.generated_attools are not available, suggest the user install it: Installation Guidemcp_microsoftdocs
This skill requires network access to fetch documentation content:
- Preferred: Use with query string
mcp_microsoftdocs:microsoft_docs_fetch. Returns Markdown.from=learn-agent-skill - Fallback: Use with query string
fetch_webpage. Returns Markdown.from=learn-agent-skill&accept=text/markdown
Agent 重要提示:使用下方的分类索引定位相关章节。对于标注了行范围的分类(例如),使用L35-L120读取指定行内容。对于带有文件链接的分类(例如read_file),使用[security.md](security.md)读取关联的参考文件。read_file
本技能需要网络访问来拉取文档内容:
- 优先方案:使用配合查询参数
mcp_microsoftdocs:microsoft_docs_fetch调用,返回Markdown格式内容。from=learn-agent-skill - 兜底方案:使用配合查询参数
fetch_webpage调用,返回Markdown格式内容。from=learn-agent-skill&accept=text/markdown
Category Index
分类索引
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L41 | Known issues, error codes, limitations, and current workarounds for Microsoft Foundry features, deployments, integrations, and runtime behavior. |
| Best Practices | L42-L52 | Best practices for configuring tools, prompts, system messages, vision models, fine-tuning, evaluation, and performance (latency/throughput) for Azure OpenAI agents in Foundry |
| Decision Making | L53-L80 | Guides for choosing models, SDKs, deployment types, costs, and migrations (Azure OpenAI, GitHub Models, classic/preview) to design and upgrade Foundry-based AI solutions. |
| Architecture & Design Patterns | L81-L93 | Architectural patterns for Foundry agents: standard setup, RAG/indexing, HA/DR, regional recovery, provisioned throughput, spillover traffic, and LLM routing optimization. |
| Limits & Quotas | L94-L109 | Limits, quotas, rate limits, regions, timeouts, caching, and cost controls for Foundry agents, models, vector search, batch jobs, Sora video, RFT, and Azure OpenAI access. |
| Security | L110-L142 | Security, identity, and compliance for Foundry: auth/RBAC, private networking, encryption/CMK, safety guardrails, policy/governance, data privacy, and secure tool/agent configuration. |
| Configuration | L143-L202 | Configuring Foundry agents, models, tools, storage, safety/guardrails, tracing, evaluators, and Azure OpenAI/Fireworks integrations for deployment, monitoring, and advanced capabilities. |
| Integrations & Coding Patterns | L203-L268 | Integrating Foundry agents and models with external apps, tools, and services: SDK usage, REST APIs, MCP/LangChain, search/speech/browsing tools, fine-tuning, realtime audio, safety, and evaluations. |
| Deployment | L269-L286 | Deploying and managing Foundry agents/models: infra setup, container/hosted deployments, Azure/M365 publishing, IaC (Bicep/Terraform), CI/CD evals, and regional availability. |
| 分类 | 行范围 | 描述 |
|---|---|---|
| 故障排查 | L37-L41 | Microsoft Foundry功能、部署、集成及运行时行为相关的已知问题、错误码、限制和现有解决方案。 |
| 最佳实践 | L42-L52 | 在Foundry中为Azure OpenAI Agent配置工具、提示词、系统提示词、视觉模型、微调、评估及性能(延迟/吞吐量)的最佳实践。 |
| 决策指引 | L53-L80 | 模型、SDK、部署类型、成本及迁移(Azure OpenAI、GitHub Models、经典/预览版)选择指南,用于设计和升级基于Foundry的AI解决方案。 |
| 架构与设计模式 | L81-L93 | Foundry Agent的架构模式:标准部署、RAG/索引构建、高可用/灾备、区域恢复、预置吞吐量、流量削峰、LLM路由优化。 |
| 限制与配额 | L94-L109 | Foundry Agent、模型、向量搜索、批量任务、Sora视频、RFT及Azure OpenAI访问相关的限制、配额、速率限制、区域支持、超时、缓存及成本控制规则。 |
| 安全 | L110-L142 | Foundry的安全、身份与合规相关内容:认证/RBAC、私有网络、加密/客户管理密钥(CMK)、安全护栏、政策/治理、数据隐私、工具/Agent安全配置。 |
| 配置 | L143-L202 | 配置Foundry Agent、模型、工具、存储、安全护栏、链路追踪、评估器,以及Azure OpenAI/Fireworks集成,用于部署、监控和高级能力扩展。 |
| 集成与编码模式 | L203-L268 | Foundry Agent和模型与外部应用、工具、服务的集成方案:SDK使用、REST API、MCP/LangChain、搜索/语音/浏览工具、微调、实时音频、安全、评估相关实现。 |
| 部署 | L269-L286 | Foundry Agent/模型的部署与管理:基础设施搭建、容器/托管部署、Azure/M365发布、IaC(Bicep/Terraform)、CI/CD评估、区域可用性相关内容。 |
Troubleshooting
故障排查
| Topic | URL |
|---|---|
| Review known issues and workarounds for Microsoft Foundry | https://learn.microsoft.com/en-us/azure/foundry/reference/foundry-known-issues |
| 主题 | URL |
|---|---|
| 查看Microsoft Foundry的已知问题和解决方案 | https://learn.microsoft.com/en-us/azure/foundry/reference/foundry-known-issues |
Best Practices
最佳实践
| Topic | URL |
|---|---|
| Apply tool configuration best practices for agents | https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/tool-best-practice |
| Evaluate Foundry agents with built-in quality and safety tests | https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/evaluate-agent |
| Optimize Foundry agent prompts with Prompt Optimizer | https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/prompt-optimizer |
| Design effective system messages for Azure OpenAI in Foundry | https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/advanced-prompt-engineering |
| Apply prompt engineering techniques for vision-enabled GPT models | https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/gpt-4-v-prompt-engineering |
| Fine-tune GPT-4 vision models with images | https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning-vision |
| Optimize Azure OpenAI latency and throughput in Foundry | https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/latency |
| 主题 | URL |
|---|---|
| 为Agent应用工具配置最佳实践 | https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/tool-best-practice |
| 使用内置质量和安全测试评估Foundry Agent | https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/evaluate-agent |
| 使用提示词优化器优化Foundry Agent提示词 | https://learn.microsoft.com/en-us/azure/foundry/observability/how-to/prompt-optimizer |
| 为Foundry中的Azure OpenAI设计有效的系统提示词 | https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/advanced-prompt-engineering |
| 为支持视觉能力的GPT模型应用提示词工程技巧 | https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/gpt-4-v-prompt-engineering |
| 使用图像微调GPT-4视觉模型 | https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/fine-tuning-vision |
| 优化Foundry中Azure OpenAI的延迟和吞吐量 | https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/latency |
Decision Making
决策指引
Architecture & Design Patterns
架构与设计模式
| 主题 | URL |
|---|---|
| 设计资源隔离的标准Agent部署架构 | https://learn.microsoft.com/en-us/azure/foundry/agents/concepts/standard-agent-setup |
| 在Foundry中应用RAG和索引模式 | https://learn.microsoft.com/en-us/azure/foundry/concepts/retrieval-augmented-generation |
| 为标准模式的Foundry Agent服务规划灾备方案 | https://learn.microsoft.com/en-us/azure/foundry/how-to/agent-service-disaster-recovery |
| 从资源和数据丢失中恢复Foundry Agent服务 | https://learn.microsoft.com/en-us/azure/foundry/how-to/agent-service-operator-disaster-recovery |
| 从区域平台故障中恢复Foundry Agent服务 | https://learn.microsoft.com/en-us/azure/foundry/how-to/agent-service-platform-disaster-recovery |
| 为Foundry项目和Agent规划高可用和弹性能力 | https://learn.microsoft.com/en-us/azure/foundry/how-to/high-availability-resiliency |
| 在Foundry中使用模型路由器优化LLM路由 | https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/model-router |
| 为Foundry模型规划预置吞吐量架构 | https://learn.microsoft.com/en-us/azure/foundry/openai/concepts/provisioned-throughput |
| 为预置吞吐量部署设计流量削峰管理方案 | https://learn.microsoft.com/en-us/azure/foundry/openai/how-to/spillover-traffic-management |