The genai_has_tool_calls function checks whether a GenAI messages array contains any tool calls or function calls. It returns a boolean value indicating if the AI model requested to use external tools or functions during the conversation.
You can use this function to filter conversations that use function calling, monitor tool usage patterns, identify integration opportunities, or track feature adoption of function calling capabilities.
For users of other query languages
If you come from other query languages, this section explains how to adjust your existing queries to achieve the same results in APL.
In Splunk SPL, you would check if tool-related fields exist in the messages.
['ai-logs']
| extend has_tools = genai_has_tool_calls(messages)In ANSI SQL, you would check for existence of tool calls in the messages array.
['ai-logs']
| extend has_tools = genai_has_tool_calls(messages)Usage
Syntax
genai_has_tool_calls(messages)Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| messages | dynamic | Yes | An array of message objects from a GenAI conversation. Each message typically contains role and content fields. |
Returns
Returns a boolean value: true if the messages contain tool calls, false otherwise.
Example
Check if a GenAI conversation contains any tool calls or function calls.
Query
['otel-demo-genai']
| extend has_tools = genai_has_tool_calls(['attributes.gen_ai.input.messages'])
| summarize
conversations_with_tools = countif(has_tools),
total_conversations = count(),
adoption_rate = round(100.0 * countif(has_tools) / count(), 2)Output
| conversations_with_tools | total_conversations | adoption_rate |
|---|---|---|
| 345 | 1450 | 23.79 |
This query tracks function calling adoption, helping you understand feature usage trends.
List of related functions
- genai_extract_tool_calls: Extracts the actual tool calls. Use this after confirming tool calls exist to analyze what tools are being called.
- genai_extract_function_results: Extracts function results. Use this to analyze the outcomes of tool calls.
- genai_message_roles: Lists all message roles. Use this to understand conversation structure when tool calls are present.
- genai_conversation_turns: Counts conversation turns. Analyze this alongside tool usage to understand complexity.