Canali di stabilità dell'API

A partire dalla versione 1.0, Genkit è considerato disponibile pubblicamente (GA) e pronto per l'uso in produzione. Genkit segue il controllo delle versioni semantico con modifiche che causano interruzioni all'API stabile che si verificano solo nelle release delle versioni principali.

Per raccogliere feedback su potenziali nuove API e implementare rapidamente nuove funzionalità, Genkit offre un punto di contatto beta che include API che non sono ancora state dichiarate stabili. Il canale beta potrebbe includere modifiche che comportano interruzioni nelle release delle versioni minor.

Utilizzare il canale stabile

Per utilizzare il canale stabile di Genkit, importa dal punto di contatto "genkit" "genkit" standard:

import { genkit, z } from "genkit";

const ai = genkit({plugins: [...]});
console.log(ai.apiStability); // "stable"

Quando utilizzi il canale stabile, ti consigliamo di utilizzare la stringa di dipendenza ^X.Y.Z standard in package.json. Si tratta del valore predefinito utilizzato quando esegui npm install genkit.

Utilizzare il canale beta

Per utilizzare il canale beta di Genkit, importa dal punto di contatto "genkit/beta":

import { genkit, z } from "genkit/beta";

const ai = genkit({plugins: [...]});
console.log(ai.apiStability); // "beta"

// now beta features are available

Quando utilizzi il canale beta, ti consigliamo di utilizzare la stringa di dipendenza ~X.Y.Z in package.json. ~ consentirà le nuove versioni delle patch, ma non effettuerà automaticamente l'upgrade alle nuove versioni minori che potrebbero includere modifiche che comportano interruzioni per le funzionalità beta. Se inizi a utilizzare le funzionalità beta di Genkit, puoi modificare la stringa di dipendenza esistente impostando^ su ~.

Funzionalità attuali in versione beta

  • Chat/Sessioni: una funzionalità ai.chat() di conversazione di prima classe insieme a sessioni permanenti che memorizzano sia la cronologia della conversazione sia un oggetto stato arbitrario.
  • Interruzioni: strumenti speciali che possono mettere in pausa la generazione per il feedback human-in-the-loop, l'elaborazione out-of-band e altro ancora.