# Custom Conversation History Template

This is an example of a custom conversation history template that you can use in agents.yaml.

## Usage in agents.yaml

```yaml
documents:
  my-custom-history: |
    {{#if messages}}
    📜 Thread History ({{length messages}} messages):
    {{#if (eq platform "slack")}}
    💬 Slack Conversation
    {{/if}}

    {{#each messages}}
    ---
    {{#if metadata.slack.user_profile}}
    👤 {{metadata.slack.user_profile.display_name}} (@{{metadata.slack.username}})
    {{else if metadata.slack.bot_profile}}
    🤖 {{metadata.slack.bot_profile.name}}
    {{else if isAssistant}}
    🤖 Assistant
    {{else}}
    👤 User
    {{/if}}

    💬 {{{truncate text 300}}}

    {{/each}}
    ---
    {{/if}}

agents:
  - id: "my_agent"
    inline:
      system_prompt: |
        You are a helpful assistant.

        {{{documents.my-custom-history.content}}}

        Current task: ...
```

## Variables Available

- `messages` - Array of conversation messages
- `platform` - 'slack' or 'cli'
- `messages[].text` - Message content
- `messages[].isAssistant` - true if from bot
- `messages[].metadata.slack` - Slack-specific metadata
  - `user_id` - Slack user ID
  - `username` - Slack username
  - `user_profile.display_name` - User's display name
  - `user_profile.real_name` - User's real name
  - `bot_profile.name` - Bot name

## Helpers Available

- `{{length messages}}` - Get array/string length
- `{{{truncate text 500}}}` - Truncate text with "(...+N chars)" indicator
- `{{#if (eq platform "slack")}}` - Equality check
- `{{{json object}}}` - JSON stringify