Cloudflare Agents SDK загружает навыки из Workspace без повторного развёртывания

29 октября 2026 года Cloudflare объявила об обновлении Agent Skills в Agents SDK. Навык теперь можно добавить в работающего агента, записав папку с файлом SKILL.md в /workspace/.agents/skills/. После подключения этого источника новые инструкции становятся доступны на следующем ходе без новой сборки и развёртывания приложения.

Навык объединяет инструкции для определённой задачи, справочные материалы и необязательные скрипты. Сначала модель получает краткий каталог названий и описаний, а полное содержимое загружает по необходимости. Такой механизм позволяет хранить библиотеку рабочих процедур, не добавляя все инструкции в каждый запрос к модели.

Как подключить и обновлять навыки

В Think источники задаются через getSkills(). Поддерживаются файлы Computer Workspace, объекты R2 и определения в коде через skills.manifest(). Перед каждым ходом Think заново опрашивает источники. Если один навык встречается несколько раз, используется вариант из первого источника, а последующие дубликаты пропускаются с предупреждением. Порядок подключения поэтому определяет приоритет.

Минимальный пример из документации Workspace подключает стандартную папку навыков:

import { Think, skills } from "@cloudflare/think";

export class MyAgent extends Think {
  getSkills() {
    return [skills.workspace(this.workspace)];
  }
}

Добавлять файлы может код приложения, пользователь через загрузку или сам агент своим инструментом записи. Редактирование и удаление SKILL.md также учитываются на следующем ходе. При необходимости можно указать другую корневую папку абсолютным путём. Скрипты остаются файлами Workspace; для их выполнения через инструмент exec нужно настроить соответствующий backend.

Что потребуется при миграции

Cloudflare указывает минимальные версии Agents SDK v0.32.0 и Think v0.23.0. В релизе Agents SDK прежний механизм регистрации заменён загрузкой каталога и созданием инструментов для работы с ним. Приложениям, напрямую использующим agents/skills, потребуется адаптация:

• Удалены Vite-импорт agents:skills и модуль agents/skills/compile.
• Вместо SkillRegistry используются loadSkillCatalog() и createSkillTools(); последний импортируется из agents/skills/tools/ai-sdk.
• Функция runner() перенесена в agents/skills/runner.
• В Think удалены skillWorkspace и тип блока контекста "skill".

Отдельное изменение в Think v0.23.0 касается системного промпта. При обновлении каталога агент получает напоминание в контексте разговора, вместо того чтобы пересобирать закэшированный системный промпт. По описанию Cloudflare, это сохраняет возможность использовать кэш провайдера модели. Переопределённый getSystemPrompt() теперь размещается выше блоков контекста; раньше при наличии таких блоков он мог выпадать.

Проверка формата остаётся мягкой, но не безусловной

Согласно документации Agent Skills, многие отклонения от спецификации приводят только к предупреждению: например, несовпадение имени навыка с названием папки. Однако отсутствие description, недопустимое имя с разделителями пути или отсутствующий либо неразбираемый YAML-блок метаданных приводят к пропуску навыка. Для проверки перед записью предусмотрен parseSkill().

Agent Skills пока имеют экспериментальный статус: Cloudflare предупреждает о возможных изменениях API. Практическая ценность обновления — возможность менять процедуры работающего агента через файлы. Первоначальное подключение источника и миграция приложения при этом по-прежнему требуют изменений кода.