v0.26.0

What's New

This release transforms the data-agent command group from 9 basic CRUD subcommands into a comprehensive 22-subcommand management surface, inspired by the official fabric-data-agent-sdk (v0.1.24a0). You can now create, configure, and deploy Fabric Data Agents entirely from the CLI — adding data sources, managing few-shot examples, setting table descriptions, and querying agents — without touching the Fabric portal.

Data Agent: Datasource Management

Add, remove, list, and inspect data sources with auto-type detection from Fabric artifacts:

# Auto-detects Lakehouse type from artifact
fabio data-agent add-datasource --workspace $WS --id $DA --artifact "SalesLakehouse"

# List and inspect configured sources
fabio data-agent list-datasources --workspace $WS --id $DA
fabio data-agent show-datasource --workspace $WS --id $DA --datasource "SalesLakehouse"

# Select/unselect tables for the agent
fabio data-agent select-tables --workspace $WS --id $DA --datasource $LH --tables "orders,products"

Supported artifact types: Lakehouse, Warehouse, KQLDatabase, SemanticModel, Ontology, GraphModel, MirroredDatabase, SQLDatabase.

Data Agent: Few-Shot Examples

Manage question/query pairs that teach the agent how to translate natural language to SQL/KQL:

# Add a single example
fabio data-agent add-fewshot --workspace $WS --id $DA --datasource $LH \
  --question "Top customer by revenue?" \
  --answer "SELECT TOP 1 customer_name, SUM(total_amount) FROM orders GROUP BY customer_name ORDER BY 2 DESC"

# Bulk upload from CSV or JSON
fabio data-agent upload-fewshots --workspace $WS --id $DA --datasource $LH --file fewshots.csv

Duplicate questions are auto-renamed with [N] suffixes (matching the SDK's behavior).

Data Agent: Configuration & Element Descriptions

# Set AI instructions and enable preview runtime
fabio data-agent update-config --workspace $WS --id $DA \
  --instructions-file instructions.txt --enable-preview-runtime

# List tables/columns with selection state
fabio data-agent list-elements --workspace $WS --id $DA --datasource $LH

# Set descriptions to help the agent understand schema semantics
fabio data-agent describe-element --workspace $WS --id $DA --datasource $LH \
  --path "dbo.orders.total_amount" --description "Total order value in USD"

Data Agent: Enhanced Query & Publishing

# Query the draft agent before publishing
fabio data-agent query --workspace $WS --id $DA --stage sandbox --prompt "Test query"

# Configurable timeout (default: 300s)
fabio data-agent query --workspace $WS --id $DA --timeout 600 --prompt "Complex query..."

# Publish to M365 Copilot Agent Store
fabio data-agent publish --workspace $WS --id $DA --to-m365

Bug Fixes

• data-agent: Fix --query naming conflict — the add-fewshot SQL query flag conflicted with the global JMESPath --query flag, causing null output. Renamed to --answer (with --sql alias) (60f5f20)

Documentation

• Comprehensive AGENTS.md update with 17 new API behaviors discovered from the official Python SDK, including internal workload management URLs, schema discovery endpoint, M365 publishing endpoint, datasource type mappings, element types, and operational limits
• Full rewrite of EXAMPLES.md data-agent section with 8 subsections covering all 22 subcommands
• COMMANDS.md expanded from 9 to 22 data-agent entries
• agent-context schema updated for AI agent discovery

Dependencies

• Bump zip from 2.4.2 to 7.2.0 (Dependabot)
• Add uuid v1 with v4 feature (few-shot ID generation)
• Update h2 0.4.14 → 0.4.15

Stats

• 11 commits, 9 files changed, +3,774 / -87 lines
• 749 unit tests (+34 new), 34 data-agent e2e tests (all passing live)
• Cross-compilation: 5/5 targets pass (linux x64/arm64, macOS x64/arm64, Windows x64)

Full Changelog: v0.25.0...v0.26.0

What's Changed

• chore(deps): bump zip from 2.4.2 to 7.2.0 by @dependabot[bot] in #22

Full Changelog: v0.25.0...v0.26.0