> ## Documentation Index > Fetch the complete documentation index at: https://docs.ag2.ai/llms.txt > Use this file to discover all available pages before exploring further. # autogen.agentchat.contrib.capabilities.transform_messages.TransformMessages

`TransformMessages`



```python theme={null}
TransformMessages(
    *,
    transforms: list[MessageTransform] = [],
    verbose: bool = True
)
```

Agent capability for transforming messages before reply generation.
This capability allows you to apply a series of message transformations to
a ConversableAgent's incoming messages before they are processed for response
generation. This is useful for tasks such as: 
- Limiting the number of messages considered for context.
- Truncating messages to meet token limits.
- Filtering sensitive information.
- Customizing message formatting.
To use `TransformMessages`: 
1. Create message transformations (e.g., `MessageHistoryLimiter`, `MessageTokenLimiter`).
2. Instantiate `TransformMessages` with a list of these transformations.
3. Add the `TransformMessages` instance to your `ConversableAgent` using `add_to_agent`.
NOTE: Order of message transformations is important. You could get different results based on
the order of transformations.
Example: 
    \`\`\`python
from agentchat import ConversableAgent
from agentchat.contrib.capabilities import TransformMessages, MessageHistoryLimiter, MessageTokenLimiter

max\_messages = MessageHistoryLimiter(max\_messages=2)
truncate\_messages = MessageTokenLimiter(max\_tokens=500)
transform\_messages = TransformMessages(transforms=\[max\_messages, truncate\_messages])

agent = ConversableAgent(...)
transform\_messages.add\_to\_agent(agent)

````

Parameters:
| Name | Description |
|--|--|
| `transforms` | **Type:** list[[MessageTransform](/docs/api-reference/autogen/agentchat/contrib/capabilities/transforms/MessageTransform)]

**Default:** [] |
| `verbose` | **Type:** bool

**Default:** True |

### Instance Methods


#### add_to_agent

```python
add_to_agent(self, agent: ConversableAgent) -> 
````

Adds the message transformations capability to the specified ConversableAgent.
This function performs the following modifications to the agent: 
1. Registers a hook that automatically transforms all messages before they are processed for
response generation.

Parameters:

| Name    | Description                |
| ------- | -------------------------- |
| `agent` | **Type:** ConversableAgent |