> For the complete documentation index, see [llms.txt](https://docs.klai.studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.klai.studio/reference/actions-processor/actions_overview/llmtoolcall.md).

# llmToolCall

`llmToolCall` is a frontend AI/tooling action. It receives one or more tool calls requested by an LLM and maps them into BetterForms named actions.

## Expected Options

| Key                  | Type     | Description                                                                       |
| -------------------- | -------- | --------------------------------------------------------------------------------- |
| `options.functions`  | `array`  | Array of tool/function calls requested by the LLM                                 |
| `options.toolCallId` | `string` | Correlation ID used to tie the tool execution back to the originating LLM request |

## Behavior

* BetterForms validates that `functions` is an array and that `toolCallId` is present.
* Each requested function is mapped to a BetterForms named action using the function name.
* Function arguments are parsed from JSON when needed.
* BetterForms injects `toolCallId` into the named-action options.
* The runtime emits `processNamedAction` for each tool call.
* If dispatch fails, BetterForms sends an error payload to `llm/tool-response`.

## Important Pattern

This action is designed to work with `llmToolCallResponse`.

Typical flow:

1. `llmToolCall` receives the tool request.
2. A BetterForms named action runs UI logic.
3. That named action ends with `llmToolCallResponse` to send the result back.

## Related Pages

* [llmToolCallResponse](/reference/actions-processor/actions_overview/llmtoolcallresponse.md)
* [Klai Streaming API (LLM Query)](/reference/apis-and-services/streaming-proxy/bf-streaming-api-llm-query.md)