# Summarizer Agent Nodes

Summarization through the summarizer agent: scene progression summaries and tag generation.

<!-- glossary:generated - everything below this line is generated by `python -m talemate.game.engine.nodes.tools glossary --write` - do not edit -->


_5 nodes._

| Node | Registry path |
| --- | --- |
| [Generate Tags](#generate-tags) | `agents/summarize/generateTags` |
| [On Message Set Avatar](#on-message-set-avatar) | `agents/summarizer/onMessageSetAvatar` |
| [Summarizer Settings](#summarizer-settings) | `agents/summarizer/Settings` |
| [Summarize Scene Progression](#summarize-scene-progression) | `agents/summarizer/summarizeSceneProgression` |
| [Wsh Summarize Scene Progress](#wsh-summarize-scene-progress) | `agents/summarizer/websocket/wshSummarizeSceneProgress` |

## Generate Tags

`agents/summarize/generateTags`

Node module (base type `core/Graph`) defined in `src/talemate/agents/summarize/modules/generate-tags.json`.

**Inputs**

| Input | Type | Description |
| --- | --- | --- |
| `state` | `any` |  |
| `text` | `str` |  |
| `instructions` | `str` |  |

**Outputs**

| Output | Type | Description |
| --- | --- | --- |
| `state` | `any` |  |
| `text` | `str` |  |
| `instructions` | `str` |  |
| `tags` | `list` |  |
| `tags_str` | `str` |  |

## On Message Set Avatar

`agents/summarizer/onMessageSetAvatar`

Node module (base type `core/Event`) defined in `src/talemate/agents/world_state/modules/on-message-set-avatar.json`.

**Properties**

| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `event_name` | `str` | `"agent.conversation.generated"` | Event to listen for |
| `auto_register` | `bool` | `False` | Self-register from the node registry instead of requiring placement in the scene loop graph |

## Summarizer Settings

`agents/summarizer/Settings`

Base node to render summarizer agent settings.

Every setting of the summarizer agent is exposed as an output socket named after the setting - see the agent's documentation under [Agents](../../../agents/index.md) for what each setting does.

## Summarize Scene Progression

`agents/summarizer/summarizeSceneProgression`

Node module (base type `core/Graph`) defined in `src/talemate/agents/summarize/modules/summarize-scene-progression.json`.

**Inputs**

| Input | Type | Description |
| --- | --- | --- |
| `state` | `any` |  |

**Outputs**

| Output | Type | Description |
| --- | --- | --- |
| `state` | `any` |  |
| `summary` | `str` |  |
| `analysis` | `str` |  |

## Wsh Summarize Scene Progress

`agents/summarizer/websocket/wshSummarizeSceneProgress`

Node module (base type `agents/AgentWebsocketHandler`) defined in `src/talemate/agents/summarize/modules/wsh-summarize-scene-progress.json`.

**Outputs**

| Output | Type | Description |
| --- | --- | --- |
| `fn` | `function` |  |
| `name` | `str` |  |
| `allow_multiple_calls` | `bool` |  |
| `ai_callback` | `focal/callback` |  |

**Properties**

| Property | Type | Default | Description |
| --- | --- | --- | --- |
| `name` | `str` | `"summarize_scene_progress"` | The name of the handler |
| `agent` | `str` | `"summarizer"` | The agent to register the handler on. Choices are generated at runtime. |