# Tool Result

> A tool's output, sent back to the model. It says what happened when the tool ran.

**Field:** Artificial Intelligence  
**Category:** AI Agents  
**Also known as:** Function Call Output, Tool Output, tool_result

## Think of it like

It is like the answer slip a shop sends back after you order. It says what came of your order.

## Definition

A tool result is the message that tells a model what happened when its tool call ran. The model only asks for a tool. Your code or the platform runs it and sends the output back. Each result carries the id of the call it answers, so the model can match them up. If the tool failed, the result says so, and the model can try again or explain the problem.

## Example

The model asks for the weather in Paris. Emma's code calls a weather service and sends back a tool result that says 15 degrees, with the same id as the call.

## Example code

```json
{
  "type": "tool_result",
  "tool_use_id": "toolu_01A09q",
  "content": "15 degrees"
}
```

The id ties this answer to the call that asked for it. The content is what the model reads next.

## Why it matters

A model cannot run tools itself. The result is the only way it learns what its action did.

## Common mistake

Hiding errors. A result that says what went wrong lets the model fix its call instead of guessing.

## Three principles

- **Answers one call.** Matched by the call's id.
- **Your code runs it.** The model only asks.
- **Errors count too.** Say what failed and what to try.

## Related terms

- [Tool Use (Function Calling)](https://learn.benibix.com/term/ai/tool-use)
- [Tool Definition](https://learn.benibix.com/term/ai/tool-definition)
- [Parallel Tool Calls](https://learn.benibix.com/term/ai/parallel-tool-calls)
- [Agent Loop](https://learn.benibix.com/term/ai/agent-loop)
- [Prompt Injection](https://learn.benibix.com/term/ai/prompt-injection)

![A request carries two tool definitions to the model. The model sends back two tool calls at once, each with an id. Your code runs both and returns two tool results with the same ids. Below, a separate lane shows code the model writes running in a locked sandbox.](https://learn.benibix.com/diagrams/ai7-tool-calls.svg)

---

Source: https://learn.benibix.com/term/ai/tool-result
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
