Read in:
Русский

База знаний организации: личные базы и хранители

Страница описывает один способ разложить знания команды или компании в trip2g: в общее место никто не пишет. Каждый пишет в свою базу, агент-хранитель собирает уровень выше, и у каждой базы на любом уровне один писатель. Прочитав её, вы решите, сколько баз вам нужно и что может читать каждый агент. Страница для того, кто внедряет trip2g больше чем на одного человека. Если вы ведёте одну базу сами, хватит страницы «База знаний команды для агентов».

В статье:

Начните с одного вопроса: кто пишет

Домен здесь — граница авторства. Это не тема и не отдел. Посчитайте писателей, и вы посчитали домены:

Кто пишет Раскладка
Один писатель Одна база. Читателей разводят подграфы
Несколько писателей База на каждого писателя, базы соединяет федерация

Два инструмента отвечают на разные вопросы. Федерация отвечает на вопрос «кто пишет»: базы отдельные, у каждой свой владелец, между ними рёбра. Подграфы отвечают на вопрос «кто читает»: писатель один, читатели разные. Как устроено то и другое, написано на страницах «Разделение контекста», «MCP Federation» и «Подграфы».

Сколько в организации писателей, решают те, кто внедряет, и руководители команд. Один хранитель на всю компанию и хранитель на каждую команду — обе раскладки рабочие.

Правило «один писатель» trip2g сам не проверяет. Вы держите его тем, что выдаёте на базу один доступ на запись. API-ключ пишет только в пределах своих паттернов записи, поэтому ключ хранителя можно ограничить папками, которые он собирает. Как проверяется право на запись, описано на странице updateNotes.

Хранитель

Хранитель — агент, который один пишет в собранную базу. Люди пишут в свои базы. Хранитель читает их и внешние источники и пишет уровень выше: сводки, указатели, глоссарий, справочник.

Открытый рабочий пример — «Звонки в базу знаний». Записи звонков приходят заметками-расшифровками. Дальше роли флита пишут заметки звонков, заметки понятий, дневные заметки и тематические журналы.

Функции вроде HR отдельный агент не нужен. Это раздел в базе хранителя, открытый тем, кто должен его видеть. Личный агент человека читает этот раздел с доступом этого человека.

Что верно при любой доставке

Три вещи остаются верными, каким бы путём знание ни попало к хранителю:

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

Что хранитель видит в личной базе

Владелец личной базы открывает её часть, а не всю. Сейчас есть три вида доступа, и открывают они разное:

Доступ Что читает
Ключ федерации Заметки в подграфах, которые владелец выдал этому ключу
Персональный токен То, что может читать его пользователь: выданные ему подграфы
API-ключ Все заметки базы

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

Что такое «часть» на практике, решают две детали:

  • Заметка без подграфа считается общей. Если у ключа федерации или у пользователя есть хотя бы один выданный подграф, он читает и все заметки без метки subgraph:. В личной базе помечайте то, что личное, а не то, чем делитесь.
  • API-ключ не открывает часть. Через MCP он читает все заметки, как администратор сайта. Хранителю выдайте ключ федерации или учётную запись с доступом к подграфу.

Как личные агенты читают базу организации

Личный агент подключается к базе организации по MCP и читает с доступом своего владельца. Есть две схемы:

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

Во второй схеме у агента одно MCP-подключение, сколько бы баз за ним ни стояло. Почему это важно, объясняет страница «MCP Federation».

Доставку выбираете вы

Как знание попадает из личной базы или внешнего источника к хранителю, trip2g не предписывает. Вот способы, которые работают сейчас; список не полный:

  • Роль флита по изменению. В хабе хранителя меняется заметка, и запускается роль. См. «Флит».
  • Роль флита по расписанию. Код-роль забирает данные из внешнего API и пишет заметки. Так пайплайн звонков получает расшифровки.
  • Руками. Человек переносит заметку в базу хранителя.
  • Внешний агент. Агент вроде Claude Code читает одну базу по MCP и пишет в другую через updateNotes или CLI для синхронизации.

Одно ограничение стоит учесть заранее: роль флита читает и пишет заметки того хаба, к которому подключён её флит. У LLM-роли нет инструмента, который ищет в соседней базе по федерации. Заметки из другой базы попадают к хранителю на флите одним из остальных способов, либо флит запускают рядом с той базой.

Чего это стоит

  • Собранный уровень отстаёт от источников. Он свеж ровно настолько, насколько свеж последний запуск хранителя.
  • В личной базе лежит личное. Границу проводят намеренно: по заметке или по папке. Заметку без метки читает любой выданный ключ.
  • Хаб записывает, кто написал, а не откуда взято знание. У каждой версии заметки хранятся пользователь, API-ключ и клиент, которые её сохранили, а версия, записанная запуском флита, привязана к доставке, которая её произвела. Шаблон может вывести автора текущей версии через LastEditedBy(); это данные только для администратора. Из какой исходной заметки собрана заметка, не записывает никто. Эту ссылку должна писать сама роль хранителя.
  • Правка занимает два шага. Читатель сообщает владельцу источника, владелец исправляет. Заметку, которая перед глазами, никто не правит.

См. также