Orchestrator

All models for the Orchestrator app.

class smarter.apps.orchestrator.models.orchestrator.OrchestrationStrategy(*values)[source]

Bases: TextChoices

Coordination pattern the Orchestrator applies across its member LLMClients.

DEBATE = 'debate'
PARALLEL = 'parallel'
ROUTER = 'router'
SEQUENTIAL = 'sequential'
SUPERVISOR = 'supervisor'
VOTING = 'voting'
class smarter.apps.orchestrator.models.orchestrator.Orchestrator(*args, **kwargs)[source]

Bases: MetaDataWithOwnershipModel

Implements the Orchestrator API model.

Coordinates a collection of LLMClients (Harnesses) toward a shared agentic objective. An Orchestrator is a reusable configuration: which LLMClients participate, in what role, and in what order is tracked via OrchestratorHarness (the through model). Each concrete attempt at an objective is tracked as an OrchestrationRun, with per-invocation detail in OrchestrationStep.

Parameters:

  • id (Unknown) – Primary key: ID

  • created_at (Unknown) – Created at

  • updated_at (Unknown) – Updated at

  • name (Unknown) – Name. Name in camelCase, e.g., ‘apiKey’, no special characters.

  • description (Unknown) – Description. A brief description of this resource. Be verbose, but not too verbose.

  • version (Unknown) – Version. Semantic version in the format MAJOR.MINOR.PATCH, e.g., ‘1.0.0’.

  • annotations (Unknown) – Annotations. Key-value pairs for annotating this resource.

  • strategy (Unknown) – Strategy. Coordination pattern used to sequence/parallelize member LLMClients.

  • max_iterations (Unknown) – Max iterations. Upper bound on orchestration loop iterations; a runaway guard.

  • is_active (Unknown) – Is active

Relationship fields:

Parameters:

  • user_profile (Unknown) – User profile (related name: orchestrator)

  • tags (Unknown) – Tags. Tags for categorizing and organizing this resource. (related name: orchestrator)

  • llm_clients (Unknown) – Llm clients. LLMClients (Harnesses) available to this Orchestrator. (related name: orchestrators)

  • tagged_items (Unknown) – Tagged items (related name: +)

Reverse relationships:

Parameters:

  • harnesses (Unknown) – All harnesses of this orchestrator (related name of orchestrator)

  • runs (Unknown) – All runs of this orchestrator (related name of orchestrator)

exception DoesNotExist

Bases: ObjectDoesNotExist

exception MultipleObjectsReturned

Bases: MultipleObjectsReturned

exception NotUpdated

Bases: ObjectNotUpdated, DatabaseError

annotations

JSONField

Annotations. Key-value pairs for annotating this resource.

Type:

Type

created_at

DateTimeField

Created at

Timestamp indicating when the model instance was created.

This field is automatically set to the current date and time when the instance is first created. It is indexed in the database for efficient querying.

Type:

Type

description

TextField

Description. A brief description of this resource. Be verbose, but not too verbose.

Type:

Type

get_strategy_display(*, field=<django.db.models.CharField: strategy>)

Shows the label of the strategy. See get_FOO_display() for more information.

harnesses

Reverse ForeignKey from OrchestratorHarness

All harnesses of this orchestrator (related name of orchestrator)

Type:

Type

id

BigAutoField

Primary key: ID

Type:

Type

is_active

BooleanField

Is active

Type:

Type

llm_clients

ManyToManyField to LLMClient

Llm clients. LLMClients (Harnesses) available to this Orchestrator. (related name: orchestrators)

Type:

Type

max_iterations

PositiveIntegerField

Max iterations. Upper bound on orchestration loop iterations; a runaway guard.

Type:

Type

name

CharField

Name. Name in camelCase, e.g., ‘apiKey’, no special characters.

Type:

Type

runs

Reverse ForeignKey from OrchestrationRun

All runs of this orchestrator (related name of orchestrator)

Type:

Type

strategy

CharField

Strategy. Coordination pattern used to sequence/parallelize member LLMClients.

Choices:

  • sequential

  • parallel

  • supervisor

  • router

  • voting

  • debate

Type:

Type

tagged_items

Reverse GenericRelation from Orchestrator

All + of this tagged item (related name of tagged_items)

Type:

Type

tags = <taggit.managers._TaggableManager object>
updated_at

DateTimeField

Updated at

Timestamp indicating when the model instance was last updated.

This field is automatically updated to the current date and time whenever the instance is saved. It is indexed in the database for efficient querying.

Type:

Type

user_profile

ForeignKey to UserProfile

User profile (related name: orchestrator)

Type:

Type

user_profile_id

Internal field, use user_profile instead.

version

CharField

Version. Semantic version in the format MAJOR.MINOR.PATCH, e.g., ‘1.0.0’.

Type:

Type