Agent

Обзор​

ScriptCat v1.4 представляет систему Agent, дающую пользовательским скриптам набор возможностей: AI-диалоги, автоматизация браузера, управление файлами и задачи по расписанию.

Скрипты вызывают эти возможности через пространство имён CAT.agent.*, и для каждого API нужно объявить соответствующее разрешение через @grant.

Модули функций​

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

Простейший возможный скрипт Agent:

// ==UserScript==
// @name        Hello Agent
// @match       *://*/*
// @grant       CAT.agent.conversation
// ==/UserScript==

const conv = await CAT.agent.conversation.create();
const reply = await conv.chat("Hi, please introduce yourself");
console.log(reply.content);

Обзор архитектуры​

Система Agent охватывает несколько изолированных контекстов внутри расширения браузера:

User script → Sandbox (isolated execution)
              ↓ WindowMessage
           Offscreen (DOM access)
              ↓ ExtensionMessage
           Service Worker (core scheduling)
              ├── LLM Provider (OpenAI / Anthropic)
              ├── ToolRegistry (tool registration and execution)
              ├── SkillScriptExecutor (Skill script execution)
              ├── MCPClient (MCP protocol client)
              └── TaskScheduler (scheduled task scheduling)

Структура хранения​

Agent хранит данные с помощью OPFS браузера (Origin Private File System):

agents/
├── conversations/       # conversation history
├── attachments/         # attachments (images, files)
├── skills/{name}/       # Skill package files
│   ├── SKILL.cat.md
│   ├── scripts/
│   └── references/
├── tasks/               # scheduled task config and execution records
└── workspace/           # user workspace files (the directory opfs_* tools operate on)

Поддерживаемые модели​

Добавьте Provider и API Key в разделе «Конфигурация моделей» панели управления, чтобы использовать их.

Экосистема Skill​

Skill — пакет, объединяющий промпты + скрипты инструментов + справочные материалы, позволяющий внедрять в Agent предметные знания и пользовательские инструменты.

Официальный репозиторий Skill: scriptscat/skills

Включает готовые Skills для автоматизации браузера, задач по расписанию, инструмента создания Skill, примеров conversation/DOM/config и многого другого.

Способы установки:

• Установка по URL — откройте URL SKILL.cat.md прямо в браузере; ScriptCat автоматически перехватит его и покажет страницу установки. Также можно вставить URL в панели управления: Agent → Управление Skill.
• Установка из скрипта — программная установка через API CAT.agent.skills.install()

Проверка обновлений:

Skill, установленный по URL, сохраняет источник установки; панель управления позволяет проверять обновления и обновлять в один клик (на основе semver-сравнения поля version).

Подробности: API управления Skill и Руководство по разработке Skill.