Ask the Microsoft Foundry agent a question and return its answer.

Use this for anything the agent is specialised in — its instructions, knowledge and tools all live server-side in Foundry, so you do not need to know how it works. Pass the user's request in plain language.

Do NOT use this to read a Power BI model: inspect_model does that directly and faster.

Connect to a Power BI semantic model and summarise what is in it.

Accepts either a Fabric workspace and semantic model (by display name OR by the GUIDs from the Fabric URL), or the path to a local PBIP / .SemanticModel folder.

Read-only: it never modifies the model. Authentication is the user's own, so their permissions and row-level security apply. Run this before show_measure.

Show the current DAX expression of one measure, and the table it belongs to.

Call inspect_model first. Accepts Table[Measure], [Measure] or just the measure name, so you can paste a reference straight from an analysis report.

Write a new DAX expression for a measure. MODIFIES THE MODEL.

Read-only is the default everywhere else in this server; this is the one exception, and it is opt-in twice over: the caller must pass confirm=True, and the user needs write access (Contributor plus a read/write XMLA endpoint). Always show the user the current expression with show_measure and get their agreement before calling this.

The tabular engine validates the DAX, so an invalid expression is rejected rather than saved.

Turn the GUIDs in a Fabric URL into the display names the tools need.

Use when the user pastes a Fabric Studio link instead of typing names.