Создание навыков для AI-агентов: инженерный гайд от команды Perplexity

Команда Perplexity опубликовала внутренний гайд по разработке навыков для AI-агентов. Инженеры компании пришли к выводу, что принципы написания классического кода здесь не работают. Популярные правила из Zen of Python становятся антипаттернами. Для агента сложность является преимуществом, контекст стоит дорого, а краевые случаи несут максимальную ценность. Если модель уже знает концепцию — ее нужно удалить из инструкций.

Каждый навык в экосистеме Perplexity Computer — это не один файл, а директория. Базовый файл SKILL.md содержит метаданные и инструкции. Описание навыка работает как триггер маршрутизации. Модели нужны указания формата загружать когда, а не просто описание функциональности. Внутри папки хранятся scripts/ с готовым кодом, тяжелые документы в references/ и шаблоны в assets/. Такая структура помогает строго изолировать контекст.

Глубокая иерархия папок спасает при работе с объемными базами знаний. Для анализа налогового кодекса США инженеры разбили 1945 разделов на три уровня вложенности. Загрузка всего массива единым файлом приводила к отказам модели. Агент загружает навыки прогрессивно по мере необходимости. Система копирует папку в изолированную песочницу, подтягивает зависимости и очищает служебные метаданные перед передачей контекста языковой модели.