mcpField
F
foundry-iq

foundry-iq

github.com/microsoftData & databases1.6k263 installsUpdated today
Repository

About foundry-iq

Foundry IQ is a workflow skill for Agents handling Microsoft Foundry operations across knowledge bases, search, connections, and cleanup. It routes requests to specific procedures and requires reference checks and approval before changes.

Key features

  1. 01Routes requests to procedures
  2. 02Reads required references first
  3. 03Requires approval before writes
  4. 04Handles failures and unsupported requests
  5. 05Separates connection from KB changes

Use cases

  1. 01Connect an existing knowledge base
  2. 02Query or search content
  3. 03Diagnose unsupported configuration requests
  4. 04Plan cleanup or changes

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/microsoft/azure-skills --skill foundry-iq

After installing, type/foundry-iqin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
connect-hosted-toolbox.md
connect-hosted.md
connect-prompt-sdk-fallback.md
connect.md
create-missing-agent.md
helpers/
_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.py
blob_inventory.py
blob_recheck.py
blob_source.py
blob-contracts.md
blob-cu-contracts.md
bootstrap_azure.py
bootstrap-contracts.md

Details

From the project README

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.

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.

OutcomeRead
CleanupPlan cleanup
Failure/driftDiagnose
Unsupported connector provisioning / multi-source KB creation or reconfigurationDiagnose
ConnectConnect
Read KBQuery
Search onlySearch
File KS onlyFile
Blob/ADLS KS onlyBlob
Searchable/KBKB

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.

Comments

Markdown supported