Реестр возможностей времени выполнения

Узнайте о возможностях времени выполнения и о том, как AACWorkflow маршрутизирует агентов к подходящим средам выполнения на основе поддерживаемых ими функций.

Реестр возможностей времени выполнения — это структурированная база данных того, что может делать каждая среда выполнения: какие поставщики ИИ она поддерживает, на каких операционных системах она работает, к каким инструментам MCP у неё есть доступ, и поддерживает ли она дополнительные функции, такие как импорт навыков и возобновление задач.

Почему возможности важны

Когда вы назначаете агенту задачу, AACWorkflow должен знать:

Какие среды выполнения могут запустить этого агента? — Демон, работающий на macOS, не может выполнять задачи Docker
Какие поставщики ИИ доступны? — Некоторые среды выполнения имеют Claude, другие имеют Claude и Cursor
Какие инструменты MCP подключены? — Среда выполнения, подключённая к GitHub, может общаться с GitHub, среда без подключения не может
Может ли среда выполнения возобновлять задачи? — Для долгосрочных задач некоторые среды выполнения поддерживают возобновление с контрольной точки

Реестр возможностей ответит на все эти вопросы автоматически.

Просмотр возможностей времени выполнения

Через пользовательский интерфейс

Перейдите на Параметры → Среды выполнения
Нажмите на среду выполнения, чтобы увидеть её детальную страницу
Прокрутите до раздела Возможности

Вы увидите:

ОС и архитектура — Linux x86_64, macOS ARM64 и т. д.
Тип исполнителя — host (прямой процесс) или docker (контейнеризованный)
Поставщики ИИ — какие поставщики установлены (Claude, Codex, Cursor и т. д.)
Выбор модели — поддерживает ли поставщик выбор конкретной модели
Транспорты MCP — как среда выполнения взаимодействует с серверами MCP (stdio, SSE, HTTP)
Дополнительные функции — поддержка возобновления, импорт навыков и т. д.

Через API

Возможности времени выполнения также доступны в ответе API для /workspaces/{ws}/runtimes/{id}:

{
  "id": "runtime-123",
  "name": "My macOS daemon",
  "capabilities": {
    "schema_version": 1,
    "os": "macos",
    "arch": "arm64",
    "executor": "host",
    "providers": [
      {
        "provider": "claude",
        "cli_version": "1.2.3",
        "model_selection": true,
        "models": ["claude-opus-4", "claude-sonnet-4"]
      }
    ],
    "mcp_transports": ["stdio", "sse"],
    "supports_resume": true,
    "supports_skill_path": true,
    "labels": ["macos", "arm64", "claude", "mcp-stdio"]
  }
}

Понимание полей возможностей

ОС и архитектура

ОС — macos, linux или windows
Архитектура — arm64, amd64 (x86-64), arm или 386

Это важно, если вашему агенту нужно запускать скрипты или инструменты, специфичные для ОС.

Тип исполнителя

host — задачи выполняются непосредственно на ОС демона с полным доступом
docker — задачи выполняются в контейнеризованной среде, более изолированной

Среды выполнения Docker полезны для изоляции ненадёжного кода или обеспечения воспроизводимости.

Поставщики

Каждая запись поставщика показывает:

Имя поставщика — claude, codex, cursor и т. д.
Версия CLI — версия установленного инструмента ИИ
Выбор модели — поддерживает ли демон выбор конкретной модели
Список моделей — какие модели доступны (если известно)

Если агент настроен на использование конкретной модели, AACWorkflow проверяет этот список, чтобы убедиться, что среда выполнения её поддерживает.

Транспорты MCP

MCP (Model Context Protocol) поддерживает несколько механизмов транспорта:

stdio — взаимодействие через стандартный ввод/вывод (по умолчанию, локально)
sse — Server-Sent Events (потоковая передача HTTP)
http — прямые HTTP-запросы

Среда выполнения с поддержкой только stdio может подключаться только к серверам MCP на основе stdio; она не может использовать удалённые серверы MCP на основе HTTP.

Дополнительные функции

Поддержка возобновления — может ли среда выполнения приостановить и возобновить долгосрочные задачи?
Поддержка пути навыков — может ли среда выполнения загружать навыки из локальных путей файлов в дополнение к базе данных?

Маршрутизация на основе возможностей

Когда вы назначаете агенту задачу, маршрутизатор AACWorkflow использует возможности для поиска подходящей среды выполнения:

Фильтр по поставщику — выберите среды выполнения, которые поддерживают настроенного поставщика ИИ агента
Фильтр по меткам — если вы назначили метки задаче или среде выполнения, совпадите с ними
Фильтр по ОС — если задача требует конкретной ОС, фильтруйте соответственно
Проверьте дополнительные требования — проверьте возобновление, импорт навыков, транспорты MCP
Выберите лучшее совпадение — предпочитайте среды выполнения с наибольшей свободной ёмкостью

Если ни одна среда выполнения не совпадает, задача ставится в очередь и ожидает подходящую среду выполнения.

Подробнее см. Runtime labels and routing.

Метки и маршрутизация

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

macos, linux, windows — ОС
arm64, amd64 — архитектура
claude, codex, cursor — поставщики
mcp-stdio, mcp-sse, mcp-http — транспорты MCP
Пользовательские метки, которые вы назначаете через runtime labels

Используйте метки при назначении задач:

assign @agent-name with label="macos" 
  because task requires macOS-specific tools

Маршрутизатор затем направит задачу на среду выполнения macOS.

Обновление возможностей

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

Чтобы обновить возможности:

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

Если вы установите новое поставщика (например, установите Cursor CLI) на работающий демон:

Остановите демон
Установите поставщика
Перезагрузите демон

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

Поведение отката

Если возможности времени выполнения неполны или деформированы:

AACWorkflow деградирует корректно и рассматривает неизвестные возможности как «не поддерживаемые»
Среда выполнения по-прежнему отображается в интерфейсе и доступна для ручного назначения
Автоматическая маршрутизация просто рассматривает её как имеющую меньше возможностей
Ошибок отсутствия или белых экранов не происходит

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

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

Проверьте возможности перед назначением — если вам нужна конкретная ОС или поставщик, убедитесь, что среда выполнения её имеет
Используйте метки для сложной маршрутизации — если у вас много сред выполнения, пометьте их метками и включите требования метки в назначения задач
Держите демоны в актуальном состоянии — более новые версии демонов поддерживают больше возможностей
Следите за неподдерживаемыми задачами — проверьте очередь задач на наличие заданий, ожидающих несуществующих сред выполнения

Следующие шаги

Install agent runtime — установите демон
Runtime labels and routing — используйте пользовательские метки для продвинутой маршрутизации
Daemon and runtimes — поймите архитектуру демона и времени выполнения

Реестр возможностей времени выполнения

Содержание