foundry-iq — скилл для Claude Code: что делает и как установить
Скилл настраивает базы знаний Foundry IQ в Azure, подключает к ним локальные документы или Blob-хранилища и связывает их с ИИ-агентами.
/plugin marketplace add microsoft/skills
/plugin install foundry-iq-skills@skillsЧто делает foundry-iq
Скилл управляет жизненным циклом баз знаний Foundry IQ на платформе Azure. Он переводит локальные файлы и хранилища Azure Blob или ADLS в индексируемые источники знаний, выполняет поиск с выдачей цитат и подключает готовые базы к агентам. Перед любыми вопросами или действиями агент обязан прочитать файл регламента и следовать процедуре маршрутизации.
Для работы с ресурсами скилл предлагает выбор между повторным использованием, сканированием кандидатов или созданием нового сервиса. Все операции чтения выполняются без подтверждения. Любые изменения инфраструктуры требуют заранее одобренного плана, причём скилл запрещает использовать прямые ключи Search или Storage и скрывает хеши.
При попытке создать базу с несколькими источниками или неподдерживаемыми коннекторами скилл сразу переключается на ветку диагностики вместо фонового поиска ресурсов. Для обычного поиска по файлам репозитория или работы с классическими индексами Azure AI Search без Foundry IQ этот инструмент не предназначен.
Какие задачи решает
- сделать локальные файлы и документы из Azure Blob доступными для семантического поиска
- подключить существующую базу знаний Foundry IQ к ИИ-агенту
- найти информацию в базе знаний с точными ссылками и цитатами
- диагностировать сбои при настройке неподдерживаемых коннекторов к базе
Примеры запросов агенту
- Подключи существующую базу знаний Foundry IQ к нашему агенту
- Сделай локальные PDF-файлы доступными для поиска через Foundry IQ
- Найди в базе знаний регламенты безопасности и выведи ответ с точными цитатами
Как установить foundry-iq
1Через маркетплейс плагинов
/plugin marketplace add microsoft/skills/plugin install foundry-iq-skills@skillsКоманда ставит плагин foundry-iq-skills целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add microsoft/skills --skill foundry-iq -a claude-code3Вручную: положить файлы
~/.claude/skills/foundry-iq/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/foundry-iq/
Вручную: положить файлы
.agents/skills/foundry-iq/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/foundry-iq/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install microsoft/skills foundry-iq2Вручную: положить файлы
.github/skills/foundry-iq/SKILL.mdКомандой платформы
gemini skills install https://github.com/microsoft/skills --path .github/plugins/foundry-iq-skills/skills/foundry-iqВручную: положить файлы
.devin/skills/foundry-iq/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о foundry-iq
Как установить foundry-iq в Claude Code?
В консоли Claude Code выполните по очереди команды /plugin marketplace add microsoft/skills и /plugin install foundry-iq-skills@skills.
Что делает скилл foundry-iq?
Он управляет созданием, диагностикой и опросом баз знаний Foundry IQ в Azure, а также подключает их к агентам.
Когда этот скилл использовать нельзя?
Он не подходит для поиска по коду репозитория, управления другими провайдерами баз знаний и классических индексов Azure AI Search без запроса к Foundry IQ.
Исходный текст
SKILL.md · MIT
--- name: foundry-iq description: "Foundry IQ knowledge bases. WHEN: make local or Blob documents searchable; create/diagnose KBs; triage unsupported connectors or multi-source KB creation/reconfiguration (even with classic-search terms); connect existing KB to agents (including multi-source KBs); create/reuse a Search service; retrieve from an existing knowledge base with citations; no brand words needed. Read its procedure before query/target questions. NOT: other KB providers, repository-file search, classic Azure AI Search index/query/app work with no Foundry IQ KB or connector request, generic agent creation." license: MIT compatibility: Azure metadata: author: Microsoft version: "0.2.1" --- # Foundry IQ Read one procedure before questions/actions; invocation is not a read. Read the owning procedure before blocked/unsupported responses too. Before mutation plans/approval, successfully read its required pre-action references, selected branches only. Do not reload successful reads. On failure, try only permitted bounded exact-path reads with any supported reader; never bypass restrictions or search broadly. If still unavailable: `blocked: reference-unavailable`, name missing references and inability to plan. Never invent requirements/plans. Failures first. Cleanup and receipt-backed execution go directly to their lifecycle/producer owner; do not reopen Search intake, provisioning or hardening. Before expensive service discovery, reuse supplied resource/intent; otherwise ask one early **USE EXISTING / FIND CANDIDATES / CREATE NEW** choice. Only FIND enumerates; supplied identity uses exact/minimum scoped resolution. CREATE checks its proposed name, not existing-service inventories. Preserve these answers across source/KB/CU/model handoffs; selection is not write approval. Searchable docs: KB + validated retrieval. Confirm intent once; KS-only must be explicit. Child success is not KB completion. Unclear/compound/mode/completion: [read](references/intent-routing.md). Route by requested operation, not existing KB source count. Connecting an existing KB with two or more sources, without changing the KB, uses Connect. Read-only operations use their owning procedure and actual helper constraints; this does not add retrieval modes or supported source kinds. Explicit unsupported provisioning or multi-source KB creation/reconfiguration uses Diagnose and stops before discovery, even when connecting an agent is also requested. This routing takes precedence over classic-search terms (e.g. hybrid search) in compound requests. Never end in a plain refusal: Diagnose gives the boundary, docs pointer and agent handoff; writes still need an approved concrete plan. Do not silently execute only the supported part of a compound request. If existing-KB connection versus KB creation/reconfiguration is unclear, read intent-routing and clarify that scope before Azure discovery. Never infer KB mutation. |Outcome|Read| |---|---| |Cleanup|[Plan cleanup](lifecycle/cleanup.md)| | Failure/drift | [Diagnose](troubleshooting/diagnose.md) | | Unsupported connector provisioning / multi-source KB creation or reconfiguration | [Diagnose](troubleshooting/diagnose.md) | | Connect | [Connect](agents/connect.md) | | Read KB | [Query](knowledge-bases/retrieve.md) | | Search only | [Search](search-services/create.md) | | File KS only | [File](knowledge-sources/create-file.md) | | Blob/ADLS KS only | [Blob](knowledge-sources/create-azure-blob.md) | | Searchable/KB | [KB](knowledge-bases/create.md) | Generic agents: `microsoft-foundry`. Reads: no approval; approve unchanged plans before writes. Hide hashes. No Search/Storage keys, scope widening, guessed identity/boundaries, drift repair or joint cleanup/creation approval. Acceptance != success.
© Microsoft · MIT · microsoft/skills