Tela SDK for JavaScript
    Preparing search index...

    Interface AsyncExecutionParams

    Configuration for asynchronous canvas execution with polling. The execution starts immediately but results must be retrieved via polling.

    interface AsyncExecutionParams {
        applicationId?: string;
        async?: true;
        canvasId?: string;
        label?: string;
        messages?: { content: string; role: string }[];
        override?: {
            functions?: {
                description?: string;
                id: string;
                name: string;
                parameters?: {
                    properties: Record<string, unknown>;
                    required?: string[];
                    type: "object";
                };
            }[];
            model?: string;
            temperature?: number;
            type: "chat"
            | "completion";
        };
        pollingInterval?: string
        | number;
        pollingTimeout?: string | number;
        skipResultValidation?: boolean;
        stream?: undefined;
        tags?: string[];
        versionId?: string;
        webhookUrl?: string;
    }

    Hierarchy (View Summary)

    Index

    Properties

    applicationId?: string

    The ID of the deployed application to use for this chat completion. This is required if a canvasId is not provided.

    async?: true

    Enable asynchronous execution mode.

    false
    
    canvasId?: string

    The ID of the canvas to use for this chat completion. This is required if an applicationId is not provided.

    label?: string

    Optional label for this execution when using applicationId. This label can be used to identify or categorize the execution. Note: This field is only applicable when applicationId is provided.

    messages?: { content: string; role: string }[]

    An array of previous messages in the conversation. Each message should have a 'role' (e.g., 'user', 'assistant') and 'content'.

    override?: {
        functions?: {
            description?: string;
            id: string;
            name: string;
            parameters?: {
                properties: Record<string, unknown>;
                required?: string[];
                type: "object";
            };
        }[];
        model?: string;
        temperature?: number;
        type: "chat"
        | "completion";
    }

    Override default settings specified in the canvas. This allows for fine-tuning the completion behavior for this specific request.

    Type Declaration

    • Optionalfunctions?: {
          description?: string;
          id: string;
          name: string;
          parameters?: {
              properties: Record<string, unknown>;
              required?: string[];
              type: "object";
          };
      }[]

      An array of functions that the model can call. This allows for more structured and interactive completions.

    • Optionalmodel?: string

      The specific model to use for this completion. If not specified, the default model set in the canvas will be used.

    • Optionaltemperature?: number

      Controls randomness in the output. Values between 0 and 1. Lower values make the output more focused and deterministic.

    • type: "chat" | "completion"

      Specifies whether to use a chat or completion model.

    pollingInterval?: string | number

    Time (in milliseconds if number) between polling attempts (e.g. "1s", "1m", "1h", "1d").

    1000
    
    pollingTimeout?: string | number

    Maximum time (in milliseconds if number) to wait for completion before timing out (e.g. "1s", "1m", "1h", "1d").

    60000
    
    skipResultValidation?: boolean

    Whether to skip Zod schema validation on execution results. When true, results are typecast to the expected output type without validation.

    false
    
    stream?: undefined

    Stream mode is not available for async executions.

    tags?: string[]

    Optional array of tags to associate with this execution. Tags can be used for filtering, categorization, and analytics.

    versionId?: string

    The version ID of the canvas to use for this chat completion. If not provided, the latest version of the specified canvas will be used.

    webhookUrl?: string

    Optional webhook URL to receive completion notifications.