ВозможностиДокументацияЦеныPlaygroundFAQ

Tags

Тегирование агентов для группировки и фильтрации

Обзор

Tags позволяют группировать агентов по среде, роли, команде или любым другим метаданным. Все операции через API — чтение, добавление, обновление, удаление тегов.

Сценарии использования

Environment

группировка серверов по staging/prod/preview

Team

тег по команде или владельцу (frontend/backend/mobile)

Role

тег по типу сервиса (api/db/cron/workers)

API эндпоинты

bash
# Список всех тегов
GET /api/v1/tags

# Получить агентов по тегу
GET /api/v1/agents/tags?tag=production

# Добавить теги агенту
PUT /api/v1/agents/{id}/tags
Body: { "tags": ["prod", "critical"] }

# Удалить теги у агента
DELETE /api/v1/agents/{id}/tags
Body: { "tags": ["staging"] }

Примеры использования

bash
# Тегирование агентов
curl -X PUT https://flowlink.flow-masters.ru/api/v1/agents/my-server-1/tags \
  -H "Authorization: Bearer flk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "tags": ["production", "critical", "payment-gateway"]
  }'

# Запрос по тегам
curl https://flowlink.flow-masters.ru/api/v1/agents/tags?tag=payment-gateway

# Несколько тегов (OR логика)
curl https://flowlink.flow-masters.ru/api/v1/agents/tags?tag=production&tag=critical

Лучшие практики

  • •Используйте префиксы env, team, role для согласованности
  • •Не используйте пробелы — предпочтительны дефисы: frontend-api
  • •Имена тегов нечувствительны к регистру, но храните согласованно
  • •Максимум 50 тегов на агента — избегайте захламления
← AgentsCommands →