API 穩定性管道

自 1.0 版起,Genkit 已視為正式發行版 (GA),可供正式環境使用。Genkit 遵循語意化版本編號,只有在主要版本更新時,才會對穩定版 API 進行破壞性變更。

為了收集潛在新 API 的意見回饋,並快速推出新功能,Genkit 提供Beta 版入口,其中包含尚未宣告為穩定版的 API。Beta 版可能包含次要版本發布版本的破壞性變更。

使用穩定版

如要使用 Genkit 的穩定版管道,請從標準 "genkit" "genkit" 進入點匯入:

import { genkit, z } from "genkit";

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

使用穩定版時,建議您在 package.json 中使用標準 ^X.Y.Z 依附元件字串。這是執行 npm install genkit 時使用的預設值。

使用 Beta 版

如要使用 Genkit 的 Beta 版,請從 "genkit/beta" 進入點匯入:

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

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

// now beta features are available

使用 Beta 版時,建議您在 package.json 中使用 ~X.Y.Z 依附元件字串。~ 會允許新的修補程式版本,但不會自動升級至可能會對 Beta 版功能造成重大變更的新次要版本。如果您開始使用 Genkit 的 Beta 版功能,可以將 ^ 變更為 ~,藉此修改現有的依附元件字串。

Beta 版目前的功能

  • 即時通訊/工作階段一流的對話 ai.chat() 功能,以及可儲存對話記錄和任意狀態物件的持續性工作階段。
  • 中斷可暫停生成作業的特殊工具,可用於人機互動回饋、離帶處理等。