Returns
Returns a Version object for the given parameters, orNone if an error occurs. When the platform stores it but cannot return it, create raises WrittenResourceUnreadableException instead: do not create it again. The returned object carries the number Galtea allocated, and the name the version is stored under.
Example
Parameters
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.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.Example: linking a version to a model
Example: linking a version to a model
Use the Model service to look up an existing model by name and pass its See
id to versions.create:galtea.models.get_by_name or galtea.models.list for other ways to discover existing models.The ID of the Endpoint Connection used for conversational interactions with your AI product.
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.
The ID of the Endpoint Connection executed after the conversation ends. Used to clean up resources.
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.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.
Legacy parameter maintained for backwards compatibility. Maps to
conversation_endpoint_connection_id.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.
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 API refuses a filter expression such as [?(...)] in path and in predicate.path. The version value overrides the product value, which overrides the organization value. See Recover the turn input from a non-LLM span.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 API refuses a filter expression such as [?(...)] in path and in predicate.path. The version value overrides the product value, which overrides the organization value. See Recover replies that do not come from the LLM.