Si vous avez utilisé Trieve dans une application JavaScript, vous savez probablement que vous devez effectuer la plupart de vos appels vers Trieve en utilisant fetch. Bien que cette approche soit bonne, elle n'est pas idéale et nous souhaitons offrir aux utilisateurs un moyen plus simple d'utiliser nos API.

Eh bien, en coulisses, nous avons travaillé pour rendre Trieve plus facile à utiliser que jamais dans les applications JavaScript, ce qui inclut la création d'un nouveau SDK JavaScript qui simplifie grandement l'intégration de Trieve dans n'importe quelle application.

Tout d'abord, vous pouvez installer le nouveau trieve-ts-sdk avec votre gestionnaire de paquets préféré :

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

Voyons maintenant comment cela fonctionne, et prenons un appel de recherche comme exemple.

Avant, vous devrez faire quelque chose comme :

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',
  }),
});

Bien que cette méthode fonctionne bien, ce n'est pas l'approche la plus propre. Vous devrez ouvrir la documentation à côté de votre éditeur de code, car il n'existe aucun type pour vous aider à effectuer vos appels de fonction. Désormais, avec le nouveau SDK, vous pouvez l'appeler ainsi :

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

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

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

Avec l'aide des types exportés, il est également beaucoup plus facile de créer une recherche beaucoup plus complexe qui inclut, par exemple, des filtres :

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'],
      },
    ],
  },
});

Et il ne s'agit pas seulement de méthodes pour les morceaux, nous avons des fonctions pour la plupart de nos API que vous pouvez utiliser, vous souhaitez diffuser une complétion RAG ? Nous avons compris :

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

Nous avons également créé des documents complets afin que vous puissiez facilement trouver toutes ces fonctions, que vous utilisiez TypeScript ou non.

D'accord, la dernière étape consiste à l'installer et à créer la recherche et le RAG dans votre application !