Источники данных рабочего пространства

Источники данных рабочего пространства

В каждом рабочем пространстве есть короткий список того, где лежат его данные: таблицы и документы, которые вы загрузили, Google-таблицы и другие ссылки, которые вы присылали, отчёты, которые ассистент для вас построил, сайты, на которые он входит, и подключённые интеграции. Ассистент читает этот список в начале каждого чата — поэтому на вопрос «как продажи в этом месяце?» он открывает нужную таблицу и не отвечает «данных нет», когда построенный на прошлой неделе отчёт лежит в папке.

Что попадает в список и когда

Ничего делать не нужно. Источник добавляется, когда:

• вы загружаете файл — таблицу, CSV, PDF, документ;
• вы присылаете ссылку в сообщении — Google-таблицу или документ, любой другой адрес;
• ассистент строит для вас отчёт — и запоминает, из каких файлов;
• ассистент входит на сайт в своём браузере — сохраняется только адрес сайта;
• к пространству подключена интеграция;
• в данных пространства появляется таблица — её сделал ассистент, вы через публичный API или шаблон. Служебные таблицы платформы (черновики и статистика линии поддержки, входящие, брифы и задачи шаблона «Личный ассистент») в список не попадают.

Ассистент может добавить источник и сам, если вы о нём расскажете («прайс у нас на сайте, раздел /prices»).

Что запоминается — и что никогда

О каждом источнике хранится: что это, по кому или о чём он («по: Арман»), когда его использовать и за какой период данные, если это известно. Ваши слова — главные: если вы написали «вот продажи по Арману», фраза сохраняется так, как вы её написали, и ассистент никогда не заменит её своей догадкой. И выдать свою догадку за ваши слова ассистент не может: вашими слова помечаются, только если они есть в том, что вы сами написали в этом чате. Вопрос «что дала наша реклама в Яндекс Директе?» не сообщает Plank, что вы пользуетесь Яндекс Директом.

Ссылка хранится без служебной части — всё после ? и # отбрасывается, а Google-документ хранится только по своему идентификатору.

Логины и пароли в этом списке не хранятся никогда. Если сообщение, заметка или описание похожи на логин или пароль, они не будут сохранены. У сайта, вход на который сохранён, в списке стоит только «вход сохранён». Сам логин хранится в «Доступах»: сохранённый там вход отмечает свои сайты здесь — общий всегда, личный только в пространстве, где вы одни, — а удаление снимает отметку. Если в списке было отмечено, что логин записан открытым текстом в файле, после сохранения ассистент скажет, в каком, чтобы вы могли убрать эту копию.

Почему ассистент иногда задаёт вопрос

Иногда после ответа ассистент задаст один короткий вопрос:

• «По кому эта таблица?» — когда новый источник похож на уже известный (например, две таблицы продаж), и непонятно, какой клиент у какой. Ваш ответ поможет в следующий раз выбрать правильную.
• «Когда её использовать?» — один раз для нового источника, чтобы он поднимался первым для нужных задач.

Ассистент задаёт не больше одного вопроса за раз, не спрашивает дважды про один источник и никогда не спрашивает в автоматическом запуске (по расписанию, по вебхуку) — там некому ответить. Если запросу подходят несколько источников и непонятно, какой вы имеете в виду, он спросит, а не выберет сам.

Где посмотреть список: раздел «Источники»

Откройте «Источники» на боковой панели (на телефоне — Ещё → Источники). Раньше раздел назывался «Интеграции»; старая ссылка или закладка по-прежнему его открывает. В нём две части:

• «Подключения» — куда ассистент заходит сам: подключённые сервисы и сайты, вход на которые сохранён. У каждого видно, работает ли вход («Вход работает», «Нужно переподключить», «Подключение не завершено»), или стоит «Вход сохранён в «Доступах»». Ничто не отмечено как работающее, если Plank этого на самом деле не знает. См. Подключение ваших инструментов.
• «Данные» — файлы, отчёты, ссылки и таблицы; сначала те, которыми ассистент пользовался недавно. Можно отобрать по тому, кто добавил («Все», «Вы прислали», «Сделал агент»), по «Темам» или найти поиском («выручка по врачам», «прайс») — поиск смотрит в название, описание, «когда смотреть» и тему. Источник с пометкой «Без описания» — тот, о котором ассистент спросит, когда вы будете в чате. У таблицы данных вместо этого написано «Таблица данных» и сколько в ней сейчас строк (считается, когда открываете раздел); про таблицы ассистент не спрашивает, так что если название говорит мало — опишите её сами. Удалённая таблица пропадает из списка, а ваше описание вернётся, если таблицу с тем же именем создадут снова.

Между двумя частями — две строки, которые открывают разделы, жившие до 12 октября 2026 года на боковой панели:

• «Доступы» — сохранённые логины, пароли и ключи. Строка показывает только, сколько их сохранено, — никогда не сами значения. См. Доступы.
• «Таблицы» — появляется, когда в пространстве есть таблица данных, и открывает список таблиц. У отдельной таблицы данных в «Данных» есть ещё кнопка «Открыть таблицу» — она показывает её строки. См. Данные приложений и базы данных.

Кнопка «Добавить источник» (на телефоне — +) добавляет «Ссылка или Google-документ» или «Сайт»: вставьте адрес и, если хотите, напишите, что это и когда агенту туда смотреть. Файл добавлять не нужно — пришлите его в чат или загрузите в «Файлы», и он появится здесь сам. Логин от сайта сохраняйте в «Доступах», не здесь.

Когда подключение перестало работать

Подключение пишет «Нет доступа с» и дату, только если что-то действительно попробовало войти и не смогло: проверка скриптов сервиса, собственный статус MCP-сервера, «Проверить» у сохранённого входа в «Доступах», отказ сайта общему браузеру пространства или отозванный либо истёкший доступ Instagram. Всё, что Plank не пробовал, остаётся просто «Подключено» — ни сломанным, ни работающим наугад оно не показывается. Подключение, которое ответило, пишет «Работает» (MCP-сервер или бот) или «Вход работает».

Откройте подключение, чтобы увидеть причину одной фразой (например, «Сохранённый вход не прошёл проверку — возможно, ключ отозван или пароль сменился.»). Сохранённый вход исправляется кнопкой «Открыть в Доступах»; для остального есть «Войти заново» — откроется чат, где ассистент поможет. «Проверить связь» спрашивает сразу: проверяет сохранённый вход или заново читает скрипты сервиса, а если у источника проверки нет, так и скажет — тогда статус обновится, когда агент им воспользуется. Вход, который участник сохранил для себя, проверяется только для него: в пространстве с другими участниками его результат не показывается как статус источника. Участники с правом только просмотра кнопку «Проверить связь» не видят.

Если доступ к Google-документу или сервису Google отозван на стороне Google, «Нет доступа с» пока не появится — Plank этого отказа не видит; ассистент скажет об этом в чате, когда не сможет его открыть.

Бот, который принимает сообщения (автоматизация по вебхуку, например Telegram-бот), виден в «Подключениях» как «Бот · принимает сообщения» под именем автоматизации — переименуете автоматизацию, и источник переименуется вслед, если только вы не назвали его по-своему. Бот без имени называется «Бот». Приём обращений в службу поддержки клиники — часть самой платформы, в списке его нет. Если удалить автоматизацию, бот пропадёт из списка.

Когда агент сюда заходил и чем ещё связано

Откройте любой источник — в разделе «Когда агент сюда заходил» видно, когда чат его прочитал, сделал из него результат или им воспользовалось расписание: что просили и в каком чате. Заход из вашего собственного или из общего чата ведёт в этот чат. Заход из чужого личного чата показан только как «в личном чате» — без названия, без вопроса и без ссылки, чтобы никто не узнал, о чём спрашивал другой участник. Заход по расписанию называет расписание и помечен «автоматически»; так же и заход бота — он называет бота и ведёт на его страницу. Хранятся последние 50 заходов, не старше полугода; заходы до того, как их начали записывать, не показываются.

«Чем ещё связано» — скрипты, через которые работает источник, другие боты на том же скрипте, а также расписания и навыки, в тексте которых он упомянут; любой из них открывается оттуда. Расписания и навыки находятся по упоминанию в тексте: если там источник назван другими словами, они не появятся.

Агенту нужна ваша помощь

Вверху раздела ассистент перечисляет то, что не смог понять сам: подключение, в которое он больше не может войти (первым), вопрос, который он задал в чате и на который никто не ответил; ссылку, найденную в чате («Добавить» или «Не нужен»); присланный вами файл без описания; источник, которому нужна тема. На компьютере первые три вопроса видны сразу (и «ещё N»); на телефоне строка «Агенту нужна ваша помощь» открывает их по одному вопросу за раз («Сохранить и дальше»). «Позже» убирает вопрос на неделю — в чате ассистент всё равно может его задать.

Число рядом с «Источники» на боковой панели считает только то, что ждёт вас сейчас — подключение без доступа и вопросы, которые ассистент задал и ждёт ответа, — а не каждый файл без описания. Участники с правом только просмотра не видят ни вопросов, ни числа.

Как исправить список

Откройте источник в разделе «Источники». В блоке «Что агент об этом знает» три строки — «Что это», «Когда агенту сюда смотреть» и «Про кого / про что», у каждой кнопка «Изменить». То, что вы «Сохранить», — ваше: строка помечается «Написали вы» (или «Написал участник», с датой), ассистент её не переписывает и читает в начале каждого чата. Очистите строку — и ассистент снова сможет предложить свою. Строка, которую написал ассистент, помечена «Предложил агент · можно исправить», а под ней указано, из какого чата она пришла.

Внизу источника:

• «Пометить устаревшим» — источник остаётся в списке с пометкой «устарел», но ассистент сам его больше не предлагает. «Снова актуален» отменяет это.
• «Убрать из источников» — источник пропадает из списка, и ассистент перестаёт его предлагать. Файл, вход и ссылка остаются на месте — ничего не удаляется. Кнопка «Вернуть» сразу после этого возвращает его, как и повторное добавление той же ссылки. Новая загрузка того же файла сама его не вернёт.

Не пишите туда пароли и ключи — раздел их не примет и предложит сохранить в «Доступах». У источника с сохранённым входом видно только название входа, что именно хранится — пароль, ключ или токен — и одна кнопка «Открыть в Доступах»; само значение здесь не показывается никогда. Участники с правом только просмотра видят описания, но изменить их не могут.

Или просто скажите в чате: «эта таблица по Бекзату, а не по Арману», «тот отчёт устарел», «теперь бери новый прайс». Ассистент обновит источник — ваши слова заменят прежние.

Пространства, созданные до появления списка

Список заполнен тем, что уже было: недавние загрузки, недавние отчёты, подключённые интеграции и сайты. К файлу, который вы прикрепили в чате, привязано и то, что вы написали при отправке («вот отчёты по услугам»), — так ассистент найдёт его в новом чате, даже если файл называется просто report (12).xlsx. В каждом таком пространстве ассистент один раз просматривает ваши заметки (AGENTS.md, index.md, knowledge/) и добавляет найденные там источники. Сами файлы он не меняет. Если в заметке открытым текстом записан логин, ассистент отмечает только, где он записан, но не сам логин.

Для ассистента — инструменты

• plank_sources_find — поиск по списку (по словам, subject, kind, period). У каждого совпадения указан subject. Если подходят несколько и из запроса не ясно, какой, спроси человека, какой именно — не выбирай сам. Пустой результат не доказывает, что данных нет: посмотри и в самом пространстве.
• plank_source_add — добавить источник, появления которого платформа не видела. Загрузки, присланные ссылки, отчёты, сайты и интеграции регистрируются сами. Добавляй только то, что точно есть (в заметках, файлах, в ссылке или доступе от человека), — никогда сайт или сервис, который просто упомянут в вопросе.
• plank_source_update — сохранить то, что сказал человек (subject, use_when, с from_person: true), или пометить источник superseded / gone.
• from_person: true проверяется: слова должны быть словами человека, скопированными так, как он написал их в этом чате. Если их нет в его сообщениях, флаг снимается и слова сохраняются как твои — об этом скажет ответ инструмента.
• Если в ответе инструмента есть ASK — задай в ответе этот один вопрос на языке человека и сохрани ответ через plank_source_update.
• Никогда не записывай логин, пароль, токен или ключ ни в одно поле — это будет отклонено. Если такое есть в заметках, укажи в login_seen_in файл, где оно записано, и ничего не копируй.