# AssistantMessage

> The message that holds one piece of Claude's reply: some text or a tool call.

**Field:** Artificial Intelligence  
**Category:** Claude Agent SDK  
**Also known as:** SDK assistant message, Claude Agent SDK AssistantMessage

## Think of it like

It is like a note from a helper. It says what they are doing, or gives the answer.

## Definition

AssistantMessage is the Agent SDK message type for what Claude says or asks for. Each one holds a single content block, such as some text or a tool call. Blocks from one model reply share a message ID. The last AssistantMessage in a run holds the final text with no tool call. In TypeScript the blocks sit at message.message.content.

## Example

Mia's app shows a line such as Reading auth.ts each time a tool is called.

## Why it matters

It is how you show progress while the agent works, step by step.

## Common mistake

Reading the content field in TypeScript and getting nothing. The blocks sit one level down, inside message.

## Three principles

- **One block each.** Text or tool call.
- **Shares a message ID.** Per reply.
- **Shows progress.** Step by step.

## Related terms

- [UserMessage](https://learn.benibix.com/term/ai/sdk-user-message)
- [ResultMessage](https://learn.benibix.com/term/ai/sdk-result-message)
- [Tool Use (Function Calling)](https://learn.benibix.com/term/ai/tool-use)

---

Source: https://learn.benibix.com/term/ai/sdk-assistant-message
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-20
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
