Skip to main content
To get the version of one agent state, use Get or Create Version instead. It returns the version that holds your facts, and creates it only the first time. So a script that runs again, or two jobs that run at the same time, reuse one version.

​
Returns

Returns a Version object for the given parameters, or None if an error occurs. The returned object carries the number Galtea allocated, and the name the version is stored under.

​
Example

​
Parameters

​
string
Your own label for the version. Leave it out and Galtea stores the version under its label, v followed by its number, for example v7.A create with no name needs an API that allocates version numbers. A self-hosted deployment older than that still requires a name and refuses the create. Pass a name against such a deployment.
A name of v followed by digits is reserved for version labels. The check ignores upper and lower case, so V7 follows the same rule as v7. Galtea accepts such a name only when it is the version’s own label, so version 7 accepts v7 and refuses v3. It always refuses v01, v007 and v0, because no version is ever labelled that way. A name such as v1.0 is outside the reserved shape and stays valid.
​
string
required
The ID of the product you want to create a version for.
​
string
A textual description of the version.
​
string
The system prompt used with the model for this version.
​
string
Reference to a model configured in the Galtea Platform, used for cost tracking on this version’s traces. versions.create sends no facts. To link the model from a model fact, use versions.get_or_create.
Use the Model service to look up an existing model by name and pass its id to versions.create:
See galtea.models.get_by_name or galtea.models.list for other ways to discover existing models.
​
string
Description of the dataset used for training or fine-tuning.
​
string
A URI pointing to the dataset.
​
string
The ID of the Endpoint Connection used for conversational interactions with your AI product.
​
string
The ID of the Endpoint Connection executed before the conversation begins. Used to initialize a session and obtain a session ID. See Version Endpoint Connections for more details.
​
string
The ID of the Endpoint Connection executed after the conversation ends. Used to clean up resources.
​
string
The ID of the Phone Connection Galtea dials to reach your AI agent over the phone. A version’s conversation target is mutually exclusive: provide one of a phone connection, a WebRTC connection (web_rtc_connection_id), or an endpoint connection (conversation_endpoint_connection_id), never more than one.
​
string
The ID of the WebRTC Connection Galtea uses to reach your AI agent over WebRTC. A version’s conversation target is mutually exclusive: provide one of a WebRTC connection, a phone connection (phone_connection_id), or an endpoint connection (conversation_endpoint_connection_id), never more than one.
​
string
Deprecated. Use conversation_endpoint_connection_id instead.
Legacy parameter maintained for backwards compatibility. Maps to conversation_endpoint_connection_id.
​
string
Configuration or description of safety guardrails applied.
​
string
The ID of the parent version this version is iterated from. Setting it makes the new version a revision of the parent and records the lineage. The parent must belong to the same product. Leave it empty to create a root version. See Version Lineage for details.
​
dict
Recovers a turn’s input from a non-LLM span, for products whose user message is not on the LLM span. An object with spanName, attribute, path and an optional predicate. The version value overrides the product value. See Recover the turn input from a non-LLM span.
​
dict
Recovers a turn’s output from a non-LLM span, for templated or non-LLM replies. Same four parts as otel_input_source_rule. The version value overrides the product value. See Recover replies that do not come from the LLM.