Firebase Genkit 開發人員工具

Firebase Genkit 提供兩項主要開發人員工具:

  • 用於指令列作業的 Node.js CLI
  • 可選的本機網頁應用程式 (稱為開發人員 UI),可與 Genkit 設定進行介面連線,用於互動式測試和開發

指令列介面 (CLI)

請使用以下方式在專案中安裝 CLI:

npm install -D genkit-cli

CLI 支援各種指令,可協助您使用 Genkit 專案:

  • genkit start -- <command to run your code>:啟動開發人員 UI,並將其連結至執行中的程式碼程序。
  • genkit flow:run <flowName>:執行指定的流程。
  • genkit eval:flow <flowName>:評估特定流程。

如需完整的指令清單,請使用:

npx genkit --help

Genkit 開發人員 UI

Genkit 開發人員 UI 是本機網頁應用程式,可讓您與 Genkit 專案中的模型、流程、提示和其他元素進行互動。

開發人員 UI 可透過附加至執行中的程式碼程序,找出您在程式碼中定義的 Genkit 元件。

如要啟動 UI,請執行下列指令:

npx genkit start -- <command to run your code>

<command to run your code> 會因專案設定和要執行的檔案而異。例如:

# Running a typical development server
npx genkit start -- npm run dev
# Running a TypeScript file directly
npx genkit start -- npx tsx --watch src/index.ts
# Running a JavaScript file directly
npx genkit start -- node --watch src/index.js

加入 --watch 選項後,開發人員 UI 就能偵測並反映程式碼的儲存變更,無須重新啟動程式碼。

執行指令後,您會取得類似以下的輸出內容:

Telemetry API running on http://localhost:4033
Genkit Developer UI: http://localhost:4000

在瀏覽器中開啟 Genkit 開發人員 UI 的本機主機位址,即可查看該畫面。您也可以在 VS Code 簡易瀏覽器中開啟該檔案,並與程式碼一併查看。

或者,您也可以在啟動指令中加入 -o 選項,自動在預設瀏覽器分頁中開啟開發人員 UI。

npx genkit start -o -- <command to run your code>

歡迎使用 Genkit 開發人員 UI

開發人員 UI 會根據您在程式碼中定義的元件,提供 flowpromptmodeltoolretrieverindexerembedderevaluator 的動作執行程式。

以下是貓咪的 GIF 快速導覽。

Genkit Developer UI 的 GIF 總覽

數據分析

Genkit CLI 和開發人員 UI 會使用 Google 的 Cookie 和類似技術,提供服務、提升服務品質及分析使用情形。瞭解詳情

如要停用數據分析,請執行下列指令:

npx genkit config set analyticsOptOut true

您可以執行下列指令查看目前的設定:

npx genkit config get analyticsOptOut