Перейти к содержанию

Метки назначения операций

Во время сложной работы пользователю полезно понимать не только название вызываемого сервиса, но и зачем помощник собирается его использовать.

В 0.3.66 включена возможность меток назначения операций. Для поддерживаемой операции модель формирует короткую фразу о текущем намерении.

Пример

Вместо общего:

Используется YC - Биллинг

интерфейс может показать:

Проверяю, какой сервис дал основной рост расходов за последние 30 дней.

Это делает многошаговую работу понятнее.

Где включается

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

Системные инструменты могут использовать такие метки автоматически в зависимости от реализации.

Это не журнал действий

Метка назначения — короткое модельное описание текущего шага.

Она не заменяет:

  • журнал аудита;
  • журнал внешнего сервиса;
  • подтверждение операции;
  • точное техническое имя вызова.

Не используйте её как доказательство того, что действие действительно было выполнено.

Дополнительный расход

Формирование и передача метки может немного увеличивать объём схемы/токенов.

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

Безопасность

Метка не должна раскрывать:

  • секреты;
  • закрытые параметры;
  • полный системный запрос;
  • внутренние ключи;
  • чувствительные служебные заголовки.

Пользователь видит краткое назначение, а не внутреннюю трассировку модели.

Связь с подтверждением

Перед изменяющей операцией пользователь должен принимать решение по фактическим параметрам действия.

Метка:

Обновляю конфигурацию сервиса

не заменяет карточку подтверждения с конкретным объектом и аргументами.

Когда полезно

Хорошие кандидаты:

  • поиск по нескольким источникам;
  • многошаговый анализ Яндекс Облака;
  • FinOps;
  • длинные исследовательские задачи;
  • корпоративный помощник с несколькими сервисами.

Как проверить

  1. включите метки только для выбранного сервиса;
  2. запустите типовую задачу;
  3. убедитесь, что фразы короткие и понятные;
  4. проверьте, что они соответствуют фактическим действиям;
  5. убедитесь, что секретные данные не появляются в интерфейсе.

Что дальше