待核实事实清单

由脚本汇总各页中含“待核实”的行（2026-11-05）。这些内容不能作为结论引用，核实后应改写正文并删除标记。

第一个检索索引

• | Azure AI Search 服务 | 向导要求 Basic 或更高层级（托管标识支持） | 待核实（2026-11-05 获取） |

• | 嵌入模型 | Azure OpenAI 或 Microsoft Foundry 中的文本嵌入模型（页面列出 text-embedding-ada-002、text-embedding-3-small、text-embedding-3-large 等） | 模型可用区域与退役计划：待核实（2026-11-05 获取） |

• - 待核实（2026-11-05 获取）：服务层级要求、嵌入模型的区域可用性与退役日期、各资源计费。

检索延迟与质量基准

• - 页面中只有两条定性声明：混合检索加语义排序在相关性上有明显收益；语义排序对前 50 个结果重排（后者已在语义排序页面说明）。前者未核对具体数据，待核实。

• | 端到端延迟（p50、p95） | 从客户端发出请求到收到完整响应的时间 | 在与服务同区域的客户端计时，排除首次冷启动 | 待核实（2026-11-05 获取） |

• | 吞吐与节流 | 单位时间可处理的查询数，以及被限流的比例 | 逐步加压，记录失败与限流响应 | 待核实 |

• | 索引规模与配置 | 文档数、索引大小、副本与分区数 | 每次测试都记录 | 待核实 |

• ## 限制与待核实

• - 官方公布的延迟、吞吐与质量基准数字：待核实（2026-11-05 获取）。

• - 不同区域、层级与模型版本之间的差异：待核实。

• - 待核实：官方基准数字、各层级吞吐与延迟、测试方法的官方建议。

性能调优要点

• - 能在调整前后对同一组查询做延迟与失败次数的对比（监控方法本页未核对：待核实）。

• - 扩容后观察副本与分区生效的时间：待核实。

• ## 限制与待核实

• - 各层级的存储上限、副本与分区上限，以及价格：待核实（2026-11-05 获取）。

• - 页面链接中的大规模索引导入与监控页面本次未读取：待核实。

• - 待核实（2026-11-05 获取）：各层级容量与价格，扩容生效时间。

网络与身份

• Azure AI Search 的传输加密、平台内置保护、身份与角色、网络访问的要点速查。页面未展开的配置细节均标注为待核实。

• | 客户托管密钥 | 可选，在服务托管加密之上再加一层加密（配置方法：待核实） |

• | API 密钥 | 当角色无法配置时的替代认证方式（具体密钥管理与轮换：待核实） | 正文已读（仅提及） |

• | 防火墙与专用终结点的具体步骤 | 配置路径与限制 | 待核实（2026-11-05 获取） |

• ## 限制与待核实

• - 各层级对专用终结点、防火墙、客户托管密钥的支持差异：待核实（2026-11-05 获取）。

• - 机密计算（confidential computing）的区域可用性与成本：待核实。

• - 出站连接（如对外部技能或模型端点的访问）的配置方式：待核实。

• - 网络与身份的最佳实践清单，页面链接的安全最佳实践页面本次未读取：待核实。

• - 待核实：防火墙与专用终结点的具体配置、客户托管密钥、机密计算、出站连接。

安全过滤（Security filter）

• - 本模式不做认证。调用方身份如何可信地获取，页面未展开：待核实，需结合具体身份方案设计。

• - 权限变化时需要同步更新索引中的标识字段。页面只给出 merge 示例，同步的频率与机制：待核实。

• - 页面称 search.in 的过滤可达亚秒级响应，相较多个等值比较更快；具体延迟数值：待核实（2026-11-05 获取）。

• - 待核实：身份的可信获取方式、权限同步机制、延迟数值。

全文、向量与混合检索

• ## 限制与待核实

• - 2024 年 4 月 3 日后创建的服务有更高的向量索引配额（页面写明）；具体配额数值：待核实（2026-11-05 获取）。

• - 向量功能在所有区域与层级可用，本身不额外收费；生成嵌入或使用 AI 向量化可能产生模型提供方的费用（页面写明）。具体单价：待核实（2026-11-05 获取）。

• - 页面提到基准测试显示“混合检索加语义排序”在相关性上有明显收益，但本次未核对具体基准数据：待核实。

• - 向量查询参数（k、oversampling、exhaustive 等）的取值建议，本页未展开核对：待核实。

语义排序

• | 查询改写（query rewrite） | 把文本查询扩展为最多 10 个变体，修正拼写或加入同义表达 | 预览状态：待核实（2026-11-05 获取） |

• - 免费额度、单价、区域可用性：待核实（2026-11-05 获取）。

• ## 限制与待核实

• - 查询改写目前为预览功能，预览状态与可用区域：待核实。

• - 语义答案与标题的质量依赖文档内容，本页未做评测：待核实。

• - 待核实（2026-11-05 获取）：计费单价与免费额度、区域可用性、查询改写的预览状态。

索引字段设计

• ## 限制与待核实

• - 页面给出的 32 KB 上限、索引大小估算方法为抓取日期时的说明，具体数值以当前官方参考为准：待核实（2026-11-05 获取）。

• - 本页未核对向量字段的维度上限与各层级的字段数上限：待核实。

• - 待核实：字段数与向量维度上限、字段长度上限的当前值。

分块策略

• | maximumPageLength | pages 模式下每块的最大长度，按字符计或按 token 计（token 计量为预览版本能力：待核实） |

• ## 限制与待核实

• - 按 token 分块的能力在预览版 API 中提供，GA 状态与参数名：待核实（2026-11-05 获取）。

• - 嵌入模型的输入上限会随模型版本变化，使用前需核对当前模型文档：待核实。

• - 待核实（2026-11-05 获取）：token 分块的预览状态、模型输入上限的当前值。

Responses API

• | Code Interpreter | 沙箱中运行 Python，除令牌费用外另有费用（待核实）；每会话最少计费 5 分钟，空闲 20 分钟超时；每请求最多 50 个文件 ID，每容器 1,000 个文件 |

• - 官方页面列出的支持模型族包括 GPT-6.x、GPT-5.x（含 codex、chat 等变体）、gpt-chat-latest、gpt-4o、gpt-4.1、o 系列、图像模型与 computer-use-preview（具体版本以官方列表为准，待核实）。

• - 页面列出 32 个可用区域（待核实，2026-11-05 获取），并注明最新功能需要 v1 API。

• - 页面未明确标注 Responses API 为预览或正式版（GA）。页面提到 v1 API 为最新功能所需，并链接到 API 版本生命周期页面和 v1-preview 的 REST 参考视图。预览状态：待核实（2026-11-05 获取）。

• - 令牌费用按模型定价计算；Code Interpreter 的额外费用与定价页面以官方为准（待核实）。

• - 获取日期：2026-11-05。区域数量、模型版本、预览状态与 Code Interpreter 费用均待核实。

函数调用

• | 部署 | 支持 Chat Completions 或 Responses 函数调用的模型部署；支持情况随模型、API、部署类型与版本而变（待核实） |

• - 获取日期：2026-11-05。模型支持范围与版本待核实。

结构化输出

• | Chat Completions 字段 | 旧 JSON mode 的具体参数名：待核实（本次未读取 JSON mode 页面） | response_format，并设置 JSON Schema |

• | Responses API 字段 | 待核实（本次未读取 JSON mode 页面） | text.format |

• | 模型 | 官方列出的模型与版本（示例：gpt-5、gpt-5-mini、gpt-5.1、gpt-4o 2024-08-06、gpt-4.1 2025-04-14 等）；完整列表以官方页面为准（待核实） |

• - 获取日期：2026-11-05。模型版本清单、API 版本与示例中的模型名称待核实。

第一次调用 Azure OpenAI

• 用一个最小的 Python 脚本，对已部署的 Azure OpenAI 模型发起第一次请求，并看到文本输出。本页只走通调用这一段；资源创建与模型部署的完整步骤待核实。

• | Azure 订阅，且已有 Azure OpenAI 或 Foundry 资源 | 待核实（快速入门页面本次未能抓取，见“来源与核对”） |

• | 已在资源中部署一个模型，并记下部署名称（deployment name） | 待核实 |

• 1. 在资源中完成模型部署，记下部署名称。资源与部署的具体操作：待核实。

• - 若使用 Entra ID，需先完成 az login 或等效登录，并确保身份具备相应数据平面角色（具体角色名称待核实）。

• - 删除资源的具体步骤：待核实。

从 Azure OpenAI 资源升级到 Foundry

• | Foundry Models sold by Azure | 仅 Azure OpenAI 模型 | 含 Azure OpenAI 以及其他供应商模型（待核实清单） |

• - 新增功能（更大的模型目录、Agent 服务、评测）可能有各自的计费方式，待核实，需用 Azure 定价计算器估算。

• ## 限制与待核实

• - 回滚与升级的时间窗口、门户入口名称（经过 Foundry 门户改版）均可能变化，待核实。

• - 获取日期：2026-11-05。区域、模型清单与门户入口名称待核实。

配额与速率限制

• | 生效时间 | 官方称订阅级配额管理自 2026-05-07 起在 Foundry 中推行，并将逐步覆盖所有模型（待核实） |

• | 要点 | 说明（2026-11-05 获取，待核实） |

• ### 典型默认值示例（待核实，2026-11-05 获取）

• | 模型（示例） | 每月用量阈值（待核实，2026-11-05 获取） |

• | 限制项 | 数值（待核实，2026-11-05 获取） |

• | 限制项 | 数值（待核实，2026-11-05 获取） |

• | 全局 Batch 入队令牌额度（gpt-4.1，企业与 MCA-E） | 50 亿；默认值 2 亿（待核实） |

• - 即使令牌用量指标低于配额，也可能出现 429；官方有单独的说明，本页未展开（待核实）。

• ## 待核实

• - 获取日期：2026-11-05。数字一律待核实。

区域与可用性

• ## Global Standard 与 Data Zone Standard 的区域表（摘录，待核实）

• - 各模型在每个区域的逐行勾选（✅ 或 -）：以官方表格为准，本页未逐一核对（待核实，2026-11-05 获取）。

• 官方 Responses API 页面列出 32 个可用区域（待核实，2026-11-05 获取）：

• - 官方“功能区域”页列出可以创建 Foundry 项目的区域共 32 个（含 US Gov Arizona 与 US Gov Virginia；待核实）。

• - Azure Government（US Gov）区域的不支持功能包括 Batch 作业、微调、Azure OpenAI 评测等（官方列表，待核实）。

• ## 变更与待核实

• - 中国大陆区域的可用性本页未核实，需单独确认（待核实）。

• - 获取日期：2026-11-05。区域清单与可用性一律待核实。

计费与成本

• | Batch | 异步批处理，24 小时内完成为目标 | 按令牌计费，官方称比 Global Standard 低 50%（待核实，2026-11-05 获取） |

• ## 限制与待核实

• - 所有单价、折扣比例、Batch 的 50% 折扣、预留的期限与折扣幅度：待核实（2026-11-05 获取）。官方价格以 Azure OpenAI 定价页与 Azure 定价计算器为准，本页不引用具体数字。

• - Commitment 模型（2024 年 8 月前已开通的旧客户）仍可与小时计费并存，适用条件待核实。

• - 核对范围：正文已读（小时计费、预留与匹配规则、超量计费、升级成本说明已核对）。价格表未在官方页面中读取（页面仅链接到定价页），所有价格相关数字均待核实。

自定义视觉与沉浸式阅读器

• | 服务 | 页面描述（一句话） | 页面中的状态 | 待核实事项 |

• | Custom Vision | 为业务定制图像识别 | 列入“可用的 Foundry Tools”表 | 训练、预测与发布的步骤、区域与定价（待核实，2026-11-05 获取） |

• | Immersive Reader | 帮助用户阅读与理解文本 | 列入“可用的 Foundry Tools”表 | 功能范围、支持语言与集成方式（待核实，2026-11-05 获取） |

• - 页面元数据显示更新时间为 2026-07-13（页面元数据，待核实）。

• ## 限制与待核实

• - 两个服务的 SKU、免费层（页面称许多服务有 F0 免费层，但未逐一确认）、配额与区域：待核实（2026-11-05 获取）。

已退役服务与迁移

• 本页列出 Foundry Tools 服务总表中标注为“已退役”（retired）的六项服务，并说明当前的使用状态。迁移目标与具体步骤在本页均待核实。

• | Anomaly Detector | 尽早发现潜在问题 | 已退役，现有应用仍可用 | 待核实 |

• | Content Moderator | 检测潜在攻击性或不良内容 | 已退役，现有应用仍可用 | 待核实 |

• | Language understanding（LUIS） | 理解应用中的自然语言 | 已退役，现有应用仍可用 | 待核实 |

• | Metrics Advisor | 页面描述与 Content Safety 相同，疑为页面文字错误 | 已退役，现有应用仍可用 | 待核实 |

• | Personalizer | 为每个用户创建个性化体验 | 已退役，现有应用仍可用 | 待核实 |

• | QnA Maker | 把信息提炼为易于浏览的问答 | 已退役，现有应用仍可用 | 待核实 |

• | 替代服务的功能对等性 | 待核实，需逐项对照替代服务的文档 |

• | 退役日期 | 页面未在本表给出具体日期，待核实（2026-11-05 获取） |

• - 页面更新时间为 2026-07-13（页面元数据，待核实）。

• - 页面列出的状态为“计划退役”；页面未给出各服务的停止服务日期，待核实。

• ## 限制与待核实

• （另有 4 处，见页面原文）

检测与阻止策略

• Azure AI Content Safety 服务本身返回的严重度范围如下（页面所述，待核实）：

• - 核对范围：正文已读。本页依据该概念页的类别说明、Guardrails 严重度与阻止级别、Azure AI Content Safety 严重度范围，以及“选择阻止级别”小节。页面中未找到标题为“检测与阻止策略”的独立页面，本页内容由上述概念页整理，独立页面是否存在待核实。

内容安全快速开始

• | Content Safety 资源 | 在支持区域创建，选择定价层（F0 或 S0） | 区域列表待核实（2026-11-05 获取） |

• 4. 向 <endpoint>/contentsafety/text:analyze?api-version=2024-09-01 发送 POST 请求（页面示例版本，版本是否为当前版本待核实）。

• | 请求被拒绝（认证相关错误） | 检查密钥是否来自当前资源，以及账号是否具备 Cognitive Services User 角色；具体错误码待核实 |

• | 文本过长被拒绝 | 参照概览页的输入要求，上限数值待核实 |

• 删除不再使用的 Content Safety 资源或资源组。具体步骤本页未核对，待核实。

内容安全概览

• | AI 安全与提示防护 | Task adherence API | 检测智能体的工具调用是否偏离用户意图 | 待核实 |

• - 页面速率表（待核实，2026-11-05 获取）：F0 下文本与图像审核为 5 RPS；S0 下文本与图像审核为 1000 RP10S，基础性检测为 50 RPS。具体数值以定价与配额页面为准。

• ## 限制与待核实

• - API 版本弃用策略：预览版本在新预览版本发布后 90 天弃用；GA 版本在新 GA 版本发布后 90 天弃用（前提是兼容）。具体版本待核实。

• - 支持的区域与输入长度上限：待核实（2026-11-05 获取）。

内容理解快速开始

• | Foundry 资源 | 在受支持区域创建 Microsoft Foundry 资源 | 创建需要 Contributor 或更高角色（页面所述）；区域列表待核实 |

• | 工具 | cURL（REST）；SDK 示例需 Python 3.9+、.NET、JDK 8+ 与 Maven，或 JavaScript 工具链 | 页面所述；SDK 版本待核实 |

• - 仅在需要预览功能时使用 2026-06-01-preview。该版本为公开预览，页面建议用于评估而非生产，具体条款待核实。

• | 资源区域不支持 | 参照区域支持页面（本页未核对，待核实） |

• 删除不再使用的 Foundry 资源或资源组。具体步骤本页未核对，待核实。

• - 核对范围：正文已读，但仅覆盖页面前约 10 万字符，即前置条件、REST 步骤与版本说明。JavaScript 段未核对，相关内容待核实。

内容理解概览

• 下表依据页面的版本对比，获取日期为 2026-11-05。预览状态以页面声明为准，具体限制待核实。

• - 在自动化流程中使用结果前，应先审查警告；如需保留检测记录供人工复核，可使用仅标注（annotate-only）审批配置，细节待核实。

• ## 限制与待核实

• - 输入文件大小与格式限制：页面指向服务限制页，本页未核对，待核实。

• - 价格与计费（含上下文相关的 token 计费）：待核实（2026-11-05 获取）。

• - 区域可用性：待核实（2026-11-05 获取）。

• - 预览功能的 SLA 与生产使用限制：待核实。

概览与可用服务

• | Translator | 神经机器翻译；官方表述覆盖的语言与方言数量待核实 |

• - TPS 上限、价格与免费额度：待核实（2026-11-05 获取）。

• ## 限制与待核实

• - 区域可用性以 Azure 区域列表和各服务的区域页为准，本页不列区域。待核实（2026-11-05 获取）。

• - 语言支持以各服务的语言列表为准。待核实（2026-11-05 获取）。

• - 页面标题沿用 Foundry Tools，URL 路径仍为 ai-services，名称在不同页面间可能不一致。待核实。

• - 安全层面，官方提到 Microsoft Entra 凭据、资源密钥和 Azure 虚拟网络等机制。合规认证（CSA STAR、FedRAMP Moderate、HIPAA BAA）以信任中心为准，状态待核实（2026-11-05 获取）。

• - 数字、价格、TPS、区域与认证状态均未在本页确认，已标注待核实。

文档智能快速开始

• | 定价层 | F0 免费层可用于学习 | 页面称每月 500 页，待核实（2026-11-05 获取） |

• 删除不再使用的资源或资源组。具体操作步骤本页未核对，待核实。

• - 核对范围：正文已读，但仅覆盖页面前约 10 万字符，即 C# 与大部分 Java 段。Python、JavaScript 与 REST 段未核对，相关步骤与代码待核实。

文档智能概览

• 下表来自页面版本表，获取日期为 2026-11-05。版本日期以页面为准，停止支持日期待核实。

• | v3.0（2022-08-31） | GA，退役中 | 2029-03-30（待核实） |

• | v2.1 | GA，退役中 | 2027-09-15（待核实） |

• ## 限制与待核实

• - 版本停止支持日期、各模型的支持语言与页数限制：待核实（2026-11-05 获取）。

• - 区域可用性：页面指向 Azure 产品区域表，具体区域待核实（2026-11-05 获取）。

• - 预置模型的完整字段清单与字段类型：本页仅核对模型分类，字段细节待核实。

• - Studio 与 API 之间的功能差异：待核实。

• - 核对范围：正文已读。页面为多版本视图，本页主要核对版本表、文档分析模型、预置模型、自定义模型与版本说明；v2.1 与 v3.x 的细节差异未展开，待核实。

翻译快速开始

• 页面快速开始部分未包含清理步骤。使用完毕后，建议在门户中删除资源或资源组，具体操作待核实。

• - 请求限制与定价层级细节见服务限额页，未读取，待核实（2026-11-05 获取）。

翻译服务概览

• | 文档翻译（异步） | 批量翻译，保留原文档结构与格式，需要 Azure Blob 存储 | REST API、SDK、容器 | 待核实 |

• | 文档翻译（同步） | 单个文件翻译，可附带词汇表文件，无需 Blob 存储 | REST API、门户、容器 | 待核实 |

• | 自适应自定义翻译 | 上传已对齐的源语与目标语句对，快速构建自定义双语索引 | 门户 | 待核实 |

• | Custom Translator | 为领域术语与风格构建自定义模型，可创建短语或句子词典 | Custom Translator 门户 | 待核实 |

• ## 限制与待核实

• - 支持的语言数量与语言列表以语言支持页为准，待核实（2026-11-05 获取）。

• - 自适应自定义翻译的数据量要求（页面给出 5 至 10,000 个句对，每对不超过 500 字符）待核实。

• - 请求限制、速率与并发限制见服务限额页，本页未读取，待核实。

• - 页面示例中提到的大语言模型型号待核实。

• - 数量、限额、预览与 GA 状态以官方功能页为准，本页未逐项核对，已标注待核实。

视觉快速开始

• | Python | 3.x，并带 pip | 版本细节待核实 |

• | Computer Vision 资源 | 在 Azure 门户创建，获取密钥与终结点 | 可用免费层 F0 试用，待核实 |

• | 没有输出标签 | 图片是否满足格式与尺寸要求（待核实） |

• 删除资源或资源组即可清理。页面给出了门户与 Azure CLI 的清理链接，本页未展开，待核实。

• - 包版本、图片限制与弃用日期未独立核对，已标注待核实（2026-11-05 获取）。

视觉服务概览

• 官方提示 Image Analysis 4.0 已弃用，计划于 2028 年 9 月 25 日退役，退役后调用将失败。新项目应参考官方迁移指南选择替代方案。退役日期待核实（2026-11-05 获取）。

• | OCR（legacy） | 用 Read API 提取印刷体与手写文字，支持多种载体 | 旧版，状态待核实 |

• | 格式 | JPEG、PNG、GIF 或 BMP | 待核实（2026-11-05 获取） |

• | 文件大小 | 小于 4 MB | 待核实（2026-11-05 获取） |

• | 尺寸 | 大于 50 × 50 像素 | 待核实（2026-11-05 获取） |

• | Read API 尺寸 | 介于 50 × 50 与 10,000 × 10,000 像素之间 | 待核实（2026-11-05 获取） |

• ## 限制与待核实

• - 图片格式、大小与尺寸限制待核实。

• - 各子服务的语言支持以语言支持页为准，待核实（2026-11-05 获取）。

• - 数据隐私与合规：官方指向微软信任中心，具体条款待核实。

• - 弃用时间、图片限制与语言支持未独立核对，已标注待核实。

语言服务快速开始

• 本页计划用一条主线演示如何调用 Azure Language。当前版本尚未读到快速开始页正文，以下步骤均为待核实内容，不可直接照做。

• ## 前置条件（待核实）

• | Azure 订阅 | 需要 | 待核实 |

• | Language 资源 | 在 Azure 门户创建，获取密钥与终结点 | 待核实 |

• | 定价层 | 是否有免费层及 SKU | 待核实（2026-11-05 获取） |

• | 开发环境 | 语言版本与依赖包 | 待核实 |

• ## 步骤（待核实）

• ## 预期结果（待核实）

• - 调用成功并返回结构化结果。具体字段与示例输出待核实。

• | 调用失败 | 终结点与密钥是否来自同一资源 | 待核实 |

• | 功能不可用 | 所选区域与功能是否匹配 | 待核实 |

• 删除不再使用的资源或资源组。具体步骤待核实。

• （另有 1 处，见页面原文）

语言服务概览

• | PII 检测 | 识别文本与对话中的个人信息 | 支持文本、对话（聊天或转写）和文档；匿名化（合成替换）功能为预览，待核实 |

• | 语言检测 | 判断文本语言与变体方言 | 支持范围以语言列表为准，待核实 |

• - 官方提供 Azure Language MCP 服务器，可作为远程服务（Foundry 工具目录）或本地自托管服务使用，状态待核实。

• - 页面还列出两个预构建智能体（意图路由、精确问答），均标注为预览，状态待核实。

• ## 限制与待核实

• - PII 匿名化、MCP 服务器和预构建智能体为预览功能，适用条款与状态待核实（2026-11-05 获取）。

• - 页面称 Document PII 的 Foundry 演示场景已正式可用，状态待核实。

• - 支持的语言、区域与容器可用性以对应功能页为准，待核实（2026-11-05 获取）。

• - 预览状态与语言范围未逐项核对，已标注待核实。

语音服务快速开始

• | 音频文件 | WAV 格式 | REST 示例接受约 60 秒，JavaScript/TypeScript 示例约 30 秒，待核实 |

• | 语言环境 | Python 3.7 及以上、Java 需 Speech SDK 1.43.0、Swift 需 Speech SDK 1.51.0 及以上 | 版本要求待核实（2026-11-05 获取） |

• | 音频无法识别 | 确认为 WAV 文件，并满足长度限制（待核实） |

• | SDK 版本报错 | 对照页面列出的语言版本要求（待核实） |

• 页面末尾的清理步骤未在本次读取中确认，待核实。通常可删除不再使用的资源或资源组。

• - 核对范围：正文已读，覆盖前置条件、门户路径、代码与 REST 路径、预期结果。页面末尾的 TypeScript 输出与清理步骤未读，相关内容标注待核实。

• - 音频长度、语言版本与示例区域均未独立核对，已标注待核实（2026-11-05 获取）。

语音服务概览

• | 能力 | 说明 | 选项（官方列出，状态待核实） |

• 官方还提到基于大语言模型的 Azure LLM Speech，通过快速转写的增强模式提供，以及 MAI-Transcribe 系列。它们的可用范围与预览状态待核实。

• | 主权云 | 官方提到 Azure Government 与 Azure operated by 21Vianet 等环境，适用范围待核实 |

• ## 限制与待核实

• - 支持的语言、区域与价格以语言支持页、区域页和定价页为准，待核实（2026-11-05 获取）。

• - 自定义语音与自定义语音模型为私有资源，可用条件与审核要求待核实。

• - LLM Speech、MAI 系列和 Voice Live 等较新能力的状态（GA 或预览）待核实。

• - 各子能力的详细参数、语言与价格未在本页核对，已标注待核实。

语音 agent

• - 区域、模型、语音、定价与电话渠道的可用性：待核实（2026-11-05 获取）。

部署 hosted agent（azd）

• ## 限制与待核实

• - 官方页面的更新日期为 2026-10-26。页面前置条件写 azd 1.27.1 或更高，排错表又写 1.36.0 或更高，两处不一致，以实际安装时的官方说明为准，待核实（2026-11-05 获取）。

• - 托管智能体的区域、配额与计费：待核实（2026-11-05 获取）。

创建 prompt agent

• ## 限制与待核实

• - 示例模型名、SDK 版本号与配额：待核实（2026-11-05 获取）。

Agent 类型对比

• ## 限制与待核实

• - 语音智能体、Copilot harness、智能体优化器（agent optimizer）等为预览功能，预览范围、区域与可用性：待核实（2026-11-05 获取）。

• - A2A 协议：官方称 v1.0 已正式发布，v0.3 仍为预览：待核实（2026-11-05 获取）。

• - 语音智能体的电话集成、定价与可用模型以门户为准，待核实（2026-11-05 获取）。

为 agent 添加工具

• - 工具所在区域与模型的支持情况：待核实（2026-11-05 获取），以官方“区域与模型兼容性”说明为准。

• ## 限制与待核实

• - 工具集与函数调用的预览状态、各工具的区域与模型支持：待核实（2026-11-05 获取）。

• - 运行 10 分钟时限为官方函数调用页面的说明，待核实是否适用于所有运行形态。

Toolbox 与工具

• ## 限制与待核实

• - 工具集、工具搜索与技能的预览状态，以及每个工具的区域与模型支持范围：待核实（2026-11-05 获取）。

• - 页面未给出配额或价格，相关数字：待核实（2026-11-05 获取）。

SDK 与项目

• 本页汇总 Foundry SDK 的语言包、版本线与项目端点的基本约定，便于选择依赖与核对环境。版本号、运行时版本与示例模型名均标注为待核实（2026-11-05 获取），以官方页面为准。

• | 语言 | 新版包（Foundry new） | 版本（待核实，2026-11-05 获取） | 安装方式（页面示例） |

• | 语言 | 经典版（Foundry classic）包 | 版本（待核实） |

• | Python | 3.10 或更高 | 待核实（2026-11-05 获取） |

• | Node.js | 22 或更高 | 待核实（2026-11-05 获取） |

• | .NET | 8 或更高 | 待核实（2026-11-05 获取） |

• | Java | 17 或更高 | 待核实（2026-11-05 获取） |

• | 模型部署 | 项目中需已有可用的模型部署，示例部署名为 gpt-5-mini | 示例名称，待核实 |

• ## 限制与待核实

• - 上表所有版本号与运行环境要求均为 2026-11-05 获取的页面信息，待核实。

• - 经典版与新版的功能差异、支持周期待核实。

VS Code 扩展

• | 开发环境 | 按“准备开发环境”页面安装语言运行时、全局工具与 VS Code 扩展（该页面未读取） | 待核实 |

• | 本地模型 | 本地模型可通过 ONNX、Ollama 或 Foundry Local 使用，需按各自要求安装 | 待核实 |

• 本页未读取各子任务的分步页面，以下仅列出总体顺序，具体操作待核实。

• | 本地追踪没有数据 | 收集器未启动，或 SDK 未向本地端点发送 | 待核实，按扩展中的追踪说明检查 |

• ## 限制与待核实

• - 声明式 workflow 在 Foundry 中的退役日期页面写为 2026-12-01，代码型的 hosted agent 编排不受影响；日期待核实（2026-11-05 获取）。新的 workflow 开发建议改用 Microsoft Agent Framework（页面建议）。

• - 部分扩展功能为预览，具体功能与版本以扩展的发布说明为准（待核实）。

• - 本地保存的 prompt 不代表模型推理在本机运行（页面说明）；使用本地追踪时，模型与工具调用仍可能使用云服务并产生费用（页面说明，费用单价待核实）。

• - read_scope：正文已读。扩展概览页已通读；各子任务的分步页面未读取，步骤部分仅为概要，具体操作待核实。

平台概览与能力地图

• ## 限制与待核实

• - 官方页面称模型目录“超过 10,000 个模型”，每月约新增 50 个：待核实（2026-11-05 获取）。

• - 部分能力处于预览状态，具体预览范围与区域：待核实（2026-11-05 获取）。

• - 原文提到基于 hub 的项目需使用 Foundry（classic）门户，新投入集中在新版 Foundry 项目：以官方最新说明为准，待核实。

部署类型

• ## 限制与待核实

• - 并非所有模型都支持全部部署类型，需在模型可用性页面核对：待核实（2026-11-05 获取）。

• - 批处理“约 50% 折扣”与“24 小时目标周期”：待核实（2026-11-05 获取）。

• - 配额（每分钟 token 数）、Provisioned 的 PTU 最低要求与可用容量：待核实（2026-11-05 获取）。

• - 即时访问（instant access，预览）可按模型名直接调用，无需创建部署；其预览状态：待核实（2026-11-05 获取）。

如何选择部署方式

• | 费用与配额 | 在计费与配额页面能找到对应的部署记录；具体数值待核实（2026-11-05 获取） |

• ## 限制与待核实

• - 本页依据的是“部署类型”与“模型目录”两篇官方页面（2026-11-05 获取）。“部署概览”页的内容在抓取时也已读取，但其中关于托管计算的表述与模型目录页不完全一致，以官方最新说明为准，待核实。

• - 批处理折扣、目标周期、配额与 PTU 数量、区域清单均为待核实（2026-11-05 获取），以门户和官方配额页为准。

模型目录与选择

• | 区域可用性 | 模型在哪些 Azure 区域可部署，需在目录筛选或官方区域页面核对（具体区域：待核实，2026-11-05 获取） |

• | 计费 | 按虚拟机核心小时计费（原文表述，待核实） | 按输入输出计费，通常按 token（具体价格：待核实，2026-11-05 获取） |

• ## 限制与待核实

• - 目录规模“超过 10,000 个模型”，每月约新增 50 个：待核实（2026-11-05 获取）。

• - 两篇官方页面对托管计算的描述不一致：一篇称需使用基于 hub 的项目（Foundry classic 门户）；另一篇称托管计算以预览形式在 Foundry 项目中提供，并列出 GPU 型号与计费单位。以官方最新页面为准，待核实。

• - 托管计算的配额独立于 Azure 虚拟机配额，按加速器 SKU 与区域通过 Foundry 配额流程申请：具体配额与 SKU：待核实（2026-11-05 获取）。

内容过滤配置

• 本页汇总 Foundry 中与内容过滤相关的护栏策略（guardrail policy）的控制项、作用范围与例外规则。模型部署上的内容过滤严重级别、类别阈值与阻止列表（blocklist）尚未核对，相关内容均标注为待核实。

• | 控制项 | 内容安全（content safety）、提示注入（prompt injection）、受保护材料（protected materials）；策略内的控制项即部署合规的最低设置 | 已记录，具体阈值待核实 |

• | 部署上的内容过滤配置（数据平面 / 部署设置） | 设定各危害类别的过滤严重级别与处理动作 | 待核实，未读取相关页面 |

• | 阻止列表与自定义规则 | 按关键词或模式阻止内容 | 待核实，未读取相关页面 |

• ## 限制与待核实

• - 控制项的具体阈值、过滤类别的取值范围、处理动作（如阻止或标注）均待核实（2026-11-05 获取）。

• - 护栏策略的预览状态与可用区域待核实（2026-11-05 获取）。

• - 护栏策略与模型部署内容过滤的优先级与冲突规则待核实。

• - 受保护材料、提示注入等控制项对不同模型或部署类型的支持范围待核实。

• - read_scope：仅元数据。仅读取了护栏策略快速入门页的正文；模型部署上的内容过滤配置页面未读取，表中相关内容均为待核实。

网络隔离

• | 虚拟网络支持 | 评测功能提供虚拟网络支持，用于网络隔离；具体开通方式以页面为准 | 配置细节待核实 |

• | VNet 项目的存储 | 带 VNet 的项目可使用页面引用的“仅评测”基础设施模板（Bicep 样例） | 待核实 |

• | 托管身份权限 | 若以 Microsoft Entra ID 连接存储，需为存储账户与 Foundry 项目的托管身份授予存储 Blob 数据所有者等角色 | 角色名称与范围待核实 |

• | 追踪数据 | 追踪数据存放于连接的 Application Insights，其网络配置需单独确认 | 待核实 |

• - 评测限制：单行最大 2 MB，批量评测最多 100,000 行，评测运行创建按租户、订阅、项目限速，超限返回 retry-after 头。以上数字待核实（2026-11-05 获取）。

• - 页面说明以 Entra ID 连接存储时，托管身份需要相应的存储权限；权限不足会造成什么后果，待核实。

• 待核实：通用网络隔离的配置步骤（网络规则、私有终结点、DNS 等）尚未读取，此处留空，待补充。

• | 评测在 VNet 项目中失败（推测，待核实） | 存储连接或托管身份权限可能缺失 | 按前提表核对存储与托管身份的角色分配 |

• | 批量评测被拒绝或频繁重试 | 触发限速 | 按 retry-after 等待，使用指数退避，必要时减少批量（限速数值待核实） |

• | 追踪数据在隔离网络中查询不到 | Application Insights 的网络访问设置未覆盖 | 待核实，需检查该资源的网络访问配置 |

• ## 限制与待核实

• - 各区域的功能支持、限速数值、存储与托管身份所需角色均待核实（2026-11-05 获取）。

身份、RBAC 与策略

• ## 限制与待核实

• - 微调模型需要同时具备数据平面与控制平面权限，页面指出只有 Foundry Owner 同时包含二者，或可组合 Foundry User 与 Foundry Account Owner（待核实）。

• - Agent 范围的角色分配目前只影响 agent 端点访问，不授予控制平面权限（页面说明，预览状态待核实）。

• - 护栏策略仅在新版 Foundry 门户可用（页面说明）；护栏的阈值与其他细节待核实（2026-11-05 获取）。

• - 使用 Entra ID 访问 Blob 或 AI Search 等外部资源时，需要为资源的托管身份分配相应的存储或搜索角色（页面示例），具体角色名称待核实。

运行评测

• | 角色 | 项目上的 Foundry User 角色；其他评测工作流的权限见“评测权限”页面（页面引用，未读，待核实） | 页面要求 |

• | Azure OpenAI 连接 | 已部署的 GPT 模型（页面示例为 gpt-4.1-mini），用于 AI 辅助质量评测 | 模型名称为示例，可用性待核实 |

• | 模拟对话数（每场景） | 每条场景生成的对话数 | 页面给出 1–5 | 待核实（2026-11-05 获取） |

• | 最大轮数（模拟） | 单段对话的轮数上限 | 页面给出 1–50 | 待核实（2026-11-05 获取） |

• | 已有对话抽样数 | 从时间范围中抽取的会话数 | 页面给出 1–100 | 待核实（2026-11-05 获取） |

• | 单行最大大小 | 评测数据的单行上限 | 2 MB | 待核实（2026-11-05 获取） |

• | 批量评测最大行数 | 单次批量评测的行数上限 | 100,000 行 | 待核实（2026-11-05 获取） |

• | 评测运行创建频率 | 按租户、订阅、项目限速 | 超限时返回 retry-after，建议指数退避 | 待核实（2026-11-05 获取） |

• | 模型配额超出 | AI 辅助评测消耗 Azure OpenAI 配额 | 使用更小的数据集，或换用页面建议的较小模型（如 gpt-4.1-mini），配额待核实 |

• ## 限制与待核实

• - 完整对话范围、以及图像与音频的多模态评测为预览（待核实）。音频仅支持 WAV 格式（页面说明）。

• - AI 辅助评测会调用判分模型，产生模型消耗；评测计费按消耗计算，单价待核实（2026-11-05 获取）。

• （另有 2 处，见页面原文）

追踪与监控

• | 客户端 SDK 运行环境 | Python 3.10 或更高；Node.js 22 或更高；.NET 8 或更高（以 SDK 页面为准） | 待核实（2026-11-05 获取） |

• | 数据保留 | trace 数据保留时间与计费随 Application Insights 配置 | 待核实（2026-11-05 获取） |

• - 客户端追踪：在自有应用中安装 OpenTelemetry 与 Azure SDK 追踪插件，并在创建项目客户端之前开启 GenAI 追踪。C# 示例需要设置运行时开关，属于实验性功能，待核实。

• | 服务端追踪 | 无代码改动记录托管 agent 的运行 | 可在 Traces 中查看近期 trace | 保留期限待核实（2026-11-05 获取） |

• | 延迟（Latency） | 运行响应时间 | 页面以超过 10 秒作为排查提示 | 阈值待核实（2026-11-05 获取） |

• | 运行成功率 | 完成运行的比例 | 页面以低于 95% 作为排查提示 | 阈值待核实（2026-11-05 获取） |

• | 持续评测每小时运行上限 | 限制评测规则的触发次数 | 页面称默认每小时 100 次 | 待核实（2026-11-05 获取） |

• | 定期评测、红队扫描、告警 | 按计划评测、安全扫描、阈值告警 | 页面标注为预览 | 预览状态待核实 |

• | 敏感内容出现在 trace 中 | prompt、工具参数或输出含个人或敏感数据 | 写入 telemetry 前脱敏；页面建议对敏感内容使用单独表并限制访问（页面引用，未读，待核实） |

• ## 限制与待核实

• - 追踪的 GA 状态：页面称 prompt agent 与 hosted agent 已正式可用，workflow 与外部 agent 为预览（待核实）。

• - 仪表板的“定期评测”“红队扫描”“告警”标注为预览，功能与配额待核实。

• （另有 1 处，见页面原文）

可观测性概览

• ## 限制与待核实

• - 评测与追踪的计费：页面说明按消耗计费，单价与免费额度待核实（2026-11-05 获取）。

• - Agent playground 中的评测默认开启并计入消耗计费（页面说明），对具体订阅的影响待核实。

• - AI 辅助 evaluator 的区域支持与评测运行的速率限制，待核实（2026-11-05 获取），详见评测相关页面。

• - 追踪的功能成熟度不一：页面称 prompt agent 与 hosted agent 的追踪已正式可用，workflow 与外部 agent 为预览（待核实）。

• - 多 agent 语义约定为联合贡献的扩展，实际 span 嵌套取决于所用框架，待核实。

分块与向量化操作

• | 模型输入限制 | 查阅所用嵌入模型的输入上限。原文示例为 text-embedding-3-small 的 8,191 tokens（待核实，2026-11-05 获取） |

• 1. 估算文档的 token 分布。用与模型一致的分词器统计每页或每块的 token 数，记录最小、平均和最大值。原文用一份 200 页的示例 PDF 演示，平均约 189 tokens、最大约 1,583 tokens，这是示例数据，待核实。

• 3. 设定最大块长度与重叠长度。原文推荐的起点为每块 2,000 字符、重叠 500 字符（待核实，2026-11-05 获取）。

• 原文还提到一个通用起点：512 tokens（约 2,000 字符）加 25% 重叠，即 128 tokens（待核实，2026-11-05 获取）。原文同时指出，结构化数据通常需要较少重叠，叙述性文本可能需要更多。

• 原文的示例文件中，不同参数的块数如下（仅作参考，待核实）：

• | 超出模型输入限制 | 字符数与 token 数不一致 | 改用 token 计数复核；原文说明预览版 REST API 支持按 token 切分，预览状态待核实 |

• - 核对说明：正文通过网页抓取工具获取，工具返回的是整理后的文本。参数名与示例取自正文，但数字（块数、token 统计、推荐起点）是抓取结果中的示例或建议值，均标注为待核实，使用前需回到官方页面复核。示例 PDF 的数据未逐一核对。本页不含图片。

分块方案对比

• ## 限制与待核实

• - 成本仅有相对评级，没有具体金额。模型与服务的计费，待核实。

企业 RAG 设计与评估

• ## 限制与待核实

• - 企业基线中的区域、模型和工具支持情况，以及配额与 SKU 限制，以页面当前版本为准，均待核实（2026-11-05 获取）。原文提示：工具支持取决于模型与区域，不支持的组合可能在创建时通过、运行时失败。

RAG 参考架构

• | 评测维度 | 见「RAG 评测指标」 | 原文提到工具选择准确率、每次请求的工具调用次数、端到端延迟，具体做法待核实 |

• ## 限制与待核实

• - Agentic RAG 的评测维度与实现细节，原文只做概述，待核实。

RAG 评测指标

• ## 限制与待核实

权限感知检索

• 原文指出，search.in 替代多个等值 or 条件，可明显降低组较多时的查询延迟。原文称可达到亚秒级响应，具体表现待核实。

• - 核对说明：安全过滤页的正文通过网页抓取工具获取，工具返回的是整理后的文本。示例 api-version 与 JSON 结构以页面为准，使用前待核实。页面提到的“内置文档级 ACL 支持”未在本次阅读中展开，待核实。基线页的会话授权说明据前约 10 万字符的正文整理。本页不含图片。

关于本文档

• - 数字、价格、配额、区域与预览状态一律标注为“待核实（获取日期）”，以官方页面当期内容为准。

中国与全球区域差异

• | 功能对齐 | 目标是与全球服务可用性对齐，存在功能差距 | 具体产品的可用性以官方“按区域的产品可用性”页面为准，待核实 |

• | 价格与市场 | 有独立的价格页面、零售价格 API 与市场 | 价格以中国区官方页面为准，待核实 |

• | 中国区特有服务 | 如中国区 CDN，选用本地 CDN 厂商；ExpressRoute 在特定配对区域提供免费线路 | 免费线路的条件与费用待核实 |

• | Azure Machine Learning | 功能差异见官方的按中国区云域功能对齐页面，待核实 |

• | Azure AI Speech | 差异与限制见 sovereign clouds 相关页面，待核实 |

• | Translator | 功能差异与 API 端点见 sovereign clouds 相关页面，待核实 |

• | Azure Managed Grafana | 功能可用性见 sovereign clouds 相关页面，待核实 |

• Microsoft Foundry 与 Azure OpenAI 等 AI 服务在中国区的模型、区域与功能可用性，本页未核实，待核实（2026-11-05 获取）。

• ## 限制与待核实

• - 价格、折扣、免费线路条件、配额与区域数字均待核实（2026-11-05 获取）。

• - read_scope：正文已读。两篇中国区页面均为完整正文读取；服务明细表中的链接未逐一跟进，相关产品结论均标注为待核实。

Landing zone 与 CAF

• | 加速器 | Microsoft 提供的基础设施即代码加速器，按推荐实践部署 | 对大多数组织是最快路径；加速器名称与版本待核实 |

• ## 限制与待核实

• - 加速器的名称、版本与支持范围本页未逐一核对，待核实。

成本优化要点

• | Azure 混合权益 | 复用已有软件许可 | 适用产品与条件待核实 |

• | 承诺型折扣 | 对稳定用量降低单价 | 折扣比例待核实（2026-11-05 获取） |

成本估算方法

• | 每次请求的输入与输出 token | 用真实样本测量 | 数值待核实（2026-11-05 获取） |

• | 检索索引规模与查询量 | 文档量与日查询量 | 与 AI Search 的层级和副本数相关，待核实 |

• - 若已有软件许可，核对是否适用 Azure 混合权益（Azure Hybrid Benefit），适用范围以官方条款为准（待核实）。

• ## 限制与待核实

• - 本页不写单价、折扣比例、配额与区域数字；均待核实（2026-11-05 获取）。

容量规划

• | 承诺型折扣（reservation） | 对可预测用量预付以换取折扣 | 折扣比例待核实（2026-11-05 获取）；灵活性下降 |

• | Spot 定价 | 可中断、容错的任务 | 页面仅列为计费模型之一，本页未展开，待核实 |

• | 模型部署配额（如每分钟 token 或请求数） | 决定并发与峰值承载 | 配额随模型、部署类型与区域变化，数值待核实（2026-11-05 获取），以官方配额页为准 |

• | 出口防火墙吞吐 | 外呼工具调用的上限 | Azure Firewall Basic 成本较低，但有吞吐限制；待核实具体限值 |

• ## 限制与待核实

• - 本页不给出配额、区域容量、折扣比例或单价数字，全部标注为待核实（2026-11-05 获取）。

安全基线

• ## 限制与待核实

• - 本页不给出合规项编号、评分阈值或策略定义名称；具体基准条目以 Defender for Cloud 与 MCSB 页面为准（待核实）。

• - Azure Policy 内置计划的版本与覆盖范围待核实（2026-11-05 获取）。

企业 AI 参考架构

• | Azure OpenAI 模型（Foundry 内） | 推理 | 可用模型集合与工具支持随模型和区域变化，待核实 |

• ## 限制与待核实

• - 页面提示：资源分配限制（assignment restrictions）为预览功能，预览状态待核实。

• - 待核实：模型与区域的工具支持矩阵、各 SKU 与配额、区域可用性（2026-11-05 获取）。

第一次调用模型

• | 即时模型（可选） | 不部署模型，直接使用即时模型试用 | 官方称目前为预览，且需在指定区域的项目中使用，区域与预览状态待核实（2026-11-05 获取） |

• | 账户权限 | 能在项目中调用模型与创建 agent | 具体所需角色待核实（2026-11-05 获取） |

• 1. 获取项目端点。 按官方“获取项目连接信息”的说明找到项目端点（本页未读取该页，具体位置待核实）。格式为 https://<资源名>.services.ai.azure.com/api/projects/<项目名>。

• 2. 安装 Python 包。 安装官方当前版本的 azure-ai-projects（2.x 系列）与 azure-identity。最低版本号待核实（2026-11-05 获取）。

• | 认证失败或提示未登录 | 未运行登录命令，或当前账户没有项目权限 | 重新登录，并检查项目角色（待核实） |

• ## 限制与待核实

• - 即时模型的区域、预览状态与可用模型列表待核实（2026-11-05 获取）。

• - read_scope：正文已读（以上两页）。前置的资源创建与开发环境准备页面未读取，相关细节标注为待核实。

术语与改名对照

• ## 限制与待核实

• - 部分旧服务已退役或计划退役（例如 Anomaly Detector、Content Moderator、LUIS、Personalizer、QnA Maker 等）。退役日期与迁移细节待核实（2026-11-05 获取）。

如何选择 Azure AI 服务

• | 文本翻译，覆盖多种语言与方言 | Translator | 官方称支持的语言数量待核实（2026-11-05 获取） |

• | 云端服务与容器 | 官方说明部分服务可部署为容器，满足本地化、合规或数据靠近场景，具体支持范围待核实（2026-11-05 获取） |

• ## 限制与待核实

• - 已退役服务：Anomaly Detector、Content Moderator、Language Understanding（LUIS）、Metrics Advisor、Personalizer、QnA Maker 官方列为退役，仅保留给已有应用。退役日期与迁移目标待核实（2026-11-05 获取）。

• - 免费层：官方说明多数服务提供免费层（SKU 为 F0），各服务的额度与限制待核实（2026-11-05 获取）。

• - 定价：计费基于交易量与每秒交易数（TPS）上限，具体价格待核实（2026-11-05 获取）。

• - 认证与合规：官方提到 Microsoft Entra 认证、资源密钥与虚拟网络，以及若干合规认证；具体认证方式与认证范围待核实（2026-11-05 获取）。

接入 MCP 服务器

• 本页说明如何把一个远程 MCP 服务器接入 Foundry 智能体，让智能体使用其中的工具。门户中的具体界面位置以官方文档为准，本页只给出通用步骤与待核实项。

• | 端点 | 远程 MCP 服务器的地址 | 以服务器文档为准（待核实） |

• - 在追踪中能看到对应的工具调用记录（追踪的具体界面待核实）。

• - read_scope：正文已读（概览页中的 MCP 连接与认证说明、MCP 架构页的传输与通知说明、function calling 页的安全建议）。门户中的具体操作界面与菜单位置未在本页读取，待核实（2026-11-05 获取）。

MCP 概念

• ## 限制与待核实

• - 协议版本（页面 URL 中的 2026-07-28）与各语言 SDK 的具体 API：待核实，以官方规范与 SDK 文档为准（2026-11-05 获取）。

Skills 概念

• ## 限制与待核实

• - Copilot harness 等能力处于预览阶段，支持的技能与工具范围以官方页面为准（待核实，2026-11-05 获取）。

• - Prompt agent 中 Skills 的具体配置字段与可用区域：本页未读取到专门的配置页，待核实。

• - 安装方式（插件或仅安装技能）、所需 Node.js、Azure CLI 与 azd 版本，以官方安装页为准（待核实，2026-11-05 获取）。

智能体的组成与执行循环

• ## 限制与待核实

• - 单次请求内的最大循环次数、超时与配额：待核实（2026-11-05 获取），本页未读取到具体数值。

• - 追踪、评测与监控的具体指标与界面：待核实，以可观测性相关官方页面为准。

• - Copilot harness 与语音类 prompt agent 处于预览状态，服务条款与区域支持以官方页面为准（待核实，2026-11-05 获取）。

Tool calling 概念

• ## 限制与待核实

• - 工具（函数）描述长度上限为 1,024 字符（官方页面抓取时所见，2026-11-05 获取，待核实是否变化）。

• - 支持 function calling 的模型、API、部署类型与版本因目录而异，需在模型详情中逐一核对（待核实，2026-11-05 获取）。

Chat / Workflow / Agent 选型

• 本页帮助判断一个任务应采用 Chat、Workflow 还是 Agent 形态。Chat 与 Agent 的区别有官方页面依据；Workflow 在 Foundry 中的具体定义本页未核实，相关内容一律标注待核实。

• | Workflow | 步骤与分支事先编排，每步可包含模型或工具调用 | 开发者决定流程 | Foundry 中的定义与产品形态：待核实（2026-11-05 获取） |

• | 步骤固定、分支有限，每步输入输出清晰 | Workflow | 经验判断；Workflow 在 Foundry 中的实现待核实 |

• ## 限制与待核实

• - Agent 自主调用工具会增加模型调用次数与延迟，成本估算需结合定价页核对（待核实，2026-11-05 获取）。

• - Workflow 在 Foundry 中的创建方式、可用节点类型与发布状态：待核实。

• - 语音类 prompt agent 与 Copilot harness 处于预览阶段，不建议作为生产依据（以官方说明为准，待核实）。

• - read_scope：正文已读（两页正文均已读取）。Workflow 的官方定义未在已读页面中找到，相关条目保持待核实。

单 Agent 与多 Agent 选型

• 本页讨论何时用一个智能体完成任务，何时拆分为多个协作的智能体。本页目前只有课程目录与产品概览层面的依据，选型标准的具体结论均待核实。

• | 典型问题 | 指令与工具过多时，单个智能体的判断变差（经验判断，待核实） | 角色边界不清时，智能体之间重复或冲突（经验判断，待核实） |

• - Microsoft 的 AI Agents for Beginners 课程目录中包含“Multi-Agent Design Pattern”一课。课程正文未在本页读取，具体的单 Agent 与多 Agent 选择标准待核实。

• ## 限制与待核实

• - 多智能体的官方选型标准、推荐的协作模式与评测方法：待核实（2026-11-05 获取）。

• - 多智能体的成本与延迟增幅：待核实，需以实际调用量测算。

• - A2A 协议的具体接入步骤与版本兼容性：待核实，以官方协议文档为准。

Agent 样例

• ## 前置条件（README 所示，待核实）

• | Ollama | 本地安装 Ollama；页面称 Codespaces 方案需要 64 GB 以上内存（待核实） |

• - 归档：页面未标注归档。页面标识为“Public template”，显示约 165 次提交、29 个未关闭 PR、1 个未关闭 issue（待核实）。

• - 最后提交日期：页面未显示，待核实（2026-11-05 获取）。

Azure OpenAI 样例

• ## 前置条件（README 所示，待核实）

• | 模型 | README 列举 GPT-4、GPT-3.5 Turbo、DALL-E、Whisper 等模型。模型名称与可用版本可能已变化，使用前需在官方模型页面核对（待核实） |

• - 维护：README 称仓库“仍在建设中，会频繁更新”。主分支约 321 次提交（待核实）。

• - 最后提交日期：页面未显示，待核实（2026-11-05 获取）。

Foundry 入门样例

• 本页汇总三个面向 Microsoft Foundry 的入门样例仓库，用于了解从部署到测试的基本流程。它们都是展示用途，不是生产模板。以下数字、配额与维护状态均为 2026-11-05 获取，待核实。

• | 智能体运行方式 | Foundry Agent Service | 页面未突出（待核实） | Foundry 托管的 hosted agent |

• | 部署入口 | azd up（页面称约 7–15 分钟，待核实） | azd up（页面称约 5–20 分钟，待核实） | 基于 Azure CLI 与 Bicep，再注册 hosted agent |

• | 维护状态 | 页面未显示归档；约 251 次提交（待核实） | 页面未显示归档；约 280 次提交（待核实） | 页面未显示归档；约 61 次提交（待核实） |

• - microsoft-foundry-basic 页面列出的配额：App Service 计划 P1v3（三实例），以及 GPT-4.1 部署 50k TPM（待核实，2026-11-05 获取）。

• - get-started-with-ai-agents 的 Copilot CLI /up 路径页面称约 40 分钟（待核实）。

• - 核对范围：三个仓库 README 的正文抓取摘要。摘要由抓取工具整理，非逐字核对。提交次数、耗时与配额均未在本页作结论，待核实。

RAG 样例

• ## 前置条件（README 所示，待核实）

• | 模型 | README 所示 GPT 模型为 gpt-5.4-mini（待核实，以当前可用版本为准） |

• - 维护：README 称由维护者支持，不是 Microsoft 支持。页面显示约 1,017 次提交、482 个未关闭 issue、45 个未关闭 PR（待核实）。

• - 最后提交日期：页面未显示，待核实（2026-11-05 获取）。

microsoft/ai-agents-for-beginners

• | 运行代码 | 需要 Microsoft Foundry 账号，即 Azure 账号；部分样例也支持 OpenAI 兼容的提供方（README 举例 MiniMax，待核实） |

• - README 未显示课程内容的最后更新日期。页面显示约 2,241 次主分支提交（待核实）。

microsoft/generative-ai-for-beginners

• | 注意事项 | README 称 GitHub Models 将于 2026 年 7 月底退役，并建议改用 Microsoft Foundry Models（待核实） |

• - README 未显示课程内容的最后更新日期，最近更新日期待核实（2026-11-05 获取）。

客服

• ## 限制与待核实

• - 页面称：脱敏功能为预览，且输出侧的个人信息检测需单独配置护栏（待核实）。

• - 页面称：批量语音转写可处理大量数据，但其他语音 API 可能有请求上限，取决于订阅等级（待核实，以配额页为准）。

• - 成本与区域：成本取决于音频时长、并发、存储量与区域，页面未给出价格（待核实，2026-11-05 获取）。

文档处理

• ## 限制与待核实

• - 页面称：方案用 Content Understanding 与 Azure OpenAI 组合，以获得较高准确率（页面表述，本页未核对准确率数据，待核实）。

• - 页面称：Container Registry 有按日的固定费用，其余多为用量计费（待核实，价格以官方定价页为准）。

• - 页面所示的参考实现位于 GitHub 仓库 microsoft/content-processing-solution-accelerator，本页未读该仓库内容，部署方式待核实。

• - 支持的模型版本、区域与预览功能状态：待核实（2026-11-05 获取）。

数据分析助手

• | 容量与计费 | Copilot 消耗容量资源，按 token 计费 | Fabric 容量指标应用中的 Copilot 操作（待核实） |

• ## 前置条件（页面所示，2026-11-05 获取，待核实）

• ## 限制与待核实

• - 页面称：问题与语义模型数据无关时，Copilot 会改用大模型的通用知识回答。这类回答不是企业数据，使用时需要识别（待核实）。

• - 页面称：同一提示在模型未变化时的 24 小时内可能返回缓存结果，“清除对话”不会影响该缓存（待核实）。

• - 页面称：Copilot 以 token 计费，Fabric 会对 Copilot 触发的下游操作（如 DAX 查询、数据刷新、订阅邮件）另行计费（待核实）。

• - 页面称：新购或扩容容量后，Copilot 最长需要 24 小时才能识别（待核实）。

• - 页面称：独立 Copilot 与应用内 Copilot 在部分区域不可用，非英语提示“可能有效，但未正式支持”（待核实）。

企业知识助手

• ## 限制与待核实

• - 页面称 Foundry 不做按用户的授权隔离，应用层需保证会话归属。文档级权限过滤在已读内容中未找到具体做法，待核实。

• - 参考架构页面的已读部分未提及 RAG 回答的引用机制；样例仓库 README 称其回答可带引用，但那是样例，不代表生产方案。引用的具体实现待核实。

• - 页面列出的主要成本项为 Cosmos DB、AI Search 与 DDoS Protection（待核实，以官方定价页为准）。

• - 页面称模型部署本身不内建负载均衡与熔断，标准部署不具备可用区感知（待核实）。

• - 支持的模型、区域与预览功能状态：待核实（2026-11-05 获取）。

OWASP LLM Top 10 对照

• - OWASP 项目页面的版权信息标注为 2026 年，但抓取时可见的最新版本标签为 2025。是否存在更新版本，待核实（2026-11-05 获取）。

• ## 限制与待核实

• - 每条的官方缓解建议、示例与参考资料，待核实。

• - 获取日期：2026-11-05。版本是否更新待核实。

工具滥用防护

• | 预览功能 | 工具调用与工具响应干预点、Task Adherence 为预览 | 需在项目中启用，待核实（2026-11-05 获取） |

• | 正常调用被误拦 | 阻止级别过高，或分类器误判 | 调整阻止级别，并用正常样本回归测试；持续误报可联系支持（待核实） |

• ## 限制与待核实

• - Task Adherence 为预览。页面说明，在所有内容安全区域都可启用，但客户数据可能被路由到美国和欧盟区域处理。这对数据驻留要求有影响，需与合规团队确认（待核实）。

• - 护栏概览页的动作表显示 agent 不支持仅标注（Annotate），而 Prompt Shields 页面的排错建议提到从 block 改为 annotate 观察误报。两处对 agent 场景的描述不一致，待核实。

• - 预览功能的状态、适用风险与区域均以 2026-11-05 获取的页面为准，待核实。

• - 获取日期：2026-11-05。预览状态与数据路由说明以该日期的页面为准，待核实。

负责任 AI 与内容安全治理

• 官方页面建议以下做法（页面表述为建议，具体落地方式待核实）：

• | Groundedness detection | 检测回答是否基于提供的来源材料 | 预览，计划退役（待核实，2026-11-05 获取） |

• | Task adherence API | 检测 agent 的工具调用是否偏离用户任务 | 预览（待核实，2026-11-05 获取） |

• | Custom categories（标准与快速） | 自定义有害内容类别 | 预览（待核实，2026-11-05 获取） |

• 页面说明，部分预览能力计划于 2027-04-30 退役，具体退役范围与迁移方式待核实。

• | 动作 | 由应用决定如何处理 | 模型可用注释或拦截；agent 目前为拦截（待核实） |

• - 价格层级：有 F0 与 S0 两个层级，具体价格待核实，请以 Azure 定价页为准。

• - 查询速率：按每秒请求数或每 10 秒请求数计算，具体数值待核实。

• - 语言：页面说明，部分模型（如受保护材料、有据性检测、标准自定义类别）仅支持英文；其他模型的训练与测试语言包括中文，但质量可能有差异，应自行测试（待核实）。

• - 区域：需在支持的区域创建资源，具体区域清单待核实。

• ## 限制与待核实

• - 预览能力的状态与退役日期（2027-04-30）以页面为准，待核实。

• （另有 2 处，见页面原文）

Prompt Injection 与防护

• | Spotlighting（预览） | 默认关闭 | 用 base64 编码标记文档为低信任内容；会增加 token，且仅适用于 Chat Completions API（待核实，2026-11-05 获取） |

• | 工具响应干预点（预览） | 待核实 | 对 agent 的支持工具，可扫描工具返回中的文档攻击（待核实，2026-11-05 获取） |

• - 检测存在误报与漏报。页面建议误报较多时，可先把动作从 block 调整为 annotate（仅记录）观察。注意：护栏概览页的动作表显示 agent 场景不支持 annotate，两处描述不一致，待核实。

• - 获取日期：2026-11-05。预览状态（Spotlighting、工具响应干预点）与动作适用范围均以该日期的页面为准，待核实。

评测指标与方法

• | RAG | Groundedness | 回答是否基于检索到的上下文，评分为 1–5 分（页面描述） | 模型判断，数值待核实 |

• | RAG | Groundedness Pro | 回答是否基于上下文，输出二元 pass/fail，不需要模型部署 | 预览（待核实，2026-11-05 获取） |

• | RAG | Response Completeness | 回答是否缺少关键信息（相对参考答案） | 预览（待核实，2026-11-05 获取） |

• | 自定义 | Rubric | 按加权的自定义标准打分，结果归一化到 0–1，并给出各维度理由 | 预览（待核实，2026-11-05 获取） |

• | 自定义 | Custom evaluators | 自定义评分逻辑、校验规则与指标 | 预览（待核实，2026-11-05 获取） |

• | Azure OpenAI graders | Model Labeler、String Checker、Text Similarity、Model Scorer | 按自定义规则分类、校验文本模式、评分 | 页面列出，细节待核实 |

• - 本页依据 Built-in Evaluators Reference 页面获取，页面元数据标注的发布日期为 2026-09-09，最近更新为 2026-10-08（以抓取页面为准，待核实）。

• ## 限制与待核实

• - 数字与评分范围（如 Groundedness 的 1–5 分）以官方页面为准，待核实（2026-11-05 获取）。

• - AI 辅助 evaluator 的区域支持、速率限制与虚拟网络支持见官方对应参考页，本页未读取，待核实。

• - 获取日期：2026-11-05。预览状态、数字与版本信息均以该日期的页面为准，待核实。

Agent 评测方法

• 下表列出官方参考页中的 agent evaluator。预览状态只记录页面标注的内容，并以 2026-11-05 获取为准，待核实。

• | Evaluator | 衡量什么 | 预览状态（待核实，2026-11-05 获取） |

• | Agent 应用 | Output Quality + Tool Use Quality + Rubric + Content Safety | Rubric 为预览，待核实 |

• ## 限制与待核实

• - 计费：页面说明风险与安全评测、agent playground 中的评测按消费计费。具体价格待核实，请以 Azure 定价页为准，本页不列价格。

• - 区域、速率限制与虚拟网络支持：页面指向单独的参考页，本页未读取，待核实。

• - 各 evaluator 的具体评分范围与阈值，本页未逐一核实，待核实。

• - 获取日期：2026-11-05。预览状态、区域、计费与数字均以该日期的页面为准，待核实。