הפלאגין של Pinecone מספק הטמעות של מפתחות אינדקס ומאגרי אחזור שמשתמשים במסד הנתונים של וקטורים בענן של Pinecone.
התקנה
npm i --save genkitx-pinecone
תצורה
כדי להשתמש בפלאגין הזה, צריך לציין אותו כשמאתחלים את Genkit:
import { genkit } from 'genkit';
import { pinecone } from 'genkitx-pinecone';
const ai = genkit({
plugins: [
pinecone([
{
indexId: 'bob-facts',
embedder: textEmbedding004,
},
]),
],
});
צריך לציין מזהה של אינדקס Pinecone ומודל הטמעה שבו רוצים להשתמש.
בנוסף, צריך להגדיר את Genkit עם מפתח ה-API של Pinecone. יש שתי דרכים לעשות זאת:
- מגדירים את משתנה הסביבה
PINECONE_API_KEY
. מציינים אותו בפרמטר האופציונלי
clientParams
:clientParams: { apiKey: ..., }
הערך של הפרמטר הזה הוא אובייקט
PineconeConfiguration
, שמוענק ללקוח Pinecone. אפשר להשתמש בו כדי להעביר כל פרמטר שהלקוח תומך בו.
שימוש
מייבאים את ההפניות של האחזור והאינדקס באופן הבא:
import { pineconeRetrieverRef } from 'genkitx-pinecone';
import { pineconeIndexerRef } from 'genkitx-pinecone';
לאחר מכן, משתמשים בהפניות האלה עם ai.retrieve()
ו-ai.index()
:
// To use the index you configured when you loaded the plugin:
let docs = await ai.retrieve({ retriever: pineconeRetrieverRef, query });
// To specify an index:
export const bobFactsRetriever = pineconeRetrieverRef({
indexId: 'bob-facts',
});
docs = await ai.retrieve({ retriever: bobFactsRetriever, query });
// To use the index you configured when you loaded the plugin:
await ai.index({ indexer: pineconeIndexerRef, documents });
// To specify an index:
export const bobFactsIndexer = pineconeIndexerRef({
indexId: 'bob-facts',
});
await ai.index({ indexer: bobFactsIndexer, documents });
בדף יצירה עם שיפור לאחזור מפורטת סקירה כללית על הוספת נתונים לאינדקס ועל אחזור נתונים.