Setting up Fabric knowledge connection results in “Missing required parameter” error

[small hound]

Setting up an agent in Azure AI Foundry with the Fabric knowledge connection results in the following error: “Missing required parameter: 'tools[0].fabric_dataagent'”. This happens in both the Foundry web UI as well as when creating a new Thread and run in code.

[jaunty wren]

The "Missing required parameter: 'tools.fabric_dataagent'" error in Azure AI Foundry occurs when the Fabric Data Agent tool is not properly configured in the agent’s definition—even if the connection itself exists. This issue arises when a tool expects a fabric_dataagent reference within the tools array, and it is either missing or misconfigured.

🔧 How to Troubleshoot and Resolve:

1. Verify Your Agent Definition

• Ensure the agent’s configuration includes a tools array.
• The array must include a tool that explicitly references the Fabric Data Agent like below:

{
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_data_from_fabric",
        "description": "Retrieves data from a Microsoft Fabric data agent.",
        "parameters": {
          "type": "object",
          "properties": {
            "data_source": {
              "type": "string",
              "description": "Name of the data source in Fabric."
            },
            "query": {
              "type": "string",
              "description": "SQL query to retrieve data."
            }
          },
          "required": ["data_source", "query"]
        },
        "fabric_dataagent": "YOUR_CONNECTION_ID"
      }
    }
  ]
}

✅ Replace "YOUR_CONNECTION_ID" with the actual ID of the Fabric Data Agent connection in Azure AI Foundry.

2. Check Your Fabric Data Agent Connection

• Make sure your Fabric connection is: Properly configured & Has required permissions for data access
• Navigate to Connected Resources in your Foundry project and verify the settings.

📖 Reference

3. Validate in Agent’s Setup Panel

• In the Azure AI Foundry UI:
  • Open the agent
  • Scroll to the Setup panel
  • Under Knowledge, confirm that:
    • The Fabric connection is selected
    • The tool is enabled