Выполнения и использование
Каждый запуск записывается с версией, причиной действия, уверенностью и — если вы разрешите — входными и выходными данными. Находите выполнения, смотрите использование и сроки хранения журналов.
Выполнения
Каждый запуск — из API или из Playground, успешный или нет — записывается как выполнение. Его ID — это execution_id из ответа.
| Что записывается | Примечания |
|---|---|
| Решение и версия | v3 или draft для запусков в Playground |
| Источник | API или Playground |
| Статус и ошибка | Успешно или Ошибка, с кодом и сообщением ошибки |
| Действие и причина действия | для успешных запусков |
| Задержка, модель, входные и выходные токены, оценка стоимости | модель — точная версия, которая ответила |
| ID запроса | X-Request-ID вызова — ваш или сгенерированный Dcision |
Входные данные (state) | только если у решения включён storeInput |
| Результат, уверенность, взвешенные уровни, composites, распределения | только если включён storeOutput |
| Назначения | записи назначений запуска — ответы, ответы LLM и агентов, функции с их параметрами, поставленные в очередь доставки — независимо от storeInput и storeOutput |
Неудачные вызовы тоже записываются — включая некорректные state (INVALID_STATE, в том числе превышение бюджета токенов) и ошибки движка, — чтобы вы видели, что отправляет ваша интеграция. Вызов, на который ответил fallback при ошибке движка, записывается как Ошибка с кодом движка, хотя API вернул 200. Запросы, отклонённые до запуска решения, — неверный ключ или тело, неизвестное, отключённое или неопубликованное решение, rate limit, блокировка по квоте, идемпотентный повтор — не записываются.
Найдите выполнение
Раздел Выполнения показывает сначала самые свежие запуски, по 50 за раз (Загрузить более ранние — чтобы увидеть больше). Фильтруйте по статусу, источнику и решению или ищите по началу ID выполнения либо по названию или slug решения. Выбор запуска открывает его подробности: действие и причину, ошибку, задержку, модель, оценку стоимости, ID запроса, входные данные, результат и распределение каждого вопроса, его назначения с текущим статусом доставок — а также Повторить эти входные данные в Playground.
Записывайте ID
Сохраняйте execution_id вместе с записью, по которой действовало ваше приложение, и отправляйте собственный X-Request-ID, чтобы сопоставлять запуски Dcision с вашими журналами.
Читайте выполнения из кода
GET /v1/executions возвращает те же запуски по API-ключу — ответы, действие, причину, статус, код ошибки и метрики, с фильтрами по решению и статусу, сначала новые. Он никогда не возвращает входные данные: сохранённые state остаются в приложении, для участников рабочего пространства.
Использование
Раздел Использование подводит итоги за сегодня, последние 7 или последние 30 дней:
- вызовы API и запуски в Playground;
- успешные решения и доля ошибок;
- средняя задержка всех запусков, а также p50 и p95 задержки успешных запусков;
- оценка стоимости движка и входные токены;
- график объёма — по часам за сегодня, иначе по дням — с ошибками пунктирной линией;
- разбивка по решениям: вызовы, ошибки, средняя задержка, оценка стоимости и доля.
Верхняя карточка показывает оплачиваемые решения текущего расчётного периода относительно включённого объёма вашего тарифа — это же доступно из кода через GET /v1/me. Панель повторяет ключевые цифры (выполненные решения, задержка p95, доля успешных, оценка стоимости движка) вместе с вашими работающими решениями, последними выполнениями и чек-листом для начала работы.
По каждому решению: Обзор
Первая вкладка каждого решения, Обзор, подводит итоги его запусков за 7, 30 или 90 дней — доля успешных, задержка, стоимость, действия и их причины, статистика по вопросам, назначения — и подсказывает, что откалибровать. См. Обзор и калибровка.
Хранение
Ежедневное задание удаляет выполнения старше меньшего из двух сроков: срока хранения вашего тарифа и настройки рабочего пространства (Настройки → Хранение журнала выполнений):
| Тариф | Хранение журнала |
|---|---|
| Genesis | 7 дней |
| Developer | 14 дней |
| Growth | 30 дней |
| Enterprise | 365 дней |
Например, рабочее пространство Growth с настройкой 7 дней хранит 7 дней; рабочее пространство Genesis с настройкой 90 дней хранит 7.
- Графики и таблицы использования строятся по выполнениям, поэтому охватывают только ещё хранящиеся запуски.
- Оплата не зависит от журналов. Оплачиваемые решения считаются отдельно, по часам, и эти счётчики хранятся около 400 дней: срок хранения никогда не возвращает квоту и не меняет сумму оплаты.
- Удаление решения сразу удаляет его выполнения.
- У доставок назначений собственный срок хранения: они удаляются через 30 дней после создания — см. Доставка и повторные попытки.
Оповещения о квоте
Владельцы рабочего пространства получают письмо, когда оплачиваемые решения за период достигают 80% и 100% включённого объёма — по одному разу на каждый уровень за период. См. Тарифы, квоты и оплата.
Playground
Тестируйте черновики — включая несохранённые правки — на реальных данных, читайте уверенность и распределения, просматривайте назначения, сравнивайте запуски и движки и повторяйте прошлые входные данные.
Обзор паттернов
Четыре архитектурных паттерна TypeSafe — спекулятивный fan-out, маршрутизация с порогом уверенности, композитная оценка и маршрутизация по намерению — и как каждый соотносится с функциями и шаблонами Dcision.