01
Начало работы
Основы ActVox
Рабочее пространство - это единица, в которой ActVox хранит контекст вашей компании и работу. Используйте одно рабочее пространство для одного бренда, клиента или операционной команды, чтобы агент рассуждал на основе правильного бизнес-контекста.
В рабочем пространстве могут быть:
| Объект | Для чего использовать |
|---|---|
| Страницы | Планы, брифы, заметки, записи встреч, операционные документы и структурированные доказательства. |
| Базы данных | Повторно используемые таблицы, доски, календари и списки для кампаний, задач, контентных конвейеров, конкурентов или исследований. |
| Контекст | Профиль бизнеса, постоянные инструкции, стратегия, отчёты, источники, загрузки и память. |
| Разговоры | Работа с агентом с сохранением контекста рабочего пространства. |
| Результаты | Контент и созданные агентом артефакты, которые можно проверить и использовать повторно. |
Первая настройка рабочего пространства
- Войдите и откройте рабочее пространство. Workspace OS является стартовой поверхностью по умолчанию.
- Добавьте или подтвердите в Настройках сайт компании, описание бизнеса, аудиторию, продукты и позиционирование.
- Откройте ACTVOX.md и добавьте постоянные инструкции, которые агент должен учитывать в каждом сообщении: например, границы одобрения, терминологию, тон общения, целевую географию или правила качества источников.
- Добавьте исходные материалы в Базу знаний или Загруженное.
- Начните разговор и попросите агента проанализировать бизнес, создать план или подготовить первый элемент рабочего пространства.
Экскурсия по рабочему пространству при первом запуске
После первичной настройки компании новое рабочее пространство открывает ознакомление из семи шагов. В нём объясняются командный центр Ассистент, рабочие Страницы, система Контекст, Разговоры, библиотека черновиков Контент, созданные Артефакты и способ запросить первый устойчивый результат. В каждом шаге приведён конкретный пример, а не только название элемента управления. Экскурсию можно пропустить без блокировки рабочего пространства; факт завершения или пропуска запоминается для этого рабочего пространства в текущем браузере.
Хороший рабочий подход: перед запросом существенной стратегии, отчёта или контент-плана задайте профиль бизнеса и добавьте исходные материалы. Более качественный контекст даёт более полезный результат с более ясной атрибуцией.
Навигация по боковой панели
Левая боковая панель организована в четыре рабочие области.
| Область | Что вы найдёте | Как использовать |
|---|---|---|
| Рабочее пространство | Единое дерево страниц, баз данных, папок и вложенной работы. | Создайте операционную систему, которой команда пользуется каждый день. |
| Контекст | ACTVOX.md, Профиль, Стратегия, Отчёты, Design.md, База знаний, Загруженное и Память. | Поддерживайте доказательства и указания, нужные агенту и команде. |
| Агенты | Разговоры. | Спрашивайте, планируйте, проверяйте и действуйте вместе с агентом. |
| Результаты | Контент и Артефакты. | Проверяйте работу, созданную на основе контекста и инструкций. |
Используйте шеврон рядом с разворачиваемой областью, чтобы открыть или свернуть её. Страницы и базы данных могут вкладываться в страницы, создавая структуру рабочего пространства в стиле Notion. Для организации ресурсов может быть доступна поддержка перетаскивания; используйте её только когда уверены в целевом расположении.
Библиотека Навыки намеренно доступна из меню ✨ навыков в поле ввода чата, а не как постоянный корневой раздел боковой панели.
02
Workspace OS
Workspace OS - основная рабочая поверхность. Она связывает живые документы, структурированную работу, контекст и результаты агента в одном рабочем пространстве.
Настройки рабочего пространства
Откройте Настройки в элементах управления рабочего пространства, чтобы поддерживать его идентичность и маркетинговый профиль.
| Настройка | Почему это важно |
|---|---|
| Название рабочего пространства/проекта | Идентифицирует рабочее пространство в навигации и при переключении. |
| Название компании и логотип | Придают рабочему пространству ясную идентичность компании. |
| URL сайта | Отправная точка для анализа компании и контекста источников. Используйте полный URL https:// или http://. |
| Местоположение и отрасль | Помогают опираться на локальные, рыночные данные и данные об аудитории. |
| Описание бизнеса | Кратко объясняет, чем занимается компания. |
| Голос бренда и целевая аудитория | Улучшают контент, сообщения и стратегические рекомендации. |
| Ключевые продукты и уникальные преимущества | Дают агенту устойчивый коммерческий контекст. |
| Цвета бренда | Поддерживают работу с учётом бренда и направление для медиа. |
| Язык | Задаёт язык интерфейса рабочего пространства. |
После изменения настроек нажмите Сохранить. Осторожно обращайтесь с разрушительным элементом Удалить рабочее пространство: для подтверждения нужно ввести название рабочего пространства.
Настройки и предпочтения
Рабочее пространство предоставляет несколько разделов настроек. Доступность может различаться в зависимости от аккаунта и развёртывания.
| Раздел настроек | Для чего использовать |
|---|---|
| Общие | Идентичность рабочего пространства, профиль бизнеса, язык и разрушительные элементы управления рабочим пространством. |
| Агент | Имя агента, язык ответов, приветствие и стиль общения. |
| Настройка | Настройка боковой панели, списка последних элементов и сведений о профиле рабочего пространства. |
| API-ключи | Создание, просмотр, отзыв или удаление ключей доступа. |
| Аналитика | Просмотр данных об использовании и эффективности рабочего пространства, если они доступны. |
| Общие ссылки | Аудит и отзыв действующих публичных или доступных только организации ссылок на страницы и базы данных. |
| Оплата / Автоадаптация / Рекомендации / Инженерия | Расширенные настройки рабочего пространства, если они включены для вашего плана или развёртывания. |
Предпочтения агента
В Настройки → Агент можно задать имя агента, язык ответа по умолчанию, приветствие и стиль общения. Доступные встроенные персоны включают Профессиональный, Дружелюбный, Краткий, Подробный и Пользовательский.
Для постоянных инструкций используйте ACTVOX.md в разделе Контекст дерева рабочего пространства. Это текущий раздел для редактирования инструкций; агент читает его при каждом сообщении. Старое поле настроек системных инструкций сохранено для устаревшей настройки, но не предназначено для поддержки актуальных инструкций.
Навигация по рабочему пространству
Используйте вкладки для работы с несколькими страницами, базами данных, разговорами и результатами, не теряя текущего места. Активная вкладка отображается в центральной области рабочего пространства. Открывайте связанную работу в отдельных вкладках, когда сравниваете бриф с базой данных, отчётом или результатом агента.
Полезные привычки навигации:
- Храните указания для всей компании в ACTVOX.md, Профиле и Стратегии, а не разбрасывайте их по страницам кампаний.
- Храните рабочую систему - планирование, исполнение и отслеживание - в разделе Рабочее пространство.
- Помещайте исходные доказательства в Базу знаний или Загруженное, затем цитируйте их или ссылайтесь на них со страниц.
- Используйте Контент и Артефакты как очереди проверки результатов, а не как единственный источник истины.
03
Создание и форматирование страниц
Страницы - это устойчивые документы для брифов, исследовательских заметок, планов, отчётов, руководств и решений.
Создание страницы
Создавать страницы можно из дерева Рабочего пространства или внутри другой страницы.
- В разделе Рабочее пространство используйте элемент добавления в нужном расположении.
- Выберите Страница и задайте ей ясное название, ориентированное на действие.
- Чтобы создать вложенную страницу, откройте родительскую страницу и вставьте блок Страница либо создайте её в соответствующем поддереве.
- Начните писать. Изменения сохраняются автоматически после короткой паузы.
Полезное соглашение об именовании: YYYY-MM - outcome - audience or channel; например, 2026-08 - LinkedIn founder narrative - B2B SaaS.
Использование блоков и слеш-команд
Введите / в редакторе страницы, чтобы открыть меню блоков. Найдите блок по имени и выберите его. Также можно использовать маркер блока, чтобы вставить, переместить или изменить блок.
| Группа блоков | Примеры |
|---|---|
| Базовые | Текст, заголовки 1–4, маркированные и нумерованные списки, списки дел, переключатели, выноски, цитаты, простые таблицы, разделители, дочерние страницы и ссылки на страницы. |
| Медиа | Изображения, видео, аудио, файлы, веб-закладки и блоки кода. |
| Базы данных | Встроенная база данных, полноэкранная база данных, связанное представление базы данных и представления таблицы, доски, галереи, списка или календаря. |
| Расширенные | Оглавление, уравнения, навигационная цепочка и макеты в две-пять колонок. |
| Встраивания | Встраивания по URL и изолированный HTML там, где это включено. |
Форматирование и организация страниц
- Используйте заголовки для удобной для просмотра иерархии; блоки оглавления используют эту иерархию.
- Используйте выноску для решения, предположения, риска или ответственного, которые читатель не должен пропустить.
- Используйте блоки дел только для лёгкой локальной работы на странице. Используйте базу данных, если для работы нужны ответственные, даты, отчётность или повторяемость.
- Добавьте значок или обложку страницы, чтобы отличать документы с высокой посещаемостью.
- Связывайте связанные страницы, а не копируйте их содержимое. Это поддерживает актуальность доказательств и решений.
- Используйте панель комментариев для совместной работы, а элементы управления версиями/историей - для проверки, когда они доступны.
- На телефоне можно комментировать, оставаясь в режиме чтения. Выделите текст и выберите Добавить комментарий, чтобы обсудить этот фрагмент. Требуется право редактирования.
- Когда агент предлагает изменения на телефоне, выберите Проверить, чтобы перейти в режим редактирования к первому изменению. Принять всё применяет ожидающие изменения; Отклонить всё отменяет предложение. Нужны права на редактирование.
- Чтобы изменить порядок блоков на телефоне, перейдите в режим редактирования и выберите Переставить. Перемещайте блоки кнопками вверх/вниз; каждое перемещение можно отменить отдельно. Закройте панель или нажмите «Назад», чтобы вернуться на страницу. Пока предложение агента ожидает решения, перестановка недоступна.
Добавление вложений и медиа
Вставьте блок Изображение, Видео, Аудио или Файл, затем выберите файл для загрузки. Также можно добавить вложения страницы. Используйте описательные названия и поясняющий текст вокруг них, чтобы другой участник команды - и агент - понимал, почему этот материал важен.
3D-модели
Вставьте блок 3D model и выберите файл GLB или glTF (до 50 МБ). Блок показывает модель в просмотрщике с вращением и масштабированием, а в углу — имя файла, размер и формат. Всё в блоке можно изменить на месте:
Settings(шестерёнка в рамке) открывает таблицу параметров в той же рамке: замещающий текст, подпись под моделью, автовращение, управление камерой и высоту.Saveсохраняет всё сразу,Cancelотменяет изменения. Пока вы редактируете, просмотрщик показывает черновик.- В меню
MoreестьReplace model,Set AR file(дополнительный файл USDZ, чтобы iPhone и iPad открывали модель в AR),Poster from current viewилиUpload poster…(статичное изображение для экспорта в PDF и печати),Remove poster,DownloadиCopy link to block. Open in new tabоткрывает модель на отдельной странице;Fullscreenразворачивает её на месте.
USDZ — это дополнительный файл для AR, а не сама модель: сначала добавьте GLB или glTF, затем задайте файл AR. При замене модели постер и файл AR удаляются, потому что они относились к старому файлу. Общие страницы и экспорт сохраняют подпись и настройки камеры.
04
Создание баз данных
Базы данных делают повторяющуюся работу структурированной, фильтруемой и удобной для проверки. Типичные примеры включают календари контента, трекеры кампаний, исследовательские библиотеки, списки в стиле CRM, трекеры конкурентов и доски задач.
Создание базы данных
- В разделе Рабочее пространство выберите элемент добавления и База данных.
- Выберите, создать полноэкранную базу данных или вставить её внутрь страницы.
- Назовите базу данных по операционной задаче, а не по инструменту: например,
Q3 Content Pipeline, а неContent table. - Создайте первые свойства и представления до импорта большого объёма данных.
Создание полезной схемы
Каждая база данных содержит строки, которые открываются как полные страницы, и свойства, описывающие каждую строку.
Начните с малого. Для контентного конвейера используйте:
| Свойство | Рекомендуемый тип | Пример |
|---|---|---|
| Название | Заголовок | AEO: stop optimizing only for rankings |
| Статус | Статус или выбор | Идея, Черновик, На проверке, Запланировано, Опубликовано |
| Канал | Множественный выбор | LinkedIn, Блог, Рассылка |
| Ответственный | Пользователь | Руководитель контента |
| Дата публикации | Дата | 2026-08-13 |
| Стратегическая тема | Связь или выбор | Образование категории |
| Источник / доказательство | URL, связь или текст | Ссылка на исследовательский отчёт |
Доступные типы свойств могут включать текст, число, выбор и статус, дату, пользователя, связь, URL, телефон, электронную почту, формулу и системные поля, такие как время создания, время последнего редактирования, создано пользователем, последнее редактирование пользователем и ID.
Выбор правильного представления
| Представление | Лучше всего для |
|---|---|
| Таблица | Ввода данных, аудитов, реестров исследований и детального сравнения. |
| Доска | Рабочих процессов, сгруппированных по статусу или другому свойству выбора. Там, где поддерживается, перетаскивайте карточки между группами, чтобы обновлять прогресс. |
| Календарь | Расписаний публикаций, запусков, событий и работы с дедлайнами. |
| Галерея | Визуальных активов, творческих концепций и библиотек на карточках. |
Используйте фильтры, чтобы скрывать неактуальные строки, сортировку - чтобы создать порядок, готовый для принятия решений, а группировку - чтобы сделать состояния процесса видимыми. Общая ссылка базы данных сохраняет её конфигурацию представления, включая фильтрацию и порядок.
Работа в таблице
- Наведите курсор на строку, и слева появятся её элементы управления: + добавляет строку ниже (с клавишей Alt — выше), маркер перемещает строку, если его перетащить, и открывает меню строки по щелчку, а флажок выбирает строку.
- Выберите Открыть в названии строки, чтобы читать и редактировать её как страницу. В полноэкранной базе данных строка открывается рядом с таблицей, а таблица остаётся доступной для правки; Настройки вида → Открывать страницы переключает между вариантами Сбоку, По центру и На всю страницу.
- Щёлкните заголовок столбца, чтобы получить всё, что относится к этому столбцу: фильтр, сортировку, вычисление, закрепление столбцов до него, перенос текста, скрытие, смену типа и настройку вариантов.
- Строка под таблицей показывает одно вычисление на столбец, например сумму или количество, и хранит его вместе с вашим видом.
- Выберите Поиск на панели вида, чтобы оставить только строки, в которых есть каждое введённое слово.
- Выберите несколько строк, чтобы изменить их вместе: панель над таблицей задаёт свойство всем выбранным строкам, дублирует их или удаляет. Щелчок с клавишей Shift выбирает диапазон; Escape снимает выделение.
Связанные и встроенные базы данных
- Используйте встроенную базу данных, чтобы держать небольшую рабочую таблицу внутри страницы планирования.
- Используйте полноэкранную базу данных для операционной системы команды, которой нужно много представлений.
- Используйте связанное представление базы данных, чтобы показывать одну и ту же исходную базу данных на другой странице и в другом контексте. Например, показывайте на странице плана канала только черновики LinkedIn, не дублируя исходные элементы.
06
Работа с агентом
Агент ActVox работает на основе контекста рабочего пространства, прикреплённых материалов, релевантных страниц и поддерживаемых интеграций. Он предназначен для создания устойчивых результатов - страниц, планов, черновиков, записей и артефактов, - а не только одноразового текста в чате.
Как задавать хорошие вопросы
Указывайте ясный результат, релевантный контекст и границу. Например:
Проверьте заметки о конкурентах в этом рабочем пространстве, создайте одностраничную рекомендацию по позиционированию и не изменяйте существующую страницу стратегии.
В разговоре можно ссылаться на страницы, файлы и объекты рабочего пространства. Поддерживайте актуальность исходных материалов, чтобы агент мог обосновывать свой результат.
Прикрепление файлов к разговору
Используйте элемент вложения в поле ввода, чтобы добавить к текущему запросу исходный материал, на обработку которого у вас есть разрешение. ActVox загружает файл в постоянное хранилище рабочего пространства до отправки сообщения. Пока идёт загрузка, Отправить и сочетание Enter остаются недоступными. Дождитесь, пока вложение появится в поле ввода; если загрузка не удалась, устраните отображаемую ошибку и прикрепите файл снова.
Агент может извлекать ограниченный текст из PDF, DOCX, TXT, Markdown, CSV, JSON, XML, HTML и других текстовых файлов. Для изображений, аудио и поддерживаемого видео используются соответствующие пути обработки медиа. Успешно прикреплённый файл сохраняет постоянный URL обслуживания в разговоре, поэтому сообщение и вложение остаются доступными после перезагрузки. Извлечение по-прежнему зависит от читаемости файла: отсканированные PDF без текста, зашифрованные документы, повреждённые файлы и неподдерживаемые двоичные форматы могут потребовать другого формата или явного контекста в запросе.
Сообщите агенту, что это за файл и что с ним сделать. Например:
Прочитайте прикреплённые заметки интервью с клиентами, выявите повторяющиеся возражения и создайте страницу с резюме и цитированием. Не выводите факты, которых нет в документе.
Не прикрепляйте учётные данные, секреты или материал, на обработку которого у вас нет разрешения.
План
Используйте План для многошаговой, неоднозначной, кросс-функциональной или существенной работы.
План должен делать предлагаемую работу проверяемой до исполнения. Он может включать объём, используемые доказательства, предположения, шаги, ожидаемые результаты, риски и точки одобрения. План подходит для таких запросов:
- Создать 90-дневную контент-стратегию на основе исследования и текущего профиля бренда.
- Провести аудит позиционирования конкурентов и рекомендовать категориальный нарратив.
- Спроектировать процесс исследований и отчётности до изменения базы данных.
Проверьте план, исправьте предположения и одобрите следующий шаг в разговоре. Не считайте план доказательством того, что действие уже выполнено.
Действие
Используйте Действие, когда хотите, чтобы агент выполнил поддерживаемую операцию. Действие может создавать или обновлять поддерживаемые объекты рабочего пространства, организовывать материалы, создавать отчёты, создавать черновики и запускать доступные потоки анализа.
ActVox проверяет требуемые эффекты, прежде чем заявить об успехе. Например, при запросе на создание страницы или черновика контента ожидаемым результатом является реальный объект рабочего пространства, который можно открыть и редактировать, а не только вставленный ответ в разговоре.
Низкорисковые обратимые записи в рабочее пространство могут выполняться напрямую, если ваш запрос явный. Разрушительные, массовые, публикационные, затрагивающие рабочие документы или иные высокоэффектные действия могут требовать проверки или одобрения. Внешняя доступность также зависит от разрешений интеграций и политики продукта.
Навыки
Навыки - это повторно используемые, версионируемые пакеты инструкций, доступные в рабочем пространстве. Открывайте их через меню ✨ в поле ввода чата или через соответствующие слеш-команды, если они доступны.
Используйте навык, когда задаче полезна повторяемая процедура, например для сбора контекста при онбординге, создания профиля компании или подготовки начального черновика контента.
Хорошая практика:
- Прочитайте описание навыка и ожидаемый результат.
- Подтвердите, что он соответствует рабочему пространству и предполагаемому результату.
- Запустите его с конкретной информацией, которая ему нужна.
- Проверьте созданную страницу, черновик или артефакт перед общим доступом или публикацией.
Навыки не обходят разрешения рабочего пространства, списки разрешённых действий или требования к одобрению. Навыки, созданные пользователем, версионируются и не должны незаметно переписываться автономными процессами улучшения.
07
Автоматизация и подключения
ActVox может подключать поддерживаемые источники, платформы и инструментарий агентов к рабочему пространству. Подключения ограничены рабочим пространством и регулируются разрешениями, доступностью, квотами и политикой подключённого провайдера.
Словарь доступности
В интерфейсе используются такие состояния доступности: supported, canary_passed, verified, verified_read, documented, unavailable и blocked. verified и verified_read — постоянное одобрение по реальным подключениям в продакшене: verified значит, что запись подтверждена в продакшене, verified_read — только чтение. Метка показывает, насколько ActVox проверил клиент от начала до конца. Это не уровень доступа: права подключения — те, что вы одобряете при согласии. Состояние указывается отдельно для каждого продукта: MCP предоставляет аутентифицированные инструменты и данные рабочего пространства, а навык даёт инструкции локальному агенту.
Доступность ИИ-агентов
| ИИ-агент | MCP | Навык |
|---|---|---|
| ChatGPT | verified | — |
| Claude (хостинг) | verified | — |
| Claude Code | verified read | supported |
| Codex | verified (через коннектор ChatGPT) | supported |
| Hermes | verified через ActVox CLI | supported |
| Grok | verified | — |
| OpenClaw | verified через ActVox CLI | Нет каталожного навыка или установщика |
Храните три хранилища отдельно
Профиль, инструкции рабочего пространства и база знаний — это три отдельных хранилища. Подключение не объединяет их в один блок памяти.
- Профиль хранит описание бизнеса и поля идентичности.
- Инструкции хранят правила работы агента с вами.
- База знаний хранит источники вроде сайтов и документов; индексация может расходовать кредиты.
ChatGPT — MCP — verified
- Добавьте ActVox как пользовательское подключение в режиме разработчика ChatGPT и авторизуйте размещённую конечную точку MCP
https://api.actvox.com/mcpчерез OAuth. - Начните с доступа на чтение к одному рабочему пространству. У ChatGPT нет установщика навыка ActVox; для локального навыка используйте плитку Codex.
Claude (хостинг) — MCP — verified
- В Claude откройте Customize → Connectors →
Add custom connector, вставьтеhttps://api.actvox.com/mcpи выберитеSign in nowс опубликованной OAuth-идентичностью Claude. - Владельцы Team и Enterprise могут добавить коннектор один раз в настройках организации, но каждый участник всё равно входит в систему и даёт согласие отдельно. Claude Code — отдельная плитка.
- Постоянно одобрено 3 октября 2026 года по работе в продакшене: живые подключения выполняли запись, и результат подтверждён повторным чтением, поэтому панель настройки показывает Интеграция: Протестировано.
Claude Code — MCP verified_read; навык supported
- Путь hosted MCP постоянно одобрен на уровне verified read: живые подключения Claude Code читали данные рабочего пространства в продакшене, а запись через его собственное подключение пока не подтверждена. Выполните
claude mcp add --transport http actvox https://api.actvox.com/mcp, затемclaude mcp login actvoxи завершите согласие. - Устанавливаемый навык supported для цели
claude. Используйте плитку Claude Code для установщика, ключа и локальной проверки.
Codex — навык supported; MCP verified
- Устанавливаемый навык supported для цели
codex. Используйте плитку Codex, чтобы установить его, выпустить ключ рабочего пространства и запустить проверки doctor и capabilities только для чтения. - Hosted MCP постоянно одобрен: Codex работает в продакшене через коннектор ChatGPT, включая записи, подтверждённые повторным чтением. Чтобы подключить Codex CLI с его собственной идентичностью, выполните
codex mcp add actvox --url https://api.actvox.com/mcp, затемcodex mcp login actvoxи завершите согласие. Локальная установка навыка не означает поддержку hosted MCP.
Hermes — навык supported; verified через ActVox CLI
- Устанавливаемый навык supported для цели
hermes. Используйте его плитку для установщика навыка и настройки ключа рабочего пространства. - Hermes работает с ActVox через навык и ActVox CLI (ключ рабочего пространства или вход в CLI). Этот путь постоянно одобрен по записям в продакшене, и панель настройки показывает Интеграция: Протестировано через ActVox CLI; сама плитка показывает Подключено, когда вы подключите агента здесь.
- Собственное hosted MCP-подключение Hermes остаётся доступным: выполните
hermes mcp add actvox --url https://api.actvox.com/mcp --auth oauth, затемhermes mcp login actvoxи завершите согласие. Инструкции навыка сами по себе не дают данных рабочего пространства; храните ключ в защищённой среде агента.
Grok — MCP — verified
- На grok.com откройте Connectors → New Connector → Custom и добавьте
https://api.actvox.com/mcpсо значениями OAuth, показанными на плитке Grok. - У Grok нет ActVox CLI или установщика навыка. Это подключение постоянно одобрено: живые подключения Grok выполняли запись в продакшене, и результат подтверждён повторным чтением.
OpenClaw — verified через ActVox CLI; установщика нет
- OpenClaw работает с ActVox через ActVox CLI (плитка ActVox CLI: вход в CLI или ключ рабочего пространства). Этот путь постоянно одобрен по записям в продакшене, и панель настройки показывает Интеграция: Протестировано через ActVox CLI; сама плитка показывает Подключено, когда вы подключите агента здесь.
- Его собственное hosted MCP-подключение остаётся доступным: выполните
openclaw mcp add actvox --url https://api.actvox.com/mcp --transport streamable-http --auth oauth, затемopenclaw mcp login actvoxи завершите согласие. Каталожного навыка или цели установщика для него нет. - В манифесте по-прежнему указан
local_skillкак ограничение, но у OpenClaw нет каталожного флагаskill: true, и он не является устанавливаемым skill-клиентом. Не заявляйте поддержку и не добавляйте установщик.
Короткая первая проверка
После готовности поддерживаемого навыка или доступного MCP-подключения отправьте эту проверку базы знаний только для чтения:
Run a read-only Knowledge Base smoke test. Tell me which workspace you can access and list the titles of the first three Knowledge Base sources. Do not write or save any personal information unless I explicitly confirm the exact fields and values first.
Это проверка, а не пятишаговый онбординг. Если после неё начинается онбординг, спрашивайте перед каждой записью и отдельно показывайте изменения профиля, инструкций и базы знаний.
Управление и удаление
- Для MCP раздел Настройки → Подключения показывает грант, последний вызов и подтверждённый эффект; приостановите, возобновите или отзовите доступ там, затем удалите подключение у провайдера.
- Для навыка отзовите его ключ рабочего пространства на странице «Коннекторы» и удалите установленный навык у локального агента.
- Если страница согласия сообщает, что клиент не одобрен, определяющей является политика текущей плитки. Повторная попытка не изменит статус documented, unavailable или blocked.
Ваши агенты и ваша роль
- Подключить собственного агента может любой участник с ролью редактора или выше — через страницу согласия или ключом на вкладке коннектора. Имя агенту вы даёте при подключении. Агент виден только вам, пока владелец или администратор не откроет его для всего рабочего пространства, и только вы видите его подключения.
- Агент никогда не может больше, чем сейчас может подключивший его человек. Агент редактора не может делиться, публиковать и менять настройки рабочего пространства; если вы станете наблюдателем, ваш агент сможет только читать; если вы покинете рабочее пространство, он перестанет работать.
- На тарифе Free ИИ-коннекторы считаются на всю организацию: продукт, который уже подключил другой участник, не занимает новый слот.
Границы автоматизации
Доступное подключение не означает, что каждое действие автоматическое или одобренное. Публикация, платная активность, разрушительные обновления и высокоэффектные внешние действия могут требовать явного одобрения. ActVox не гарантирует доступность внешних платформ или результаты кампаний.
08
Администрирование и безопасность
Администрирование рабочего пространства и организации
Доступ к рабочему пространству следует за аутентифицированным пользователем и границей рабочего пространства или организации. В организации администраторы могут управлять членством, приглашениями и ролями через элементы управления организации.
Используйте наименьшие необходимые полномочия:
- Предоставляйте участникам доступ только к нужному им рабочему пространству и информации.
- Предоставляйте административные роли только тем, кто управляет членством, настройками или важными действиями.
- Регулярно проверяйте приглашения в организацию и роли участников.
- Своевременно удаляйте доступ после завершения работы подрядчика, взаимодействия с клиентом или трудовых отношений.
API-ключи
Откройте Настройки → API-ключи, чтобы создавать API-ключи и управлять ими.
| Разрешение | Доступ |
|---|---|
workspace:read | Чтение данных проекта. |
workspace:write | Изменение данных проекта. |
strategy:read / strategy:write | Чтение или изменение стратегии проекта. |
content:read / content:write | Чтение, создание и изменение контента. |
reports:read | Чтение отчётов. |
admin | Полный доступ. Используйте экономно. |
По возможности предпочитайте ключ с областью одного проекта ключу для нескольких проектов. Секретное значение показывается только при создании. Храните его в надлежащем менеджере секретов или одобренной среде инструментов, а не на странице, в чате, загруженном файле, снимке экрана или репозитории исходного кода.
Немедленно отзовите ключ, если он мог быть раскрыт, больше не нужен или принадлежит уходящему сотруднику. Также можно удалить отозванный ключ, чтобы убрать его из списка.
Безопасность аккаунта и общего доступа
- Откройте Управление аккаунтом в меню аккаунта: «Аккаунт» (имя, адреса email, подключённые аккаунты), «Безопасность» (пароль, passkey, активные устройства, удаление аккаунта), «Кредиты» (ваши ActVox Credits) и «Оплата» (способы оплаты и выписки). Администраторы организации открывают Управление организацией через шестерёнку на строке организации: «Общие» (название, логотип, выход, удаление), «Участники» (приглашения и роли), «Кредиты» (общий баланс и места) и «Оплата».
- Используйте элементы безопасности аккаунта для настроек безопасности личного аккаунта.
- Используйте Настройки → Общие ссылки, чтобы проверить, что доступно извне прямо сейчас.
- Считайте публичные ссылки публичными. Не полагайтесь на скрытность URL как на меру безопасности.
- Поменяйте ссылку, изменив её аудиторию, либо отзовите её и создайте новую.
- Используйте ссылки только для организации, когда материал предназначен исключительно для вашей организации.
09
Отчёты
Отчёты - это устойчивые результаты исследований и аудита, связанные с рабочим пространством. Они могут фиксировать анализ сайтов, рынков, конкурентов, SEO/AEO, социального присутствия, локального присутствия и других поддерживаемых бизнес-сигналов.
Создание или запуск отчёта
- Откройте Отчёты в разделе Контекст Workspace OS.
- Используйте Запустить новый анализ, когда этот элемент доступен.
- Ясно укажите вопрос, объём, источники, рынок или целевую аудиторию.
- Проверьте доказательства, предположения и рекомендации отчёта.
- Превратите принятые рекомендации в Стратегию, страницу, элемент базы данных или задачу.
Отдельный маршрут отчётов перенаправляет в Workspace OS; запись отчётов в Workspace OS является каноническим местом для поиска и продолжения работы с отчётами.
Критическая проверка отчёта
Отчёт - это результат, основанный на доказательствах, а не гарантия. Перед тем как действовать на его основе:
- Проверьте качество и дату источника.
- Отделите наблюдаемые факты от гипотез и рекомендаций.
- Подтвердите всё, что влияет на юридические заявления, цены, бюджеты, внешние обязательства или публикацию.
- Свяжите отчёт со стратегией или решением, на которое он повлиял.
10
Стратегия
Стратегия - это устойчивый артефакт рабочего пространства для решений, направляющих исполнение. Она должна связывать исследования с приоритетами, аудиториями, позиционированием, каналами, кампаниями и измерением.
Используйте Стратегию для таких вопросов:
- Какому сегменту аудитории следует отдать приоритет в этом квартале?
- Какой категориальный нарратив и ценностное предложение должны направлять контент?
- Какие каналы заслуживают инвестиций и что мы будем измерять?
- Что должно быть верно до запуска кампании?
Рекомендуемая структура стратегии
- Цель - коммерческий или стратегический результат.
- Аудитория - кто для вас важнее всего, их контекст и задача, которую они пытаются решить.
- Доказательства - отчёты, источники, исследования и сигналы от клиентов.
- Позиционирование - категория, дифференцированная ценность, доказательства и возражения.
- Стратегические выборы - что приоритизировать, избегать, упорядочить или проверить.
- Система исполнения - контент, кампании, исследования и операционная работа, связанные со страницами или базами данных.
- Метрики - опережающие сигналы, итоговые метрики, ответственный, периодичность проверки и правила принятия решений.
Не превращайте Стратегию в хранилище каждой идеи. Оставляйте её ориентированной на решения и ссылайтесь на более глубокие доказательства в других местах.
11
Design.md
Design.md - это запись Контекста для устойчивого направления дизайна. Используйте её, чтобы сделать творческую работу более согласованной между людьми, страницами и результатами с поддержкой агента.
В этом руководстве фраза «Спроектируйте мой…» интерпретируется как поверхность контекста Design.md в Workspace OS.
Сильный Design.md может включать:
- Личность бренда и визуальные принципы.
- Указания по цвету и типографике.
- Направление для изображений, видео, иллюстраций и компоновки.
- Примеры того, чему следовать и чего избегать.
- Требования к доступности и локализации.
- Ограничения для конкретных каналов, например размеры карусели LinkedIn или визуальные стандарты вебинара.
Используйте краткий, проверяемый язык. Например, напишите «редакционный, точный, высококонтрастный, документальный визуальный стиль; без типичных синих градиентов ИИ» вместо «сделайте современно». Ссылайтесь на утверждённые исходные активы из Загруженное или Базы знаний.
12
База знаний
База знаний - библиотека источников рабочего пространства. Используйте её для материалов, которые агент и команда должны иметь возможность искать, цитировать и пересматривать.
Добавление источников
Можно добавить:
- Веб-URL.
- PDF.
- Документ Word (
.docили.docx). - Обнаруженные источники из подходящего поиска по отрасли, типу бизнеса и местоположению.
Чтобы добавить источник:
- Откройте База знаний в разделе Контекст.
- Добавьте URL или загрузите поддерживаемый документ.
- Дождитесь завершения обработки и индексации.
- Выполните поиск в Базе знаний, чтобы убедиться, что источник полезен и доступен для поиска.
Поиск и использование доказательств
Используйте поиск Базы знаний для получения релевантных источников рабочего пространства перед созданием брифа, отчёта, стратегии или контентного актива. Поиск источников помогает выявлять кандидатов, но проверяйте найденные источники, прежде чем считать их авторитетными. Можно оценивать найденные источники, чтобы улучшать релевантность последующего поиска.
Поддержание качества
- Предпочитайте первичные источники, утверждённые материалы бренда, исследования клиентов и датированные рыночные доказательства.
- Удаляйте устаревшие, нерелевантные, дублирующиеся или ненадёжные источники.
- Храните конфиденциальные материалы в подходящем рабочем пространстве и никогда не добавляйте секреты.
- Используйте осмысленные названия источников, чтобы коллеги могли оценить результат, не открывая каждый файл.
- Повторно индексируйте обновлённый источник, когда его содержимое существенно изменилось.
13
Загруженное
Загруженное - это раздел рабочего пространства для файлов, добавленных в Workspace OS. Используйте его для исходного рабочего материала, который должен оставаться доступным в рабочем пространстве, включая документы, изображения и другие поддерживаемые типы файлов.
Используйте Загруженное, когда нужно:
- Сохранить исходный файл источника до преобразования его в страницу или отчёт.
- Дать агенту авторизованное вложение для ссылки.
- Просматривать, организовывать, переименовывать, перемещать или удалять файлы рабочего пространства.
- Повторить неудавшуюся загрузку.
Загружайте аккуратно
- Откройте Загруженное или используйте элемент загрузки в соответствующей поверхности рабочего пространства.
- Выберите файл и дождитесь завершения его состояния загрузки.
- Переименуйте его или поместите в правильное расположение рабочего пространства.
- Добавьте контекст на странице, в строке базы данных или разговоре, поясняющий, как следует использовать файл.
Для текстовых файлов, подходящих для разбора, ActVox может связать загрузку с источником знаний, чтобы его можно было индексировать и находить. Загрузки не становятся публичными автоматически; общий доступ к странице или базе данных - отдельное действие.
14
Память
Память содержит устойчивый контекст рабочего пространства, который помогает ActVox не заставлять вас повторять важную бизнес-информацию. Она может быть заполнена во время онбординга и обогащаться подходящими потоками работы агента.
Примеры полезной памяти:
- Описание бизнеса, приоритетная аудитория, ограничение позиционирования или целевой регион.
- Утверждённое терминологическое правило или известное возражение.
- Повторяющееся операционное предпочтение, которое должно влиять на будущую работу.
Память ограничена рабочим пространством и учитывает авторизацию. Рассматривайте её как устойчивый контекст, а не как хранилище секретов или замену первичным исходным записям.
Ответственное использование памяти
- Помещайте постоянные операционные инструкции в ACTVOX.md.
- Помещайте подробные доказательства в Базу знаний, Загруженное или отдельную страницу.
- Храните решение в Стратегии, отчёте или на странице, где его можно проверить и пересмотреть.
- Не полагайтесь только на память для критически важных утверждений; подтверждайте их по актуальным источникам.
15
Разговоры
Разговоры - это рабочая поверхность агента. Они находятся в области Агенты Workspace OS и поддерживают связь обсуждения с контекстом и объектами рабочего пространства.
Используйте разговоры для работы, а не только вопросов
Продуктивный разговор обычно содержит:
- Результат - что нужно получить.
- Контекст - релевантные страницы, источники, файлы или ограничения бизнеса.
- Граница - что агент может и не может изменять, публиковать или предполагать.
- Точка проверки - когда вам нужен план, черновик, рекомендация или запрос одобрения.
Пример:
Спланируйте проверку позиционирования конкурентов для нашего рынка Великобритании. Используйте источники Базы знаний и текущую Стратегию. Создайте страницу с доказательствами и рекомендациями, но не изменяйте Стратегию, пока я её не одобрю.
Управление результатами разговора
Когда разговор даёт результат, который стоит сохранить, попросите агента сохранить его как страницу, отчёт, обновление стратегии, черновик контента, элемент базы данных или артефакт. Откройте получившийся объект и проверьте его вне чата. Это создаёт устойчивую запись и делает работу повторно используемой командой.
Осознанно используйте прикреплённые файлы, страницы по ссылкам и навыки. Они улучшают обоснованность, но не отменяют необходимость проверки человеком.
16
Контент
Контент - область результатов для маркетинговых активов, таких как черновики, адаптации и работа с медиа. Она предназначена для связи контента со стратегией рабочего пространства, исследованиями и контекстом источников.
Используйте Контент, чтобы:
- Создавать и проверять черновики маркетинговых активов.
- Организовывать варианты и адаптации.
- Связывать контент с релевантной аудиторией, кампанией, каналом, стратегической темой и доказательствами.
- Подготавливать работу для календаря контента или процесса публикации.
Рабочий процесс контента
- Начните со стратегического намерения и конкретной аудитории.
- Передайте агенту утверждённые источники, позиционирование и ограничения канала.
- Запросите редактируемый черновик, а не автоматическую публикацию.
- Проверьте фактические утверждения, голос, дифференциацию, CTA и соответствие требованиям.
- Сохраните утверждённый черновик в Контенте и свяжите его с кампанией или записью базы данных.
- Используйте соответствующую интеграцию или процесс публикации только после необходимого одобрения.
Черновик, адаптация и планирование поста
Самый быстрый путь от идеи до запланированного поста проходит через агента и базу данных календаря.
- Попросите агента подготовить черновик и назовите платформу, аудиторию и цель.
- Попросите адаптации утверждённого варианта для остальных платформ, которые вы используете.
- Проверьте каждый черновик в Контенте и отредактируйте утверждения, голос и призыв к действию.
- Установите статус «Запланировано» и выберите дату публикации в связанной записи календаря.
- Публикуйте через подключённый аккаунт только после требуемого утверждения.
Пример запроса: «Подготовь пост о запуске для Instagram для владельцев местных кафе, затем адаптируй его для LinkedIn и X и добавь оба в календарь на следующую неделю».
ActVox может генерировать и адаптировать контент, но не гарантирует охват, позиции, вовлечённость, конверсии или выручку.
17
Артефакты
Артефакты - это созданные результаты рабочего пространства, которые не являются просто страницей или черновиком контента. Они могут включать результаты поддерживаемых потоков агента или генерации медиа и сохраняют контекст, необходимый для проверки или повторного использования работы.
Используйте Артефакты, чтобы:
- Проверить созданный результат до решения о том, где он должен находиться.
- Сохранить происхождение результата связанным с рабочим пространством.
- Продвинуть пригодный результат в Контент, страницу, отчёт или другую операционную запись.
- Отделять экспериментальный или созданный материал от финальных утверждённых документов - источников истины.
Проверка перед повторным использованием
Перед общим доступом, публикацией или использованием артефакта:
- Откройте его и проверьте фактический результат.
- Проверьте, что он соответствует ограничениям запрошенной аудитории, бренда, источника и канала.
- Сверьте фактические утверждения с исходными доказательствами.
- Подтвердите права, разрешения и требования платформы для любого внешнего использования.
- Переместите или свяжите утверждённый результат со страницей, базой данных, элементом Контента или кампанией, из которых будет работать команда.
Принципы работы
- Сначала контекст. Поддерживайте актуальность профиля бизнеса, инструкций, доказательств и стратегии.
- Страницы для мышления, базы данных для повторяемых операций. Не превращайте каждую страницу в таблицу или каждую таблицу в документ.
- Планируйте существенную работу заранее. Проверяйте объём и предположения до исполнения.
- Действуйте с проверкой. Проверяйте созданные объекты и явно одобряйте высокоэффектную внешнюю активность.
- Сохраняйте доказательства. Связывайте рекомендации с отчётами, источниками и решениями.
- Предоставляйте узкий доступ. Предпочитайте минимальную аудиторию и минимальный объект, решающие задачу совместной работы.
- Защищайте секреты. Не помещайте учётные данные, токены или чувствительные персональные данные в публичные ссылки, страницы, запросы или загруженные файлы.