Guides / current

Runtime notes

От выбора карточки до устойчивого локального runtime: память, форматы, контекст, RAG, диагностика и воспроизводимые manifests.

Главный принцип: сначала зафиксируйте manifest и профиль памяти, а затем меняйте temperature, context и prompt. Это делает запуск повторяемым и упрощает диагностику.
01 / Start here

Четыре шага до первого ответа

Выберите карточку

Сопоставьте задачу с family, context window и минимальной памятью. Для быстрого ассистента начните с Aster-8B.

Получите manifest

Используйте только revision, указанный в карточке. Не смешивайте tokenizer и quantization из разных релизов.

Запустите smoke test

Проверьте загрузку, первый token, JSON mode и максимальный context. Сохраните вывод runtime.

Зафиксируйте профиль

Положите локальный config в репозиторий проекта. Он должен содержать model revision, format и memory budget.

Открыть quickstart →
02 / Profiles

Hardware map

ОкружениеРекомендуемый классБюджет контекстаПроверка
8 GB RAMMica, Aster8–16Kbatch smoke
12–16 GB RAMNyx, Quartz16–32Klatency + JSON
24 GB+ RAMOrion32–64Kreasoning budget
32+ GB VRAMOrion / Helio64–128Kbatch replay

Значения памяти включают runtime, KV cache и запас под операционную систему. Для длинного контекста используйте chunking вместо простого увеличения окна.

03 / Commands

Минимальный рабочий контур

vertex-runtime verify ./model.manifest.json vertex-runtime inspect --profile balanced vertex-runtime serve --manifest ./model.manifest.json --max-tokens 2048 vertex-runtime replay ./eval/smoke.jsonl --report ./report.json

Команды показывают локальный workflow: проверка, инспекция, запуск и воспроизводимый replay. Workspace-артефакты не нужны для чтения документации.

04 / Next

Специальные сценарии

Quantization

Как выбрать Q4, Q8 или BF16 и не потерять качество структурированного ответа.

Context & RAG

Chunking, embeddings, retrieval budget и длинные документы.

Troubleshooting

OOM, медленный warm-up, нестабильный JSON и ошибки checksum.

Model selection

Сравнение моделей по задаче, памяти и формату, а не по названию.