Skip to content

Invoke Simple Node

AI/Generative

Invokes an LLM with a system prompt and user prompt, returning text and the full structured response.

ai_generative_invoke_simplellmLong running
Inputs5
Outputs7
Security exposure5/10
Packagellm

Ratings

Scores range from 0 to 10. Higher values mean more impact, exposure, or operational weight.

SecurityAttack surface and exposure impact.
5/10Medium
PrivacyPotential sensitivity of processed data.
5/10Medium
PerformanceRuntime or resource pressure.
7/10High
GovernancePolicy, audit, or compliance impact.
5/10Medium
ReliabilityOperational stability considerations.
6/10Medium
CostExternal or compute cost impact.
5/10Medium

Input Pins

5

Input

Execution
exec_in

Execution trigger to start the invocation

Model

Struct
model

Bit describing the provider/model to execute

BitBit19 fields
idstring
default ""
typeBitTypes
enum "Llm", "Vlm", "Tts", "Stt"...default "Other"
metaMap<string, Metadata>
default {}
*Metadatamap value
namestringrequired
descriptionstringrequired
long_descriptionstring | null
release_notesstring | null
tagsArray<string>required
itemsstringarray item
+11 more fields
authorsArray<string>
default []
itemsstringarray item
repositorystring | null
default null
download_linkstring | null
default null
file_namestring | null
default null
hashstring
default ""
sizeinteger | null
format uint64default nullmin 0
hubstring
default ""
parametersvalue
default null
versionstring | null
default null
licensestring | null
default null
dependenciesArray<string>
default []
itemsstringarray item
dependency_tree_hashstring
default ""
createdstring
default ""
updatedstring
default ""
model_slugstring | null
default null
+1 more fields
Schema enforced

System Prompt

String
system_prompt

Optional system instructions to prime the assistant

Prompt

String
prompt

User message that will be sent to the model

Stream

Boolean
stream

Stream text tokens when possible. Disable to preserve structured media responses and replay them as rich chunks.

Default true

Output Pins

7

On Stream

Execution
on_stream

Executes for every streamed token chunk

Token

String
token

Most recently streamed token or chunk

Chunk

Struct
chunk

Most recent structured stream or replay chunk, including media content parts

ResponseChunkResponseChunk8 fields
idstringrequired
choicesArray<ResponseChunkChoice>required
itemsResponseChunkChoicearray item
indexinteger:int32required
format int32
deltaanyOf (2)
variant 1Deltavariant
variant 2nullvariant
finish_reasonstring | null
logprobsanyOf (2)
variant 1LogProbsvariant
variant 2nullvariant
createdinteger | null
format uint64min 0
modelstring | null
service_tierstring | null
system_fingerprintstring | null
usageanyOf (2)
variant 1Usagevariant
completion_tokensinteger:uint32required
format uint32min 0
prompt_tokensinteger:uint32required
format uint32min 0
total_tokensinteger:uint32required
format uint32min 0
costnumber | null
format double
prompt_tokens_detailsanyOf (2)
variant 1PromptTokenDetailsvariant
variant 2nullvariant
+2 more fields
variant 2nullvariant
x_prefill_progressnumber | null
format float
Schema enforced

Done

Execution
done

Signals when the invocation finished

Result

String
result

Final assistant message extracted from the response

Response

Struct
response

Full structured model response, including media content parts and reasoning

ResponseResponse8 fields
idstring | null
choicesArray<Choice>required
itemsChoicearray item
indexinteger:int32required
format int32
finish_reasonstringrequired
messageResponseMessagerequired
rolestringrequired
contentstring | null
content_partsArray<Content>

Ordered structured content returned by Rig when the assistant response contains media. Text-only responses continue to use `content` alone for OpenAI compatibility.

refusalstring | null
annotationsarray | null
+3 more fields
logprobsanyOf (2)
variant 1LogProbsvariant
variant 2nullvariant
createdinteger | null
format uint64min 0
modelstring | null
service_tierstring | null
system_fingerprintstring | null
objectstring | null
usageUsagerequired
completion_tokensinteger:uint32required
format uint32min 0
prompt_tokensinteger:uint32required
format uint32min 0
total_tokensinteger:uint32required
format uint32min 0
costnumber | null
format double
prompt_tokens_detailsanyOf (2)
variant 1PromptTokenDetailsvariant
cached_tokensinteger | null
format uint32min 0
audio_tokensinteger | null
format uint32min 0
variant 2nullvariant
+2 more fields
Schema enforced

Stats

Struct
stats

Token usage, cost, and model statistics

LLMUsageStatsLLMUsageStats5 fields
usageUsagerequired
completion_tokensinteger:uint32required
format uint32min 0
prompt_tokensinteger:uint32required
format uint32min 0
total_tokensinteger:uint32required
format uint32min 0
costnumber | null
format double
prompt_tokens_detailsanyOf (2)
variant 1PromptTokenDetailsvariant
cached_tokensinteger | null
format uint32min 0
audio_tokensinteger | null
format uint32min 0
variant 2nullvariant
+2 more fields
modelstring | null
duration_msinteger | null
format uint64min 0
iterationsinteger | null
format uint32min 0
callsArray<ModelCallEntry>
itemsModelCallEntryarray item
modelstringrequired
usageUsagerequired
completion_tokensinteger:uint32required
format uint32min 0
prompt_tokensinteger:uint32required
format uint32min 0
total_tokensinteger:uint32required
format uint32min 0
costnumber | null
format double
prompt_tokens_detailsanyOf (2)
+2 more fields
duration_msinteger | null
format uint64min 0
Schema enforced

Node Info

Internal name
ai_generative_invoke_simple
Category
AI/Generative
Version
5