К содержимому

CreateSession ​

Тип: object additionalProperties: false

ПолеОбязательноеТипОписание и ограничения
allow_multiple_runsНетbooleanНеизменяемый режим сессии. При false разрешён только запуск, созданный вместе с сессией. После его завершения, ошибки или отмены песочница удаляется. При true песочница сохраняется на паузе для следующих запусков до истечения срока хранения. Восстановление и сообщения внутри текущего запуска доступны в обоих режимах. default: false
namespaceНетstringИмя интеграции или workflow. От 1 до 128 байт UTF-8. NUL и строки только из пробелов запрещены. Точное сравнение без нормализации. minLength: 1
maxLength: 128
external_keyНетstringКлюч внешнего объекта с указанием источника. Не уникален между сессиями. От 1 до 512 байт UTF-8. NUL и строки только из пробелов запрещены. Точное сравнение. minLength: 1
maxLength: 512
input_fingerprintНетstringВерсия входных данных первого запуска. Не устраняет дубли запросов. От 1 до 256 байт UTF-8. NUL и строки только из пробелов запрещены. Точное сравнение. minLength: 1
maxLength: 256
configurationДаConfigurationInput
messagesДаarray<TextMessage>Упорядоченные сообщения пользователя, принимаемые атомарно. Последнее запускает задачу. Предыдущие сначала добавляются в контекст агента. minItems: 1
maxItems: 256
envНетobjectЯвные переменные только для before_run и after_run первого запуска. Перекрывают одноимённые значения сессии. Не передаются агенту, after_create и before_remove. additionalProperties: {"type":"string"}
servicesНетServiceCodesСервисы только для хуков before_run и after_run этого запуска, как env_from запуска. Не передаются агенту, after_create и before_remove.
env_fromНетarray<string>Разрешённые имена ENV оркестратора только для before_run и after_run первого запуска. Значения определяются перед каждым хуком и перекрывают сессионные. Не передаются агенту, after_create и before_remove.

JSON Schema ​

json
{
  "additionalProperties": false,
  "properties": {
    "allow_multiple_runs": {
      "description": "Immutable session policy. If false, only the run created with the session is allowed and its sandbox is deleted after completion, failure or cancellation. If true, the sandbox is paused for subsequent runs until its retention period expires. Recovery and messages within the current run are allowed in either mode.",
      "type": "boolean",
      "default": false
    },
    "namespace": {
      "description": "Logical integration or workflow name. Opaque identifier, 1–128 UTF-8 bytes; no NUL or whitespace-only value. Compared exactly, without normalization.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "external_key": {
      "description": "Source-qualified external object key; not unique across sessions. Opaque identifier, 1–512 UTF-8 bytes; no NUL or whitespace-only value. Compared exactly, without normalization.",
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    },
    "input_fingerprint": {
      "description": "Opaque input snapshot version for the first run; does not deduplicate requests. Opaque identifier, 1–256 UTF-8 bytes; no NUL or whitespace-only value. Compared exactly, without normalization.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "configuration": {
      "$ref": "#/components/schemas/ConfigurationInput"
    },
    "messages": {
      "description": "Ordered user messages accepted atomically. The last starts the run; earlier messages are injected into the agent context first.",
      "type": "array",
      "minItems": 1,
      "maxItems": 256,
      "items": {
        "$ref": "#/components/schemas/TextMessage"
      }
    },
    "env": {
      "description": "Explicit environment variables for the first run's before_run and after_run hooks only. Override session sources with the same names; never passed to the harness, after_create, or before_remove.",
      "type": "object",
      "additionalProperties": {
        "type": "string"
      }
    },
    "services": {
      "description": "Services available only to this run's before_run and after_run hooks, as with run env_from. Never passed to the harness, after_create, or before_remove.",
      "$ref": "#/components/schemas/ServiceCodes"
    },
    "env_from": {
      "description": "Allowlisted orchestrator environment variable names for the first run's before_run and after_run hooks only. Resolved before each hook; override session sources and are never passed to the harness, after_create, or before_remove.",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "configuration",
    "messages"
  ],
  "title": "CreateSession",
  "type": "object"
}

Все схемы · HTTP API