Action AI
AI Prompt
Executes a prompt against a large language model. This node requires an API key to be set in the Project Succession Vault Settings. Specify the vault key name in the 'API Key (Vault)' parameter.
Node IDAiPromptAction
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
Provider provider | enum | Yes | OpenAI | The AI provider to use (OpenAI, Anthropic, or Google). |
Model model | string | Yes | gpt-4o | The model identifier to use (e.g., "gpt-4o", "claude-sonnet-4-5", "gemini-2.5-flash"). |
API Key (Vault) api_key_vault_name | string | Yes | OPENAI_API_KEY | The name of the vault key containing the API key (e.g., "OPENAI_API_KEY", "ANTHROPIC_API_KEY", "GEMINI_API_KEY"). |
Prompt Template prompt | textarea | Yes | — | The prompt template to send to the model. Use {key} syntax to insert data from the input object's 'value' field (e.g., "Describe a {character_class} named {character_name}."). |
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
Execute & Data input0 | object | No | An execution signal. The 'value' of the data object can be used to format the prompt template. |
Outputs
| Output | Type | Identifier | Description |
|---|---|---|---|
Response output0 | object | ai_response | Emits a standard data object containing the text response from the AI model. |
On Error output1 | object | ai_error | Emits a standard data object containing an error message if the node fails (e.g., missing API key). |