Work IQ

Work IQ

Extension ID: microsoft.workiq · Package: @microsoft/wiqd-ext-workiq · Upstream: @microsoft/workiq >=1.0.0

What it does

The Work IQ extension is your window into agents that are already deployed in the tenant. It lets you list every declarative agent in the tenant, send messages to any of them by ID or name, look up an agent’s deployed details, and query the Insights Agent about a specific agent’s performance, usage, and health.

These commands need authentication to the Work IQ service (covered by wiqd auth login). Because the surface is still evolving, every command in this extension requires experimental=true in your wiqd config:

wiqd config set experimental true

Workflow walkthrough

# 0. One-time: enable experimental features
wiqd config set experimental true

# 1. List every declarative agent deployed in the tenant
wiqd agent list

# 2. Filter by name
wiqd agent list --name "Sales"

# 3. Send a test message to an agent by ID
wiqd agent ask --agent-id "T_b6bd...declarativeAgent" -q "Hello, summarize the latest sales deck."

# 4. Or send it by display name
wiqd agent ask --agent-name "Sales Copilot Assistant" -q "..."

# 5. Look up a deployed agent's card (description, version, A2A endpoint)
wiqd agent show --id "T_b6bd...declarativeAgent"

# 6. Ask the Insights Agent how a specific agent is doing
wiqd agent monitor --path ./my-agent --env staging --query "How often was this agent askd last week?"

wiqd agent monitor is the most useful command in this extension day-to-day — it lets you ask natural-language questions about an agent’s metrics rather than digging through a dashboard.

Where to look in the codebase

• packages/wiqd-ext-workiq/wiqd-extension.json — manifest.
• packages/wiqd-cli/src/manifest/manifest-executor.ts — host runtime.

Authentication note: these commands require an authenticated Work IQ session. Run wiqd auth login (or wiqd auth status to check state) before first use; if you hit auth errors during wiqd doctor, re-run wiqd auth login.

Go deeper

• CLI commands — every wiqd ... command this extension contributes.
• Agentic workflows — the playbook and reference files the wiqd Copilot orchestrator loads for Work IQ-driven tasks.
• Copilot skills — the natural-language scenarios this extension powers in Copilot Chat.