关于 foundry-iq
Foundry IQ 是用于 Microsoft Foundry 操作的流程技能,面向需要安全处理知识库、搜索、连接和清理任务的 Agent。它按操作路由到相应程序,并要求变更前读取参考资料、批准计划。
主要功能
- 01按请求选择操作程序
- 02变更前读取所需参考
- 03写入前要求批准计划
- 04处理失败与不支持操作
- 05区分连接和知识库变更
适用场景
- 01连接现有知识库
- 02查询或搜索内容
- 03诊断不支持的配置请求
- 04规划清理或变更
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ microsoft/ azure-skills --skill foundry-iq安装后在 Claude Code 中输入/foundry-iq确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/connect-hosted-toolbox.mdconnect-hosted.mdconnect-prompt-sdk-fallback.mdconnect.mdcreate-missing-agent.mdhelpers/_blob_observation.py_blob_source_read.py_bootstrap_io.py_cleanup_dependencies.py_cleanup_receipts.py_common.py_document_adapters.py_document_limits.py_embedding.py_file_inventory.py_file_source_config.py_indexer_observation.py_initial_prompt.py_private_json.py_progress.py_prompt_read.py_search_read.py_source_readback.pyblob_inventory.pyblob_recheck.pyblob_source.pyblob-contracts.mdblob-cu-contracts.mdbootstrap_azure.pybootstrap-contracts.md详细介绍
Foundry IQ
在回答问题或执行操作前,先读取一个操作流程;调用不算读取。
即使要回复受阻/不支持,也要先读取所属操作流程。
制定变更计划/请求批准前,成功读取所需的前置参考资料,仅限所选分支。不要重新加载已成功读取的资料。若读取失败,只能使用任何受支持的读取器,尝试受限次数的精确路径读取;绝不可绕过限制或广泛搜索。若仍无法获取:回复 blocked: reference-unavailable,指出缺失的参考资料及无法制定计划。绝不可编造要求/计划。
先处理失败。
清理和有回执支持的执行直接交由其生命周期/生产者负责人处理; 不要重新打开 Search 接入、预配或加固流程。
进行耗时的服务发现前,优先使用已提供的资源/意图;否则尽早询问一次 USE EXISTING / FIND CANDIDATES / CREATE NEW 选项。 只有 FIND 才会枚举;对已提供的标识进行精确/最小范围解析。 CREATE 检查提议的名称,而不是现有服务清单。将这些回答保留到来源/KB/CU/模型交接环节;选择不等于批准写入。
可搜索文档:KB + 已验证的检索。只需确认一次意图;必须明确指定仅使用 KS。 子流程成功不代表 KB 已完成。 意图/复合请求/模式/完成状态不明确时:读取。
根据请求的操作路由,而非现有 KB 来源数量。 连接含两个或更多来源的现有 KB,且不更改 KB 时,使用 Connect。 只读操作使用其所属操作流程及实际辅助工具限制; 这不会新增检索模式或受支持的来源类型。 明确要求不支持的预配,或创建/重新配置多源 KB 时,使用 Diagnose,并在发现前停止,即使同时要求连接 Agent 也如此。 此路由优先于复合请求中的 classic-search 术语(例如 hybrid search)。 绝不可只用简单拒绝结束:Diagnose 会给出边界、文档指引和 Agent 交接;写入仍需经批准的具体计划。 不要默默只执行复合请求中受支持的部分。 如果无法确定是连接现有 KB,还是创建/重新配置 KB,请先读取 intent-routing,并在 Azure 发现前澄清范围。绝不可推断要修改 KB。
| 结果 | 读取 |
|---|---|
| 清理 | 规划清理 |
| 失败/漂移 | 诊断 |
| 不支持连接器预配/创建或重新配置多源 KB | 诊断 |
| 连接 | 连接 |
| 读取 KB | 查询 |
| 仅搜索 | 搜索 |
| 仅文件 KS | 文件 |
| 仅 Blob/ADLS KS | Blob |
| 可搜索/KB | KB |
通用 Agent:microsoft-foundry。
读取:无需批准;写入前先批准未更改的计划。
隐藏哈希。不得使用 Search/Storage 密钥、扩大范围、猜测标识/边界、
修复漂移,或同时批准清理/创建。验收 ≠ 成功。