إذا كنت قد استخدمت Trieve في تطبيق JavaScript، فمن المحتمل أنك تعلم أنك بحاجة إلى إجراء معظم مكالماتك إلى Trieve باستخدام الجلب. على الرغم من أن هذا الأسلوب جيد، إلا أنه ليس مثاليًا، ونريد أن نوفر للمستخدمين طريقة أسهل لاستخدام واجهات برمجة التطبيقات الخاصة بنا.

حسنًا، كنا نعمل خلف الكواليس على جعل استخدام Trieve أسهل من أي وقت مضى في تطبيقات JavaScript، ويتضمن ذلك إنشاء JavaScript SDK جديد يجعل دمج Trieve في أي تطبيق أكثر سهولة.

أول شيء أولاً، يمكنك تثبيت trieve-ts-sdk الجديد باستخدام مدير الحزم المفضل لديك:

yarn add trieve-ts-sdk
# or
npm install trieve-ts-sdk
# or
pnpm install trieve-ts-sdk

والآن دعونا نرى كيف يعمل، ولنأخذ مكالمة بحث كمثال.

قبل أن تحتاج إلى القيام بشيء مثل:

fetch('https://api.trieve.ai/api/chunk/search', {
  method: 'POST',
  headers: {
    'TR-Dataset': 'dc6f3b0d-cf21-412b-9d16-fb7ade090365',
    Authorization: 'tr-********************************',
  },
  body: JSON.stringify({
    query: 'Sonic the Hedgehog',
  }),
});

على الرغم من أن هذه الطريقة تعمل بشكل جيد، إلا أنها ليست الطريقة الأنظف. ستحتاج إلى فتح الوثائق بجوار محرر التعليمات البرمجية الخاص بك، حيث لا توجد أنواع تساعدك في إجراء استدعاءات الوظائف الخاصة بك. الآن، مع SDK الجديد، يمكنك تسميتها كما يلي:

import { TrieveSDK } from 'trieve-ts-sdk';

export const trieve = new TrieveSDK({
  apiKey: '',
  datasetId: '',
});

const results = await trieve.search({
  query: 'Sonic the Hedgehog',
});

بمساعدة الأنواع المصدرة، من الأسهل أيضًا إنشاء بحث أكثر تعقيدًا يتضمن، على سبيل المثال، عوامل التصفية:

import { TrieveSDK } from 'trieve-ts-sdk';

const results = await trieve.search({
  query: 'Sonic the Hedgehog',
  search_type: 'hybrid',
  filters: {
    must: [
      {
        field: 'meta.rating',
        range: {
          gt: 80,
        },
      },
    ],
    must_not: [
      {
        field: 'metadata.console',
        match: ['gba', 'wii'],
      },
    ],
  },
});

ولا يقتصر الأمر على طرق القطع، فلدينا وظائف لمعظم واجهات برمجة التطبيقات الخاصة بنا والتي يمكنك استخدامها، هل ترغب في بث إكمال RAG؟ لقد حصلنا على ذلك:

const reader = await trieve.createMessageReader({
  topic_id: id || currentTopic,
  new_message_content: currentQuestion,
  llm_options: {
    completion_first: true,
  },
});
handleReader(reader);

لقد أنشأنا أيضًا مستندات شاملة بحيث يسهل عليك العثور على جميع هذه الوظائف سواء كنت تستخدم TypeScript أم لا.

حسنًا، الخطوة الأخيرة هي تثبيته والانتقال إلى إنشاء بحث وRAG في تطبيقك!