Se você usou o Trieve em um aplicativo JavaScript, provavelmente sabe que precisa fazer a maioria das chamadas para o Trieve usando fetch. Embora essa abordagem seja boa, não é a ideal, e queremos fornecer aos usuários uma maneira mais fácil de usar nossas APIs.

Bem, nos bastidores temos trabalhado para tornar o Trieve mais fácil de usar do que nunca em aplicativos JavaScript e isso inclui a criação de um novo SDK JavaScript que torna muito mais simples a integração do Trieve em qualquer aplicativo.

Primeiro, você pode instalar o novo trieve-ts-sdk com seu gerenciador de pacotes favorito:

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

E agora vamos ver como funciona e vamos pegar uma chamada de pesquisa como exemplo.

Antes você precisaria fazer algo como:

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

Embora esse método funcione bem, não é a abordagem mais limpa. Você precisará ter a documentação aberta ao lado do seu editor de código, pois não existem tipos para ajudá-lo a fazer suas chamadas de função. Agora, com o novo SDK você pode chamá-lo assim:

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

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

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

Com a ajuda dos tipos exportados também é muito mais fácil criar uma pesquisa muito mais complicada que inclua, por exemplo, filtros:

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

E não são apenas métodos para pedaços, temos funções para a maior parte de nossa API que você pode usar. Quer transmitir uma conclusão RAG? Conseguimos isso:

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

Também criamos documentos abrangentes para que todas essas funções sejam fáceis de encontrar, quer você use TypeScript ou não.

Ok, a última etapa é instalá-lo e começar a construir a pesquisa e o RAG em seu aplicativo!