Структура данных

При подключении блоков важно понимать структуру данных различных выходов блоков, потому что структура выходных данных из исходного блока определяет, какие значения доступны в целевом блоке. Каждый тип блока производит специфическую выходную структуру, которую можно использовать в последующих блоках.

Понимание этих структур данных необходимо для эффективного использования тегов подключений и доступа к правильным данным в ваших рабочих процессах.

Структуры выходов блоков

Разные типы блоков производят разные выходные структуры. Вот что можно ожидать от каждого типа блока:

{
  "content": "Сгенерированный текстовый ответ",
  "model": "gpt-4o",
  "tokens": {
    "prompt": 120,
    "completion": 85,
    "total": 205
  },
  "toolCalls": [...],
  "cost": [...],
  "usage": [...]
}

Поля выхода блока агента

content: Основной текстовый ответ, сгенерированный агентом
model: Используемая модель ИИ (например, "gpt-4o", "claude-3-opus")
tokens: Статистика использования токенов
- prompt: Количество токенов в промпте
- completion: Количество токенов в ответе
- total: Общее количество использованных токенов
toolCalls: Массив вызовов инструментов, выполненных агентом (если есть)
cost: Массив объектов стоимости для каждого вызова инструмента (если есть)
usage: Статистика использования токенов для всего ответа

{
  "data": "Данные ответа",
  "status": 200,
  "headers": {
    "content-type": "application/json",
    "cache-control": "no-cache"
  }
}

Поля выхода блока API

data: Данные ответа от API (может быть любого типа)
status: HTTP-код статуса ответа
headers: HTTP-заголовки, возвращенные API

{
  "result": "Возвращаемое значение функции",
  "stdout": "Вывод консоли",
}

Поля выхода блока функции

result: Возвращаемое значение функции (может быть любого типа)
stdout: Вывод консоли, захваченный во время выполнения функции

{
  "content": "Сводка оценки",
  "model": "gpt-5",
  "tokens": {
    "prompt": 120,
    "completion": 85,
    "total": 205
  },
  "metric1": 8.5,
  "metric2": 7.2,
  "metric3": 9.0
}

Поля выхода блока оценщика

content: Сводка оценки
model: Модель ИИ, используемая для оценки
tokens: Статистика использования токенов
[metricName]: Оценка для каждой метрики, определенной в оценщике (динамические поля)

{
  "conditionResult": true,
  "selectedPath": {
    "blockId": "2acd9007-27e8-4510-a487-73d3b825e7c1",
    "blockType": "agent",
    "blockTitle": "Follow-up Agent"
  },
  "selectedOption": "condition-1"
}

Поля выхода блока условия

conditionResult: Логический результат оценки условия
selectedPath: Информация о выбранном пути
- blockId: ID следующего блока в выбранном пути
- blockType: Тип следующего блока
- blockTitle: Название следующего блока
selectedOption: ID выбранного условия

{
  "content": "Решение маршрутизации",
  "model": "gpt-4o",
  "tokens": {
    "prompt": 120,
    "completion": 85,
    "total": 205
  },
  "selectedPath": {
    "blockId": "2acd9007-27e8-4510-a487-73d3b825e7c1",
    "blockType": "agent",
    "blockTitle": "Customer Service Agent"
  }
}

Поля выхода блока маршрутизатора

content: Текст решения маршрутизации
model: Модель ИИ, используемая для маршрутизации
tokens: Статистика использования токенов
selectedPath: Информация о выбранном пути
- blockId: ID выбранного целевого блока
- blockType: Тип выбранного блока
- blockTitle: Название выбранного блока

Пользовательские структуры выходов

Некоторые блоки могут производить пользовательские структуры выходов на основе их конфигурации:

Блоки агентов с форматом ответа: При использовании формата ответа в блоке агента, структура выхода будет соответствовать определенной схеме вместо стандартной структуры.
Блоки функций: Поле result может содержать любую структуру данных, возвращаемую вашим кодом функции.
Блоки API: Поле data будет содержать то, что возвращает API, что может быть любой допустимой структурой JSON.

Всегда проверяйте фактическую структуру выхода ваших блоков во время разработки, чтобы убедиться, что вы ссылаетесь на правильные поля в ваших подключениях.

Вложенные структуры данных

Многие выходы блоков содержат вложенные структуры данных. Вы можете получить к ним доступ, используя точечную нотацию в тегах подключений:

<blockName.path.to.nested.data>

Например:

<agent1.tokens.total> - Доступ к общему количеству токенов из блока агента
<api1.data.results[0].id> - Доступ к ID первого результата из ответа API
<function1.result.calculations.total> - Доступ к вложенному полю в результате блока функции