foundry-iq

Files (85)

• SKILL.md
• connect-hosted-toolbox.md · agents/
• connect-hosted.md · agents/
• connect-prompt-sdk-fallback.md · agents/
• connect.md · agents/
• create-missing-agent.md · agents/
• _blob_observation.py · helpers/
• _blob_source_read.py · helpers/
• _bootstrap_io.py · helpers/
• _cleanup_dependencies.py · helpers/
• _cleanup_receipts.py · helpers/
• _common.py · helpers/
• _document_adapters.py · helpers/
• _document_limits.py · helpers/
• _embedding.py · helpers/
• _file_inventory.py · helpers/
• _file_source_config.py · helpers/
• _indexer_observation.py · helpers/
• _initial_prompt.py · helpers/
• _private_json.py · helpers/
• _progress.py · helpers/
• _prompt_read.py · helpers/
• _search_read.py · helpers/
• _source_readback.py · helpers/
• blob-contracts.md · helpers/
• blob-cu-contracts.md · helpers/
• blob_inventory.py · helpers/
• blob_recheck.py · helpers/
• blob_source.py · helpers/
• bootstrap-contracts.md · helpers/
• bootstrap_azure.py · helpers/
• cleanup_plan.py · helpers/
• contracts.md · helpers/
• cu_ingestion_auth.py · helpers/
• document-assessment.md · helpers/
• document_assess.py · helpers/
• file-upload-recovery.md · helpers/
• file_cu_canary.py · helpers/
• file_cu_mi.py · helpers/
• file_ingest.py · helpers/
• file_source.py · helpers/
• file_upload.py · helpers/
• hosted_connect.py · helpers/
• kb-contracts.md · helpers/
• knowledge_base_retrieve.py · helpers/
• model-discovery-contracts.md · helpers/
• model-discovery-scopes.md · helpers/
• model_discovery.py · helpers/
• private-artifacts.md · helpers/
• private_artifacts.py · helpers/
• prompt_cleanup.py · helpers/
• prompt_connect.py · helpers/
• requirements-assessment.txt · helpers/
• retrieval-verification-contracts.md · helpers/
• retrieval_verify.py · helpers/
• search-intake-contracts.md · helpers/
• search_intake.py · helpers/
• search_reconcile.py · helpers/
• source_vector.py · helpers/
• throttle-recovery.md · helpers/
• …and 25 more

SKILL.md (first lines)

# 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.

From microsoft/skills, MIT.

More from microsoft/skills