הפלאגין של Pinecone

הפלאגין של 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 });

בדף יצירה עם שיפור לאחזור מפורטת סקירה כללית על הוספת נתונים לאינדקס ועל אחזור נתונים.