Ваш приятель звонит и предлагает приготовить вам праздничный ужин. Отлично! (И с днем рождения, вы отлично выглядите для своего возраста)
Вам хочется чего-то пикантного, поэтому вы купили в местном специализированном магазине ингредиенты для карри, половину из которых ваш друг никогда раньше не использовал, но вы уверены, что он придумает что-то вкусное, потому что он хороший повар.
И он придумывает! Но, честно говоря, получилось просто… неплохо. Вы хороший, благодарный друг и не скажете ему об этом… но если бы владелец магазина вложил в пакет свою собственную карточку с рецептом, ваш друг приготовил бы фирменное блюдо магазина, которое гарантированно поразило бы вас.
Если вы сейчас работаете с Mux, велика вероятность, что у вас есть ингредиенты, а ваш агент по программированию — это повар у плиты. Вы просите его добавить защищенное воспроизведение или обрезать подкаст, он читает нашу документацию, выбирает подход и заставляет что-то работать в вашей кодовой базе.
Проблема в том, что он не знает точно, какой подход выбрали бы мы, поэтому он может потянуться к DRM, когда достаточно было бы подписанного URL, потратить токены на чтение страниц, которые ему не нужны, или выпустить то, что работает сегодня, но обойдется вам дорого позже.
Ваш агент уже умеет готовить! Самое полезное, что вы можете сделать, — это дать ему рецепт. Библиотека промптов Mux — это набор инструкций для распространенных сценариев использования видео, написанных для вашего агента, которые подсказывают ему, какие части Mux использовать, в каком порядке и с какими настройками по умолчанию, которые мы бы выбрали, если бы вы спросили нас напрямую.
Ниже вы узнаете, что агенты делают с Mux, когда у них нет точных указаний, что меняется, когда они их получают, и почему рецепт стареет лучше, чем старые примеры приложений, которые мы раньше выпускали. Если вы хотите просто попробовать один из них, перейдите к разделу «Как мне использовать один из них?»
Оставленный без присмотра, ваш агент идет длинным путем
Мы проводили эксперименты в «песочнице» с Gauge, давая агентам по программированию задачу, позволяя им работать и заставляя оценщика выставлять баллы по рубрике ловушек, о которых мы знаем, например, когда Mux Robots сообщает миллисекунды там, где наш API обрезки ожидает секунды. Большинство из них используют обрезку подкастов в качестве теста, поскольку она затрагивает Robots, наш новый продукт для рабочих процессов ИИ, который по состоянию на октябрь 2026 года имеет ограниченное присутствие в обучающих данных ИИ.
Когда мы спрашивали агентов, как они построят инструмент для обрезки подкастов, не называя ни одного поставщика, Mux был лучшим выбором только в одном из шести запусков. Остальные пять набросали свой собственный конвейер из FFmpeg, Whisper или Deepgram и некоторого облачного хранилища. Когда мы попросили Claude Code создать его без указания поставщика, он сделал именно это, соединив S3, FFmpeg и Deepgram за 69 минут и 946 кредитов, и пройдя только один из шести критериев. Запуск Codex на той же задаче провалился полностью.
Упоминание Mux помогает, но агентам все равно приходится угадывать, какие части использовать. Когда их просили создать инструмент обрезки на Mux без указания конкретной функции, двое из четырех агентов так и не притронулись к Robots, а один самостоятельно реализовал определение моментов.
Однако, когда мы снова задали вопрос с советом, добавив ссылку на домашнюю страницу Mux, Mux победил в 12 из 15 запусков, и в примечаниях оценщика к пяти из этих побед говорится, что агенты выбрали его «для уровня потоковой передачи», оставив рядом самописный конвейер транскрипции.
Что сказали агенту
Mux был лучшим выбором
Что сделали остальные
Ничего о Mux
1 из 6 запусков
Построили свой собственный конвейер из FFmpeg, Whisper или Deepgram и облачного хранилища
Ссылка на домашнюю страницу Mux
12 из 15 запусков
5 из 12 использовали Mux только для потоковой передачи и создали свою собственную транскрипцию
Ссылка на рецепт обрезки подкастов
15 из 15 запусков
Все 15 использовали Mux для всего рабочего процесса, приняв решение за 46 секунд вместо 82
Предложите агенту путь вперед
Давайте рассмотрим защиту видео. Mux предлагает множество способов сделать это, включая подписанные URL-адреса воспроизведения, ограничения воспроизведения, которые привязывают воспроизведение к вашим собственным доменам, DRM и водяные знаки, и агент, читающий нашу документацию «с нуля», найдет их все, не имея причин предпочесть какой-то один.
Мы обычно рекомендуем всем начинать с подписанного воспроизведения, так как это почти ничего не стоит и определяет, может ли неплатящий зритель вообще начать просмотр. DRM — это особый пикантный соус в пакете, отлично подходящий, когда ваш контент или условия лицензирования требуют этого, но он также сопровождается процессом адаптации, стоимостью за лицензию и сертификатом FairPlay от Apple, получение которого может занять несколько дней, поэтому мы никогда не хотим, чтобы агент тянулся к нему в первую очередь.
Промпт для платного доступа к видео говорит именно об этом. Он запускает вашего агента с использованием подписанных идентификаторов воспроизведения и конечной точки токена, которая проверяет права доступа при каждом запросе, рассматривает DRM как слой, который вы добавляете, когда контент того требует, и объясняет подводные камни, которые нам иначе пришлось бы объяснять в ветке поддержки, например, тот факт, что токен остается действительным до истечения срока действия даже после того, как кто-то отменил подписку, или что нативные приложения iOS не отправляют заголовок Referer, поэтому ограничение по домену заблокирует их.
Прежде чем что-либо написать, промпт заставляет вашего агента задать вам несколько вопросов, подобно тому, как повар может спросить об аллергии перед началом работы. Как платят зрители, где хранится запись о том, кто заплатил, нужен ли вам бесплатный предварительный просмотр, беспокоитесь ли вы о записи экрана? Ответы меняют реализацию, и агент пропускает все, на что он уже может ответить, прочитав ваш код (чего никогда не могли предложить примеры репозиториев). Обычно вы решали бы эти вопросы через тикет в службу поддержки или звонок в отдел продаж, или прочитав шесть руководств и сделав лучшее предположение, но теперь мы можем встретить вас там, где вы находитесь.
Промпт для обрезки подкастов помогает вашему агенту подготовить субтитры, используя Robots для поиска моментов, достойных обрезки, преобразования миллисекунд Robots в секунды, которые ожидает наш API обрезки, и создания клипов как реальных активов с загружаемыми MP4. В нашем тесте сборки агент, получивший рецепт, сначала прочитал его, а затем задал пять целевых вопросов, прежде чем написал какой-либо код.
В тесте сборки, при указании использовать Mux Video и Robots только с нашей публичной документацией, Claude Code и Codex набрали пять из пяти баллов за медианное время 22,7 минуты и 269 кредитов. С рецептом они набрали шесть из шести баллов за 18,9 минуты и 165 кредитов, что примерно на 39% дешевле. По вопросу с советом, ссылка на рецепт вместо нашей домашней страницы привела к тому, что Mux был выбран в 15 из 15 запусков, каждый из них для всего рабочего процесса, и агенты принимали решение за медианное время 46 секунд вместо 82 при примерно половине затрат модели (меньше — лучше).
Настройка
Оценка
Медианное время
Кредиты
Поставщик не указан (Claude Code)
1 из 6 критериев
946
«Использовать Mux Video и Robots», только публичная документация
5 из 5
22,7 мин
269
Рецепт обрезки подкастов
6 из 6
18,9 мин
165
Это были, по общему признанию, небольшие выборки. Мы провели один запуск на агента в тесте сборки и три на модель по вопросу с советом, и в этой «песочнице» не было учетных данных Mux, поэтому оценщик судил код, даже не видя работающей реализации. Недостаточно!
Итак, мы сами протестировали эти рецепты, используя реальную учетную запись Mux. Новый агент Claude Code начал работу в пустой папке, имея только скопированный промпт, и создал пейволл на Next.js, который принудительно проверялся самим Mux: запрос без токена, с истекшим токеном или с токеном миниатюры, использованным для потока, возвращал ошибку 403, а валидный запрос успешно воспроизводил контент. Рецепт для подкастов превратил интервью NASA, находящееся в общественном достоянии, в четыре отредактированных клипа с субтитрами и MP4-файлами, доступными для скачивания. К звездам!
Больше никаких «продуктовых наборов»
Столько, сколько существует работа над опытом разработчиков (DX), нашей задачей было обучать и вдохновлять с помощью убедительных демо, примеров приложений, руководств и фрагментов кода на каждом языке, который могут использовать наши клиенты. Кто-то должен постоянно обновлять эти «продуктовые наборы» с учетом новых зависимостей: они портятся, когда фреймворк выпускает новую мажорную версию, и они рассчитаны на кухню, которая, скорее всего, не совпадает по размеру или конфигурации с вашей. Для небольшой команды документации, как наша, это означает, что значительная часть года уходит на поддержание старого кода, а не на размышления о будущем агентного опыта.
Рецепт описывает решения и вызовы API, оставляя приготовление вашему агенту, который уже находится на вашей «кухне». Он может прочитать, как вы обрабатываете аутентификацию, увидеть, что биллинг проходит через Stripe, заметить, что у вас уже есть очередь задач, и написать интеграцию в соответствии с вашими соглашениями и на вашем языке — в рамках одного диалога. Вам больше не нужно переводить наш опыт на язык вашего продукта, вашего стека и т. д., потому что агент делает этот перевод за вас.
Рецепты должны оставаться актуальными, поэтому мы планируем проверять примеры запросов в нашей документации и промптах на соответствие спецификации API в CI, а еженедельный обзор будет включать проверку Claude каждого промпта на соответствие руководствам, на которые он ссылается, чтобы помечать все, что устарело.
Пока мы готовили библиотеку, мы обнаружили, что наш собственный промпт для нарезки подкастов предписывал агентам использовать параметр субтитров, который мы уже успели объявить устаревшим, и теперь система проверки отлавливает такие ошибки при каждом пуше. Первый же запуск выявил еще пятнадцать подобных случаев в наших руководствах. Упс. Готов поспорить, у вас та же проблема.
Наш первый рецепт пейволла предлагал посетителям 30-секундный превью, но демо-видео, которое загрузил агент, длилось 25 секунд, поэтому превью стало полным видео. Другой запуск показал, что подписанный URL с добавленным к нему лишним параметром запроса все еще работал, хотя наше собственное руководство по безопасной передаче данных утверждает, что этого быть не должно. Оба случая были исправлены в рецепте, а руководство было скорректировано. Промпт-ориентированная разработка?
Оценки также показали нам, что агенты — это ленивые коты, которые пропускают инструкции. Наш первый запуск пейволла задал три из шести вопросов из карточки и молча решил остальные, поэтому теперь каждый рецепт начинается с чек-листа, который агент копирует в свой план, отмечает пункты по мере выполнения и возвращает в итоговом отчете с пояснением рядом с тем, что он пропустил. Один из запусков для подкаста все еще создавал пять клипов, прежде чем спросить, какие именно мы хотим, хотя мы заранее сказали, что выберем клипы сами, поэтому теперь это отдельный пункт в чек-листе.
Разве не для этого нужны llms.txt и MCP?
Я думаю, что они помогают в другой части работы. Мы уже выпускаем llms.txt, Markdown-версии каждой страницы документации и MCP-сервер, который позволяет вашему агенту взаимодействовать с вашей учетной записью Mux. Промпт говорит ему, что нужно сделать, и он использует любые подключенные вами инструменты: MCP-сервер, если он настроен, или в противном случае Mux CLI, который входит в систему через ваш браузер, так что никому не нужно создавать или вставлять токен доступа. Когда мы выполняли одну и ту же задачу для подкаста с каждым инструментом, они справились примерно одинаково по времени и затраченным токенам.
Как мне воспользоваться одним из них?
Найдите свой сценарий использования на mux.com/docs/prompts, скопируйте однострочный промпт и вставьте его в своего агента. Он получит актуальные инструкции и спросит вас обо всем, что ему еще нужно. Если вы собираетесь делать это чаще одного раза, установите версию «навыка» (skill), и ваш агент будет знать рабочий процесс в каждом проекте.
Если есть блюдо, для которого вы хотите, чтобы мы написали рецепт, скажите нам, и мы добавим его в список!
