Create Version

Create a version for your product.

Returns

Returns a Version object for the given parameters, or None if an error occurs.

Example

version = galtea.versions.create(
    name=version_name,
    product_id=product_id,
    description="Demo version created via SDK",
)

Parameters

name · string · required

The name of the version.

product_id · string · required

The ID of the product you want to create a version for.

description · string

A textual description of the version.

system_prompt · string

The system prompt used with the model for this version.

model_id · string

Reference to a model configured in the Galtea Platform, used for cost tracking on this version’s inference results.

Example: linking a version to a model

Use the Model service to look up an existing model by name and pass its id to versions.create:

# Look up an existing model by name (created earlier via galtea.models.create).
selected_model = galtea.models.get_by_name(name=model_name)

# Pass its id to versions.create so Galtea can track cost for this version's
# inference results using the model's per-token pricing.
version = galtea.versions.create(
    name="v1.0-with-model-" + run_identifier,
    product_id=_demo_product_id,
    model_id=selected_model.id,
    description="Version linked to a model for cost tracking.",
)

See galtea.models.get_by_name or galtea.models.list for other ways to discover existing models.

dataset_description · string

Description of the dataset used for training or fine-tuning.

dataset_uri · string

A URI pointing to the dataset.

conversation_endpoint_connection_id · string

The ID of the Endpoint Connection used for conversational interactions with your AI product.

initialization_endpoint_connection_id · 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.

finalization_endpoint_connection_id · string

The ID of the Endpoint Connection executed after the conversation ends. Used to clean up resources.

phone_connection_id · 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.

web_rtc_connection_id · 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.

endpoint_connection_id · string

guardrails · string

Configuration or description of safety guardrails applied.

parent_version_id · 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.