Skip to content
LOPS Docs

Role Creator Operator

Overview

Section titled “Overview”

The Role Creator operator generates system prompts (personas) for AI assistants. It takes a user-provided description of the desired persona and uses a meta-prompt (a set of instructions for the LLM) to craft a tailored system prompt. This generated prompt can then be easily assigned to an Agent operator to define its behavior.

Role Creator Operator

Parameters

Section titled “Parameters”

Page: Options

Section titled “Page: Options”
Active (Active) op('role_creator').par.Active Toggle
Default:
Off
Options:
off, on
Generate Persona Prompt (Generateprompt) op('role_creator').par.Generateprompt Pulse
Default:
0
Persona Description (Promptdescription) op('role_creator').par.Promptdescription Str
Default:
"" (Empty String)
Meta Prompt DAT (Metapromptdat) op('role_creator').par.Metapromptdat OP
Default:
./meta_prompt_dat
Assign Output DAT to Agent (Addreftoagent) op('role_creator').par.Addreftoagent Toggle
Default:
Off
Options:
off, on
Send Text to Agent (Sendtoagent) op('role_creator').par.Sendtoagent Toggle
Default:
On
Options:
off, on
Agent Path (Agent) op('role_creator').par.Agent OP
Default:
"" (Empty String)
Reset (This LOP) (Reset) op('role_creator').par.Reset Pulse
Default:
0
Display (Display) op('role_creator').par.Display Menu
Default:
MetaPrompt
Options:
Output, History, MetaPrompt, Info, ModelDetails

Page: Model

Section titled “Page: Model”

Understanding Model Selection

Operators utilizing LLMs (LOPs) offer flexible ways to configure the AI model used:

  • ChatTD Model (Default): By default, LOPs inherit model settings (API Server and Model) from the central ChatTD component. You can configure ChatTD via the "Controls" section in the Operator Create Dialog or its parameter page.
  • Custom Model: Select this option in "Use Model From" to override the ChatTD settings and specify the API Server and AI Model directly within this operator.
  • Controller Model: Choose this to have the LOP inherit its API Server and AI Model parameters from another operator (like a different Agent or any LOP with model parameters) specified in the Controller [ Model ] parameter. This allows centralizing model control.

The Search toggle filters the AI Model dropdown based on keywords entered in Model Search. The Show Model Info toggle (if available) displays detailed information about the selected model directly in the operator's viewer, including cost and token limits.

Available LLM Models + Providers Resources

The following links point to API key pages or documentation for the supported providers. For a complete and up-to-date list, see the LiteLLM provider docs.

Output Settings Header
Max Tokens (Maxtokens) op('role_creator').par.Maxtokens Int

The maximum number of tokens the model should generate.

Default:
4096
Temperature (Temperature) op('role_creator').par.Temperature Float

Controls randomness in the response. Lower values are more deterministic.

Default:
0.7
Model Selection Header
Use Model From (Modelselection) op('role_creator').par.Modelselection Menu

Choose where the model configuration comes from.

Default:
chattd_model
Options:
chattd_model, custom_model, controller_model
Controller [ Model ] (Modelcontroller) op('role_creator').par.Modelcontroller OP

Operator providing model settings when 'Use Model From' is set to controller_model.

Default:
None
Select API Server (Apiserver) op('role_creator').par.Apiserver StrMenu

Select the LiteLLM provider (API server).

Default:
openrouter
Menu Options:
  • openrouter (openrouter)
  • openai (openai)
  • groq (groq)
  • gemini (gemini)
  • ollama (ollama)
  • lmstudio (lmstudio)
  • custom (custom)
AI Model (Model) op('role_creator').par.Model StrMenu

Specific model to request. Available options depend on the selected provider.

Default:
google/gemini-flash-1.5
Menu Options:
  • google/gemini-flash-1.5 (google/gemini-flash-1.5)
Search (Search) op('role_creator').par.Search Toggle

Enable dynamic model search based on a pattern.

Default:
off
Options:
off, on
Model Search (Modelsearch) op('role_creator').par.Modelsearch Str

Pattern to filter models when Search is enabled.

Default:
"" (Empty String)
Search Models (Search) op('role_creator').par.Search Toggle
Default:
Off
Options:
off, on
Model Search (Modelsearch) op('role_creator').par.Modelsearch Str
Default:
"" (Empty String)

Usage Examples

Section titled “Usage Examples”

Generate a Simple Persona

Section titled “Generate a Simple Persona”
  1. In the Persona Description parameter, enter text like: “You are a helpful assistant that only speaks like a pirate.”
  2. Pulse the Generate Persona Prompt parameter.
  3. View the generated pirate-themed system prompt in the Output display mode or the output_dat.

Assign Persona to an Agent

Section titled “Assign Persona to an Agent”
  1. Create an Agent operator (e.g., named agent1).
  2. In the Role Creator’s Agent Path parameter, enter the path: ../agent1.
  3. Enter a Persona Description (e.g., “You are a concise expert on TouchDesigner.”).
  4. Pulse Generate Persona Prompt.
  5. Enable the Assign Output DAT to Agent toggle. The agent1 operator’s ‘System Message DAT’ parameter will now reference the Role Creator’s output.
  6. Alternatively, enable Send Text to Agent to copy the text directly into the Agent’s system message DAT.

Technical Notes

Section titled “Technical Notes”
  • This operator relies on a connection to a configured ChatTD operator (specified on the ‘About’ page) to perform the LLM call for generation. Ensure the ChatTD operator is set up correctly with API keys and necessary configurations.
  • The quality of the generated persona depends heavily on the clarity of the Persona Description and the instructions within the Meta Prompt DAT.
Section titled “Related Operators”
  • Agent: The operator that typically uses the system prompts generated by Role Creator.
  • ChatTD: The core component handling LLM API communication, required by Role Creator.