Skip to content

microsoft/foundry-iq-skills

v0.0.0-placeholderMIT

Create and retrieve from a Foundry IQ knowledge base using File, Azure Blob, or ADLS Gen2, then connect an existing Prompt or Hosted Agent.

GitHubOpen Website

Foundry IQ Skills

Build grounded knowledge experiences with Azure AI Search (Foundry IQ).

This plugin helps GitHub Copilot CLI create and use Foundry IQ knowledge bases, using your existing Azure resources when possible.

Telemetry

The track-telemetry hook installs a pinned native ghcfa-telem release asset when needed, verifies its platform-specific SHA-256 digest before extraction, and caches the executable for reuse. To opt out of telemetry collection, set AZURE_MCP_COLLECT_TELEMETRY=false in the environment of the process running the agent.

Skill

  • foundry-iq: Build, connect, query, and troubleshoot Foundry IQ knowledge experiences using supported Azure resources.

What it helps with

  • Create or reuse an Azure AI Search (Foundry IQ) service
  • Create a File knowledge source from local files
  • Create a knowledge source from Azure Blob Storage or Azure Data Lake Storage
  • Create a knowledge base and validate that its content is searchable
  • Query an existing knowledge base and return citations
  • Connect an existing knowledge base to an agent
  • Diagnose knowledge base failures and unsupported requests
  • Prepare a cleanup plan for resources created by the workflow

The skill is intended for Foundry IQ knowledge-base workflows. It does not support classic Azure AI Search (Foundry IQ) application, index, or query development, generic agent creation, or repository-file search.

Prerequisites

  • Git, required to add the plugin marketplace
  • GitHub Copilot CLI
  • Python 3.12 or later, required to run the plugin's helper scripts
  • Access to the Azure subscriptions and resources involved in your request
  • An authenticated Azure identity with the permissions required for the requested read or change

If you use Azure CLI for authentication, install the Azure CLI and sign in:

az login

The plugin supports Copilot CLI on Windows and Linux. Depending on the task, it uses supported Azure SDK, REST, infrastructure-as-code, Azure MCP Server, or native knowledge-base MCP interfaces.

Installation

Run these commands in Copilot CLI:

/plugin marketplace add microsoft/azure-skills
/plugin install foundry-iq-skills@azure-skills

To update the plugin:

/plugin update foundry-iq-skills@azure-skills

Example prompts

  • "Create a knowledge base from ./docs."
  • "Create a knowledge base from this Blob container."
  • "Query this knowledge base with citations."
  • "Connect this knowledge base to my existing agent."
  • "Why is retrieval from this knowledge base failing?"

Before changes are made

The skill starts with read-only checks and can reuse Azure resources you identify. It asks whether to use an existing service, find compatible services, or create a new one before performing broader discovery.

It asks for your approval before it:

  • Creates an Azure AI Search (Foundry IQ) service, knowledge source, or knowledge base
  • Connects a knowledge base to an agent
  • Makes another planned change to Azure resources

Approval applies to the plan shown to you. If the plan changes, the skill asks again. Cleanup is handled as a separate planning workflow. The skill can also perform supported deletion of workflow-owned resources after separate approval.

Learn more