Поиск по смыслу для каждого элемента вашего узла
Каждый элемент хранит здесь свои тексты векторами и просит самые близкие к вопросу, на любом языке. Смысл считается на вашем компьютере, без ключа и без интернета.
OpenSource Web4 agent & app starter kitКак идёт поиск
Элемент присылает текст
Он называет коллекцию и текст и отправляет их через элемент базы данных: ту же дверь, которой уже пользуется каждый элемент.
Embeddings считает его
Собственный элемент узла embeddings превращает текст в 384 числа на этом компьютере. Наружу ничего не уходит.
Хранилище его держит
Вектор ложится в свою коллекцию. Текст с тем же id заменяет прежний.
Вопрос его находит
Вопрос считается так же и встречает самые близкие тексты своей коллекции, у каждого своя оценка.
Поиск читает только свою коллекцию и только ближайшие строки, а для них считает точную оценку.
Включён, засыпает только при нехватке памяти
Элемент запускается вместе с узлом. Когда свободной памяти меньше 0,5 ГБ, узел может его усыпить; первый вызов или запись календаря будят его за секунды, а при 1 ГБ свободной памяти он возвращается сам.
Что меняется для вас
| Без него | С векторным хранилищем |
|---|---|
| Поиск находит только точные слова, которые вы набрали | Оно находит тексты, близкие по смыслу, на любом языке |
| Чтобы считать смысл, нужен платный ключ и интернет | Узел считает его сам, на вашем компьютере, без ключа |
| Каждый элемент строил бы свой поиск | Все элементы держат свои коллекции в одном хранилище |
| Ваши тексты лежат на чужом сервере | Они остаются на вашем компьютере, внутри вашего узла |
Чьи это векторы
Главный агент узла
Ищет во всех коллекциях всех элементов и видит, чья каждая находка.
Элемент мамы
Коллекции её элемента, их ищет только ключ её элемента.
Элемент сына
Его коллекции, другой элемент их не видит.
Ваш сайт
Свои коллекции под своими именами.
Каждый элемент открывает хранилище своим ключом, и поиск никогда не переходит в чужую коллекцию.
Элемент называет свои коллекции своими словами: его faq хранится отдельно от faq любого другого элемента, а ответ возвращает его собственные имена. Глубокая память хранит фразы каждого элемента так же.
Поиск без коллекции читает только собственные коллекции элемента. Главный агент ключом узла ищет во всех и видит, чья каждая находка.
Хранилище разделяет двери, а не диск: все коллекции лежат в папке этого элемента на вашем компьютере, и все элементы работают от одного пользователя.
Подключите свой элемент
У каждого элемента узла уже есть адрес базы данных и свой ключ. Сохраните текст и найдите его снова:
const base = process.env.REMOTE_DATA_URL
const headers = { 'X-Element-Key': process.env.ELEMENT_KEY, 'Content-Type': 'application/json' }
await fetch(`${base}/vectors`, { method: 'POST', headers,
body: JSON.stringify({ collection: 'faq', text: 'Delivery takes two days.', refTable: 'faq', refId: '17' }) })
const r = await fetch(`${base}/vectors/search`, { method: 'POST', headers,
body: JSON.stringify({ collection: 'faq', query: 'How long is shipping?', k: 3 }) })
const { results } = await r.json() // [{ id, collection, refTable, refId, text, score }]В ответе самые близкие тексты с оценкой. Тот же id заменяет текст, а DELETE /vectors/:id удаляет его.
Что под капотом
Часть
Что делает
- Индекс
- Таблица sqlite-vec vec0, разделённая по коллекциям: поиск читает ближайшие строки своей коллекции и считает для них точную косинусную оценку
- Смысл
- Собственный элемент узла embeddings: paraphrase-multilingual-MiniLM-L12-v2, 384 числа, на этом компьютере
- Новая модель
- Хранилище, посчитанное прежней моделью, целиком откладывается рядом с новым, больше не читается и никогда не удаляется
- Замок
- Собственный ключ элемента открывает его коллекции; ключ данных узла или сессия с привилегированной ролью открывают все; через туннель Cloudflare каждая дверь отвечает 404
- /vectors/status
- Готово ли хранилище, его модель и размер, вид индекса и сколько в нём векторов
Свой строитель в комплекте
Каждый элемент узла приходит со своим агентом Claude Code и может получить свой Telegram-бот. Нужно что-то поменять в этом элементе — напишите его боту с телефона, и агент обновит логику или дизайн.
Агент работает только в папке своего элемента и не читает весь узел, поэтому каждая правка стоит меньше токенов. Платит за неё ваша подписка Claude Code.
- Бот элемента подключается в ядре, на его странице «Telegram».
- Агент возвращает коммит; вы смотрите его в «Предпросмотре» и принимаете или отклоняете.
- За компьютером терминал агента — в ядре, в разделе «Сборка» этого элемента.
Открытый код
Сделано Fractera для протокола Lagrix и для любого web2-проекта, которому нужен поиск по смыслу. Лицензия MIT, код — github.com/Fractera/fractera-vectors-starter.
Вопросы и ответы
- Нужен ли ключ OpenAI для поиска по смыслу?
- Нет. Смысл считает собственный элемент узла embeddings на этом компьютере, без ключа и без интернета.
- Работает ли поиск между языками?
- Да. Вопрос находит близкие по смыслу тексты, на каком бы языке ни были он и они.
- Как заменить текст?
- Пришлите его снова с тем же id; DELETE /vectors/:id удаляет его.
- Можно ли делать резервные копии?
- Да. Элемент готов к тому, что его агент-программист настроит резервное копирование по расписанию или вручную: скажите об этом агенту элемента в Telegram или в терминале. Сам по себе он копий не делает.