Русский
База знаний организации: личные базы и хранители
Страница описывает один способ разложить знания команды или компании в trip2g: в общее место никто не пишет. Каждый пишет в свою базу, агент-хранитель собирает уровень выше, и у каждой базы на любом уровне один писатель. Прочитав её, вы решите, сколько баз вам нужно и что может читать каждый агент. Страница для того, кто внедряет trip2g больше чем на одного человека. Если вы ведёте одну базу сами, хватит страницы «База знаний команды для агентов».
В статье:
- Начните с одного вопроса: кто пишет
- Хранитель
- Что верно при любой доставке
- Что хранитель видит в личной базе
- Как личные агенты читают базу организации
- Доставку выбираете вы
- Чего это стоит
Начните с одного вопроса: кто пишет
Домен здесь — граница авторства. Это не тема и не отдел. Посчитайте писателей, и вы посчитали домены:
| Кто пишет | Раскладка |
|---|---|
| Один писатель | Одна база. Читателей разводят подграфы |
| Несколько писателей | База на каждого писателя, базы соединяет федерация |
Два инструмента отвечают на разные вопросы. Федерация отвечает на вопрос «кто пишет»: базы отдельные, у каждой свой владелец, между ними рёбра. Подграфы отвечают на вопрос «кто читает»: писатель один, читатели разные. Как устроено то и другое, написано на страницах «Разделение контекста», «MCP Federation» и «Подграфы».
Сколько в организации писателей, решают те, кто внедряет, и руководители команд. Один хранитель на всю компанию и хранитель на каждую команду — обе раскладки рабочие.
Правило «один писатель» trip2g сам не проверяет. Вы держите его тем, что выдаёте на базу один доступ на запись. API-ключ пишет только в пределах своих паттернов записи, поэтому ключ хранителя можно ограничить папками, которые он собирает. Как проверяется право на запись, описано на странице updateNotes.
Хранитель
Хранитель — агент, который один пишет в собранную базу. Люди пишут в свои базы. Хранитель читает их и внешние источники и пишет уровень выше: сводки, указатели, глоссарий, справочник.
Открытый рабочий пример — «Звонки в базу знаний». Записи звонков приходят заметками-расшифровками. Дальше роли флита пишут заметки звонков, заметки понятий, дневные заметки и тематические журналы.
Функции вроде HR отдельный агент не нужен. Это раздел в базе хранителя, открытый тем, кто должен его видеть. Личный агент человека читает этот раздел с доступом этого человека.
Что верно при любой доставке
Три вещи остаются верными, каким бы путём знание ни попало к хранителю:
- В собранную базу пишет только хранитель. Люди её не редактируют.
- У собранной заметки виден источник и его владелец. В пайплайне звонков каждая заметка звонка ссылается на исходную расшифровку, а у каждой цитаты стоит интервал времени.
- Правку вносят в источник. Потом хранитель пересобирает. Правку, сделанную руками в собранной заметке, следующий запуск может перезаписать, и собранная база становится вторым местом, куда пишут люди.
Что хранитель видит в личной базе
Владелец личной базы открывает её часть, а не всю. Сейчас есть три вида доступа, и открывают они разное:
| Доступ | Что читает |
|---|---|
| Ключ федерации | Заметки в подграфах, которые владелец выдал этому ключу |
| Персональный токен | То, что может читать его пользователь: выданные ему подграфы |
| API-ключ | Все заметки базы |
Новый входящий ключ федерации не видит ничего. Подграфы для него владелец выбирает в админке, и каждое направление выдаётся отдельно.
Что такое «часть» на практике, решают две детали:
- Заметка без подграфа считается общей. Если у ключа федерации или у пользователя есть хотя бы один выданный подграф, он читает и все заметки без метки
subgraph:. В личной базе помечайте то, что личное, а не то, чем делитесь. - API-ключ не открывает часть. Через MCP он читает все заметки, как администратор сайта. Хранителю выдайте ключ федерации или учётную запись с доступом к подграфу.
Как личные агенты читают базу организации
Личный агент подключается к базе организации по MCP и читает с доступом своего владельца. Есть две схемы:
- Персональный токен. У владельца есть учётная запись в базе организации. Токен наследует её доступ к подграфам и ничего к нему не добавляет.
- Ребро от собственного хаба владельца. Агент говорит с базой своего владельца. В ней лежит ключ федерации к базе организации, и агент достаёт её через
federated_searchиfederated_note_html.
Во второй схеме у агента одно MCP-подключение, сколько бы баз за ним ни стояло. Почему это важно, объясняет страница «MCP Federation».
Доставку выбираете вы
Как знание попадает из личной базы или внешнего источника к хранителю, trip2g не предписывает. Вот способы, которые работают сейчас; список не полный:
- Роль флита по изменению. В хабе хранителя меняется заметка, и запускается роль. См. «Флит».
- Роль флита по расписанию. Код-роль забирает данные из внешнего API и пишет заметки. Так пайплайн звонков получает расшифровки.
- Руками. Человек переносит заметку в базу хранителя.
- Внешний агент. Агент вроде Claude Code читает одну базу по MCP и пишет в другую через updateNotes или CLI для синхронизации.
Одно ограничение стоит учесть заранее: роль флита читает и пишет заметки того хаба, к которому подключён её флит. У LLM-роли нет инструмента, который ищет в соседней базе по федерации. Заметки из другой базы попадают к хранителю на флите одним из остальных способов, либо флит запускают рядом с той базой.
Чего это стоит
- Собранный уровень отстаёт от источников. Он свеж ровно настолько, насколько свеж последний запуск хранителя.
- В личной базе лежит личное. Границу проводят намеренно: по заметке или по папке. Заметку без метки читает любой выданный ключ.
- Хаб записывает, кто написал, а не откуда взято знание. У каждой версии заметки хранятся пользователь, API-ключ и клиент, которые её сохранили, а версия, записанная запуском флита, привязана к доставке, которая её произвела. Шаблон может вывести автора текущей версии через
LastEditedBy(); это данные только для администратора. Из какой исходной заметки собрана заметка, не записывает никто. Эту ссылку должна писать сама роль хранителя. - Правка занимает два шага. Читатель сообщает владельцу источника, владелец исправляет. Заметку, которая перед глазами, никто не правит.
См. также
- Разделение контекста: рёбра и подграфы на примере десяти баз
- MCP Federation: ключи, KB-заметки и области доступа
- Подграфы: кто читает заметку
- Флит: агенты, описанные заметками
- Звонки в базу знаний: хранитель, собранный из ролей флита