Поиск, ответы с источниками и граф знаний¶

Результат¶

Вы сможете найти синхронизированные данные проекта, задать вопрос по этим данным, проверить источники ответа и пройти по связям между сущностями.

Что потребуется¶

Роль проекта не ниже Viewer.
Хотя бы один источник с завершённой синхронизацией.
Перед поиском выберите правильный проект. Знания и ответы не объединяются между проектами.

Найти сущность¶

Откройте Knowledge и оставьте выбранным представление List.
Введите фразу в Search whole project и нажмите Search.
Откройте результат и проверьте источник, статус, содержимое, детали, neighborhood и связанные сущности.
Используйте Open in source, если нужно свериться с оригиналом.
Нажмите Back to browse, чтобы вернуться к постраничному списку.

Поиск семантический: содержательная фраза вроде decisions about pricing обычно полезнее точного идентификатора. Поиск работает по всему текущему проекту и возвращает подходящие сущности, но не формирует готовый ответ.

В режиме просмотра доступны фильтры Decisions, Action items, Meetings, This week, фильтр по типу и Themes. Фильтр This week применяется только к загруженной странице.

Найти документ¶

У документов, написанных в Threadory, свой список: Knowledge → Documents.

Введите текст в Search titles and text и нажмите Search. Поиск находит слова в том виде, как они введены (регистр не важен), в названии документа, имени его линии и кратком описании, а начиная с трёх символов — и в тексте текущей версии. Строка, найденная только по тексту, помечена Matched in text и показывает фрагмент вокруг первого совпадения.
Сузьте список фильтрами: тип, статус, Any author и Any work item. Фильтры работают вместе; Clear сбрасывает все.
Author — все, кто создавал или правил версию документа; Me (…) — это вы. Документ относится к автору, если тот написал любую его версию, а не только последнюю.
Work item — рабочие элементы, на которые ссылаются документы: по названию, если Threadory знает элемент, иначе по адресу. Остаются документы, текущая версия которых ссылается ровно на этот элемент.

Только что сохранённый текст находится по названию сразу, а по тексту — через несколько секунд, когда Threadory его проиндексирует.

Вкладка браузера показывает название текущей страницы или открытого документа и Threadory. Для нативных документов название соответствует выбранной версии и обновляется после сохранённого переименования — несколько открытых документов легче различать.

Нативные документы используют доступную ширину страницы при чтении и редактировании. На большом мониторе таблицы и редактор расширяются вместе с окном; на узком экране широкие таблицы прокручиваются по горизонтали.

Комментарии к документу¶

Участники с ролью member и выше могут выделить текст документа в KB и нажать Comment. Форма открывается рядом с выделением и показывает цитату и раздел. Комментарий относится к версии на экране. Выберите Internal — team only, чтобы он не отображался по публичным ссылкам. Общий комментарий можно оставить в панели под документом. Для роли viewer и архивных документов доступно только чтение.

Черновик общего комментария сохраняется, пока вы пишете, отправляете или отменяете комментарий к выделению. Cancel или Escape отменяет только черновик комментария к выделению. При ошибке отправки текст остаётся в форме для повторной попытки. Смена версии закрывает форму у выделения, но сохраняет общий черновик; он будет отправлен к версии, которая сейчас на экране. Переход в редактор сбрасывает оба черновика — сначала отправьте комментарий.

Все публичные ссылки проекта¶

Участники с ролью member и выше видят все публичные ссылки на документы проекта на одной странице: Knowledge → Documents → Shared links.

У каждой ссылки видно: документ, подпись, Living (всегда последняя версия, отправленная на ревью или утверждённая) или Pinned (одна версия), кто может читать, кто и когда создал, срок действия, число просмотров и состояние: Active, Expired или Revoked.
Active показывает работающие ссылки; All добавляет отозванные и истёкшие.
Чтобы снова отправить действующую ссылку, нажмите Copy link: адрес попадёт в буфер обмена. Если браузер этого не разрешил, адрес появится в поле — выделите его и скопируйте. Каждое копирование записывается в журнал аудита проекта.
Чтобы ссылка перестала работать, нажмите Revoke и подтвердите. Она перестаёт открываться сразу у всех, у кого она есть.

Та же кнопка Copy link есть у каждой действующей ссылки в разделе Publications самого документа, поэтому, закрыв окно с новой ссылкой, вы ничего не теряете.

Кнопки Copy link может не быть по двум причинам:

«Copying links isn't set up on this server» над списком: сервер Threadory не настроен показывать адрес ссылки повторно, поэтому скопировать нельзя ни одну ссылку — даже новую, её адрес тогда показывается один раз, при создании. Обратитесь к администратору; новая ссылка здесь не поможет.
«Created before copying links was available here» у одной ссылки: копирование работает, но эта ссылка старше, и её адрес показывался один раз. Чтобы снова поделиться таким документом, откройте его и создайте новую ссылку в разделе Publications (а старую отзовите, если ею больше не должны пользоваться).

У отозванной или истёкшей ссылки и у ссылки на архивный документ копировать нечего.

Чем заканчивается страница ссылки¶

На бесплатном тарифе публичная страница ссылки заканчивается строкой «Shared with Threadory · Specs with client comments and sign-off · Start free», а в PDF, скачанном с неё, на каждой странице стоит «Exported from Threadory · threadory.ai». На платном тарифе на странице остаётся только простая строка «Shared with Threadory», а в PDF строки с подписью нет; владелец или администратор может включить полную подпись Threadory в Settings → General. Ссылка в этой строке ведёт на сайт Threadory и никогда не содержит адрес вашего документа.

Задать вопрос и проверить источники¶

Нажмите плавающую кнопку Ask Brain.
Задайте один конкретный вопрос о текущем проекте.
Прочитайте ответ и проверьте раздел Sources под ним.
Откройте важные источники и сравните ответ с синхронизированной сущностью.
Если нужен контекст, задайте уточняющий вопрос в той же панели.

Ask Brain также открывается кнопкой Ask Brain на странице сущности и кнопкой Ask Brain about this над графом. Панель сохраняет короткую недавнюю историю диалога. Если данных недостаточно для уверенного ответа, появится сообщение Limited information available.

Warning

Ссылки на источники помогают проверить ответ, но перед важным решением всё равно нужно прочитать оригинальные данные.

Ограничить retrieval областью знаний¶

Администратор проекта может создать именованную область в Settings → Advanced → Knowledge Scopes. Область сужает retrieval по типам сущностей, системам-источникам, labels, allowlist UUID сущностей или комбинации этих ограничений.

После создания область можно выбрать для отдельного диалога Ask Brain, назначить по умолчанию skill или привязать к новому MCP API-ключу. Фильтры конкретного запроса пересекаются с областью и не могут её расширить. Для проектов, проиндексированных до появления областей знаний, попросите оператора выполнить reindex, прежде чем полагаться на фильтры по labels.

Диалоги Ask с выбранной областью используют только проиндексированный граф знаний. Live federated-поиск по коннекторам отключается, потому что live провайдеры не дают единого контракта для labels и allowlist сущностей.

Warning

Область знаний управляет retrieval, но не является границей доступа. Доступ по-прежнему задают роли проекта и разрешения API-ключа. Прямые MCP point/list-инструменты ограничены проектом, а не областью знаний.

Исследовать связи¶

Откройте Knowledge и выберите Graph.
Найдите сущность и выберите её как центр графа.
Используйте легенду, чтобы различать типы сущностей.
Нажмите соседний узел, чтобы сделать его новым центром.
Нажмите заголовок над графом, чтобы открыть детали центральной сущности.

Граф показывает прямые связи текущего проекта в обоих направлениях. На странице сущности доступны дополнительные представления:

Neighborhood — компактное визуальное окружение сущности;
This item links to — исходящие связи;
Referenced by — входящие связи и понятное название отношения, например resolves.

Как проверить результат¶

Результат поиска открывает сущность, источник и содержимое которой соответствуют запросу.
В обоснованном ответе есть подходящие записи в Sources, либо интерфейс явно сообщает о недостатке данных.
После выбора соседнего узла меняются центральная сущность и число её связей.

Частые проблемы¶

Симптом	Вероятная причина	Что сделать
Документ не находится по слову из текста	В запросе меньше трёх символов, слова в тексте стоят не так, как введены, или текст сохранён только что	Ищите одно характерное слово от трёх символов или подождите несколько секунд
Поиск ничего не нашёл	Источник ещё не синхронизирован, запрос слишком узкий или выбран другой проект	Проверьте Activity, проект и попробуйте более общие слова
Нужная сущность пропала из списка	Включён фильтр по типу, теме или локальный для страницы This week	Нажмите Clear и проверьте соседние страницы
Ask Brain сообщает о недостатке данных	Найденные материалы не прошли порог уверенности	Переформулируйте вопрос, синхронизируйте источник или найдите данные вручную
У ответа нет полезного источника	В проекте нет индексированных подтверждений	Не действуйте по ответу; проверьте внешнюю систему и сообщите о пробеле
У сущности нет связей на графе	Сущность загружена, но связь ещё не синхронизирована и не определена	Проверьте linked items и дождитесь нужной синхронизации или skill
Сущность помечена как deleted	Запись удалена во внешней системе	Используйте её только как исторический контекст

Следующий шаг¶

Узнайте, как skills создают результаты, или найдите пробелы closed loop в Reports и Graph Health.

Возврат к списку¶

KB сохраняет в адресе вкладку, фильтры, теги, поиск и пагинацию. Откройте документ и вернитесь через Back to Documents, крошку Documents или браузерную кнопку Назад — выбранное состояние списка восстановится. Для вкладки List действует тот же принцип. Переключение вкладок сохраняет фильтры каждой из них, перезагрузка страницы тоже их не сбрасывает. Набранный, но ещё не отправленный поисковый текст сохраняется при выходе из поля отдельно от запроса, по которому показаны результаты.

При возврате строки перечитываются из API, поэтому правки документа видны сразу. Documents загружает столько страниц, сколько было открыто через Load more (до 100). В той же вкладке браузера после загрузки восстанавливается прокрутка; если строки изменились, положение может немного сместиться. Прямая ссылка на документ без контекста списка возвращает во вкладку Documents. Фильтры адреса привязаны к текущему проекту: ссылка другого проекта не переключает проект и не применяет чужие фильтры.