المكوّن الإضافي Pinecone

يوفّر المكوّن الإضافي Pinecone عمليات تنفيذ المفهرس والاسترداد التي تستخدم قاعدة بيانات Pinecone لمتّجهات السحابة.

تثبيت

npm i --save genkitx-pinecone

الإعداد

لاستخدام هذا المكوّن الإضافي، حدِّده عند استدعاء configureGenkit():

import { pinecone } from 'genkitx-pinecone';

export default configureGenkit({
  plugins: [
    pinecone([
      {
        indexId: 'bob-facts',
        embedder: textEmbeddingGecko,
      },
    ]),
  ],
  // ...
});

عليك تحديد رقم تعريف فهرس Pinecone ونموذج التضمين الذي تريد استخدامه.

بالإضافة إلى ذلك، يجب عليك إعداد Genkit باستخدام مفتاح واجهة برمجة تطبيقات Pinecone. هناك طريقتان للقيام بذلك:

• اضبط متغيّر بيئة PINECONE_API_KEY.

• حدِّد هذا الخيار في المَعلمة الاختيارية clientParams:

  clientParams: {
    apiKey: ...,
  }
  

  قيمة هذه المعلَمة هي كائن PineconeConfiguration يتم تمريره إلى عميل Pinecone، ويمكنك استخدامه لتمرير أي معلَمة يتوافق معها العميل.

الاستخدام

قم باستيراد مراجع أداة استرداد وفهرسة مثل ما يلي:

import { pineconeRetrieverRef } from 'genkitx-pinecone';
import { pineconeIndexerRef } from 'genkitx-pinecone';

بعد ذلك، انقل المراجع إلى retrieve() وindex():

// To use the index you configured when you loaded the plugin:
let docs = await retrieve({ retriever: pineconeRetrieverRef, query });

// To specify an index:
export const bobFactsRetriever = pineconeRetrieverRef({
  indexId: 'bob-facts',
});
docs = await retrieve({ retriever: bobFactsRetriever, query });

// To use the index you configured when you loaded the plugin:
await index({ indexer: pineconeIndexerRef, documents });

// To specify an index:
export const bobFactsIndexer = pineconeIndexerRef({
  indexId: 'bob-facts',
});
await index({ indexer: bobFactsIndexer, documents });

يمكنك الاطّلاع على صفحة إنشاء البيانات المعززة باسترداد لإجراء مناقشة عامة حول أدوات الفهرسة وبرامج استرداد البيانات.