Agent UUID — это стабильный идентификатор воркфлоу. В API-роутах и payload’ах он также может называться workflow_uuid. В отличие от числовых ID воркфлоу, Agent UUID переносим между окружениями и не меняется при публикации новых версий одного и того же воркфлоу.

Где его найти

Скопировать Agent UUID можно в двух местах панели.

В редакторе воркфлоу

  1. Откройте вашего агента в редакторе воркфлоу
  2. Нажмите на меню в правом верхнем углу шапки
  3. Нажмите Copy Agent UUID

На странице Settings агента

  1. Откройте агента и перейдите в Settings
  2. Прокрутите до раздела Agent UUID
  3. Нажмите на блок кода с UUID или используйте Copy UUID

Где он используется

Используйте Agent UUID для роутов уровня воркфлоу, например:
  • POST /api/v1/public/agent/workflow/{workflow_uuid}
  • POST /api/v1/public/agent/test/workflow/{workflow_uuid}
  • wss://<your-host>/api/v1/agent-stream/{agent_uuid}
Не путайте Agent UUID с UUID узла API Trigger (trigger_path).
  • Используйте Agent UUID для роутов уровня воркфлоу, например /public/agent/workflow/{workflow_uuid}
  • Используйте UUID узла API Trigger для роутов триггеров, например /public/agent/{uuid}
  • Путь узла API Trigger можно отредактировать, если нужно что-то более описательное
  • Agent UUID генерируется Агентикой и не может быть изменён
См. API Trigger для URL узлов-триггеров.