Usage & Analytics

Tool Usage

The Tools page shows which tools are installed and available to your agent, grouped by pack. The Query History page shows which specific tools were selected for each past request.

Last updated: April 2026

Tools page

Navigate to Dashboard → Tools. The page loads your installed tools list via the /tools/installed endpoint, authenticated with your session token or the API key stored in localStorage under the key acx_playground_key.

Each tool entry shows:

  • Tool name and description
  • A success rate badge (green ≥ 80%, yellow ≥ 50%, red below 50%)
  • A toggle to enable or disable the tool

Tool packs

Tools are grouped into packs — curated bundles focused on a domain (e.g. web, GitHub, databases). The Tools page fetches your available packs from the /packs endpoint and shows which packs you have enabled.

Click a pack to see the tools inside it. Use the toggle next to each pack to enable or disable the entire pack. The /packs/enable endpoint is called when you toggle a pack.

Enable & disable tools

Click the toggle next to any individual tool to enable or disable it. When disabled, the tool is excluded from semantic retrieval results — Agent-CoreX won't return it even if it's highly relevant to a query. This is useful for hiding tools that are not available in your environment.

Query history

For per-request tool selection history, go to Dashboard → Query History. This page shows a paginated log (50 per page) of your past queries with:

  • The natural-language query text
  • Source badge: mcp, api, or dashboard
  • Timestamp (month, day, hour, minute)
  • The list of tools selected for that query (selected_tools)
  • Per-tool relevance scores (expandable row)

Success rate badge

Each tool on the Tools page shows a colour-coded success rate badge:

80%+ success50–79% success<50% success

TODO: Verify from implementation — the exact definition of "success" (e.g. whether the tool was called successfully by the agent after being returned by retrieval) requires confirmation from the tools endpoint response schema.

Curious why certain tools rank higher than others? Read how the retrieval engine scores and filters candidates. How Tool Retrieval Works →