genai_has_tool_calls

This page explains how to use the genai_has_tool_calls function in APL.

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.

Usage

Syntax

APL

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

APLRun in Playground

['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.

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.