المكوّن الإضافي 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 });

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