Tools

get_available_filters

Returns the list of filter types and operators supported when querying conversations. Use this before calling get_ada_metric or get_conversations to construct valid filter expressions.

Example prompts

  • “What filters can I use to narrow down conversations?”
  • “What filter options are available for conversation queries?”

Parameters

No parameters.

Response

Returns the supported filter types. The currently available filters are:

FilterValues / format
CSATSCORECSAT rating (1–5, or ispositive / isnegative).
ENGAGEDWhether the conversation was engaged.
HANDOFFWhether the conversation was handed off to an agent.
ARTICLEIDKnowledge article ID.
ACTIONIDAction ID.
ARSTATUSAutomated resolution status (Resolved or Not Resolved).
TOPICSTopic ID (use list_entities with entity_type='topics' to find IDs).
LANGUAGELanguage code (for example, en, es, fr).
CHANNELChannel (for example, web, mobile, email).
BROWSERBrowser (for example, chrome, safari, firefox).
DEVICEDevice (for example, macos, iphone, android).
STATUSCODEAction HTTP status code (for example, 200, 400, 500).
COACHINGAPPLIEDCoaching ID (use search_coaching to find IDs).
PLAYBOOKIDPlaybook ID (use get_ada_configuration to find IDs).
ISTESTUSERInclude/exclude test conversations (excluded by default).
VARIABLEConversation variable value (use list_entities with entity_type='variables' to find variable names).