Pinecone
Векторная база Pinecone — эмбеддинги, запись и поиск
Pinecone — векторная база: хранение эмбеддингов и поиск по сходству (семантика, а не точное совпадение слов).
С Pinecone в Pailot вы можете:
- Строить эмбеддинги текста
- Записывать или обновлять текстовые записи в индексе (upsert)
- Искать похожий текст или готовый вектор
- Читать векторы по ID
Нужен ключ API (Application Programming Interface — программный интерфейс) Pinecone и хост индекса. Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Ключ — в переменных окружения рабочего пространства.
Построить эмбеддинги текста через Pinecone.
| Параметр | Тип | Обязательный | Описание |
|---|
model | string | Да | Модель эмбеддингов |
inputs | array | Да | Массив текстов |
apiKey | string | Да | Ключ API Pinecone |
| Параметр | Тип | Описание |
|---|
data | array | Эмбеддинги: значения и тип вектора |
model | string | Модель, которой построены эмбеддинги |
vector_type | string | Тип вектора (dense/sparse) |
usage | object | Статистика расхода |
Вставить или обновить текстовые записи в индексе Pinecone.
| Параметр | Тип | Обязательный | Описание |
|---|
indexHost | string | Да | Полный URL хоста индекса Pinecone |
namespace | string | Да | Пространство имён, куда писать записи |
records | array | Да | Запись или массив записей: _id, text и необязательные метаданные |
apiKey | string | Да | Ключ API Pinecone |
| Параметр | Тип | Описание |
|---|
statusText | string | Статус операции upsert |
Найти похожий текст в индексе Pinecone.
| Параметр | Тип | Обязательный | Описание |
|---|
indexHost | string | Да | Полный URL хоста индекса Pinecone |
namespace | string | Нет | Пространство имён для поиска |
searchQuery | string | Да | Текст запроса |
topK | string | Нет | Сколько результатов вернуть |
fields | array | Нет | Какие поля вернуть |
filter | object | Нет | Фильтр поиска |
rerank | object | Нет | Параметры переранжирования |
apiKey | string | Да | Ключ API Pinecone |
| Параметр | Тип | Описание |
|---|
matches | array | Результаты: ID, оценка сходства и метаданные |
↳ id | string | ID вектора |
↳ score | number | Оценка сходства |
↳ metadata | object | Связанные метаданные |
usage | object | Расход: токены, единицы чтения и переранжирования |
↳ total_tokens | number | Токены на эмбеддинг |
↳ read_units | number | Единицы чтения |
↳ rerank_units | number | Единицы переранжирования |
Найти похожие векторы в индексе Pinecone.
| Параметр | Тип | Обязательный | Описание |
|---|
indexHost | string | Да | Полный URL хоста индекса Pinecone |
namespace | string | Нет | Пространство имён для поиска |
vector | array | Да | Вектор запроса |
topK | number | Нет | Сколько результатов вернуть |
filter | object | Нет | Фильтр поиска |
includeValues | boolean | Нет | Вернуть значения векторов |
includeMetadata | boolean | Нет | Вернуть метаданные |
apiKey | string | Да | Ключ API Pinecone |
| Параметр | Тип | Описание |
|---|
matches | array | Результаты: ID, оценка, значения и метаданные |
namespace | string | Пространство имён, в котором искали |
Прочитать векторы по ID из индекса Pinecone.
| Параметр | Тип | Обязательный | Описание |
|---|
indexHost | string | Да | Полный URL хоста индекса Pinecone |
ids | array | Да | Массив ID векторов |
namespace | string | Нет | Пространство имён |
apiKey | string | Да | Ключ API Pinecone |
| Параметр | Тип | Описание |
|---|
matches | array | Векторы: ID, значения, метаданные и оценка |
↳ id | string | ID вектора |
↳ values | array | Значения вектора |
↳ metadata | object | Связанные метаданные |
↳ score | number | Оценка совпадения (1.0 для точного) |
data | array | Данные вектора: значения и тип |
↳ values | array | Значения вектора |
↳ vector_type | string | Тип вектора (dense/sparse) |
usage | object | Статистика, включая единицы чтения |
↳ total_tokens | number | Единицы чтения |
