Director Auto-Direction Nodes
The director's automatic direction loop: pick candidates, determine scene intent, decide when an instruction is due and generate the auto-direction itself.
6 nodes.
| Node | Registry path |
|---|---|
| Auto Direction | agents/director/auto-direct/AutoDirection |
| Auto Direct Candidates [DEPRECATED] | agents/director/auto-direct/Candidates |
| Determine Scene Intent | agents/director/auto-direct/DetermineSceneIntent |
| Generate Auto Direction | agents/director/auto-direct/generateAutoDirection |
| Generate Scene Types | agents/director/auto-direct/GenerateSceneTypes |
| Is Due For Instruction [DEPRECATED] | agents/director/auto-direct/IsDueForInstruction |
Auto Direction
agents/director/auto-direct/AutoDirection
Node module (base type core/Graph) defined in src/talemate/agents/director/modules/auto-direction.json.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
Outputs
| Output | Type | Description |
|---|---|---|
state |
`` |
Auto Direct Candidates [DEPRECATED]
agents/director/auto-direct/Candidates
Returns a list of characters that are valid for doing the next action, based on the director's auto-direct settings and the recent scene history.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
Outputs
| Output | Type | Description |
|---|---|---|
characters |
list |
Determine Scene Intent
agents/director/auto-direct/DetermineSceneIntent
Has the director determine the current scene intent and set it on the scene's intent state (the director may also decide to leave the current intent unchanged).
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The graph state |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The state input, passed through |
scene_phase |
scene_intent/scene_phase |
The scene's phase after the determination (None if the director decided not to set one) |
Generate Auto Direction
agents/director/auto-direct/generateAutoDirection
Node module (base type core/Graph) defined in src/talemate/agents/director/modules/generate-auto-direction.json.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
|
characters |
list |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
|
actor_direction |
any |
|
narrator_direction |
any |
Generate Scene Types
agents/director/auto-direct/GenerateSceneTypes
Has the director generate scene types (or pick them from the scene type templates) and register them on the scene's intent state.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The graph state |
instructions |
str |
Instructions guiding the scene type generation (optional) |
max_scene_types |
int |
The maximum number of scene types to generate (optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The state input, passed through |
scene_types |
list |
The generated scene types |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
instructions |
text |
"" |
The instructions for the scene types |
max_scene_types |
int |
1 |
The maximum number of scene types to generate |
Is Due For Instruction [DEPRECATED]
agents/director/auto-direct/IsDueForInstruction
Checks if the actor is due for instruction based on the auto-direct settings.
Inputs
| Input | Type | Description |
|---|---|---|
actor_name |
str |
Outputs
| Output | Type | Description |
|---|---|---|
is_due |
bool |
|
actor_name |
str |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
actor_name |
str |
"" |
The name of the actor to check instruction timing for |