Nymrel Agent

Nymrel Agent — это объяснимый мультимодельный маршрутизатор с единым детерминированным контрактом, работающий через публичный API, локальный CLI, MCP-сервер и среду выполнения с низким уровнем хранения.

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

Размещённый маршрутизатор принимает только метаданные моделей. Он не принимает промпты, учётные данные провайдеров, файлы или идентификаторы клиентов и не выполняет вызовы моделей.

Быстрый старт

Публичная конечная точка маршрутизации не требует учётной записи или ключа:

curl -sS https://nymrel-agent.vercel.app/v1/route \
  -H "content-type: application/json" \
  --data-binary @examples/route-request.json

Маршрутизируйте тот же полезный набор данных локально:

npm ci
npm run compile
node dist/src/bin/nymrel-agent.js route --file examples/route-request.json

Полная документация: https://nymrel-agent.vercel.app/docs

OpenAPI 3.1: https://nymrel-agent.vercel.app/openapi.json

Машиночитаемый контекст продукта: https://nymrel-agent.vercel.app/llms.txt

Related MCP server: bus-scheduling-mcp

Что означает результат

Маршрутизация состоит из двух этапов:

1. Фильтры допустимости с отказом по умолчанию отклоняют несовместимые профили со стабильными кодами причин.

2. Допустимые профили получают видимые целочисленные компоненты оценки и детерминированный критерий разрешения равенства.

Выбранная цель изменяет явные веса. Явные пределы стоимости и задержки также закрепляют соответствующие компоненты оценки, поэтому изменение состава каталога, не связанного с ними, не может изменить закреплённый компонент только за счёт смещения диапазона нормализации. Если предел опущен, этот компонент возвращается к нормализации по допустимому набору. Не изменяя закрытую форму ответа v1, каждая квитанция маршрута сообщает выбранные режимы в decisionCodes и числовые границы в explanation. Факты о качестве модели, надёжности, стоимости, задержке, границах и возможностях — это доказательства, предоставленные вызывающей стороной; Nymrel Agent объясняет, как он их использовал, но не сертифицирует их.

CLI

nymrel-agent route --file PAYLOAD.json [--endpoint https://host]
nymrel-agent models doctor [--config CONFIG.json]
nymrel-agent run --config CONFIG.json (--task TEXT | --task-file FILE|-)
nymrel-agent contract
nymrel-agent demo

Локальная маршрутизация используется по умолчанию. --endpoint отправляет полезный набор данных только с метаданными на размещённый маршрутизатор.

MCP

Сервер MCP stdio предоставляет два инструмента только для чтения:

• route_models — проверка и маршрутизация JSON-полезного набора данных nymrel.agent.route/v1.

• explain_contract — возврат стабильной маршрутизации и границы хранения.

Пример конфигурации клиента после сборки из исходного кода:

{
  "mcpServers": {
    "nymrel-agent": {
      "command": "node",
      "args": ["/absolute/path/to/nymrel-agent/dist/src/bin/nymrel-agent-mcp.js"]
    }
  }
}

Локальное выполнение у клиента

v0.1 включает адаптер OpenAI Responses для локальных запусков только для чтения. Локальная конфигурация хранит имя переменной окружения, но никогда не значение ключа:

$env:OPENAI_API_KEY = "set-this-in-your-secret-aware-shell"
node dist/src/bin/nymrel-agent.js run --config examples/openai-local-config.example.json --task-file -

Адаптер вызывает POST /v1/responses с машины клиента, требует завершённого ответа, устанавливает store: false, ограничивает время и размер ответа, очищает ошибки провайдера и не включает тела задач/выходных данных в квитанции. Профиль, заявляющий хранение local_only, принимается только с базовым URL loopback. Публичный Worker никогда не участвует в этом пути.

Пример содержит YOUR_MODEL_ID; замените его и факты профиля, предоставленные вызывающей стороной, на модель, которую может использовать ваша учётная запись. Nymrel не включает заявления о бенчмарках в пример.

Граница безопасности

• Публичный API: только метаданные маршрутизации, без выполнения промптов или провайдеров, ограничения 256 КиБ и 100 моделей при потоковой передаче, строгое отклонение неизвестных полей, ограничение скорости WAF на уровне развёртывания Vercel (или привязка к краевому расположению Cloudflare), готовность точного источника и детерминированные ошибки JSON.

• Локальная среда выполнения: только выполнение для чтения, явные адаптеры, ограниченные события/выходные данные провайдера, квитанции без тел.

• Не включено: размещённые ключи, учётные записи, биллинг, хранение данных клиентов, инструменты для записи в оболочку или файловую систему, рассылки, покупки, инструменты развёртывания или автономные побочные эффекты.

• Значения SHA-256 в квитанциях — это корреляционные дайджесты, а не средства шифрования или конфиденциальности.

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

Сервис внедрения Nymrel

Nymrel может настроить каталоги на основе доказательств, политику маршрутизации, оценки, локальные адаптеры клиента и операционные квитанции вокруг реального рабочего процесса. Размещённое выполнение, хранение данных, учётные данные и инструменты с возможностью записи требуют отдельного объёма и проверки безопасности. Цены предоставляются по запросу на https://nymrel.com/brief.

Доказательство разработки и выпуска

Требуется Node.js 22, 23 или 24.

npm ci
npm run verify
npm pack --dry-run
git show --check --oneline HEAD

npm run verify выполняет проверку типов, автономный/интеграционный набор тестов, проверку манифеста выпуска и секретов, а также пробный запуск развёртывания Cloudflare. Продакшн-адаптер Vercel проверяется тем же скомпилированным интеграционным набором и проверкой предварительного просмотра перед продвижением. Доказательства фазы 0 остаются в docs/PHASE0_CONTRACT.md и evidence/phase0-receipt.json как историческое происхождение, а не текущий статус продукта.

Лицензия

MIT. См. LICENSE.