Workflow tools
Shortcuts for the questions people actually ask. Each takes a singlebrand_id and returns the already-joined result, so the model spends one
round-trip instead of three.
Workflow tools use the API’s default window — the last 30 days — and no
filters. For a specific period, region or provider, the model should reach for
the generated tools below, which take the full
filter set.
Generated tools
Every tool takes the same parameters as the underlying endpoint: path ids as plain arguments, and the query parameters (page, page_size, sort,
filter[…]) as optional ones.
Brands
Brand metrics
Topics
Prompts
Citations
Competitors
Ads & advertisers
Reading the results
Tools return the API’sdata payload. That means the
metric units apply verbatim — including the trap that
sentiment is a 1–100 average rather than a percentage. If an assistant
reports sentiment as “62%”, it has mislabelled the unit; the number itself is
right.
Writes
Eleven of these tools mutate data:create_brand, update_brand,
delete_brand, create_brand_topics, update_brand_topic,
delete_brand_topic, create_brand_prompts, update_brand_prompts, and the
three competitor writes. Deletes are soft — the row drops out of the lists but
its history is kept, and an archived prompt can still be read directly.

