Variables

變數可用於儲存及擷取執行階段的對話資料。這樣代理就能在對話過程中記住資訊,提供更符合脈絡的互動。

變數資料

變數包含下列資料:

  • 名稱:使用蛇形命名法的變數名稱
  • 類型:變數類型:
    • 文字:字串值
    • 數字:數值
    • 是/否:布林值
    • 自訂物件:您提供物件的結構定義
    • 清單:變數清單。以半形逗號分隔列出值。
  • 預設值:變數的預設值
  • 說明:變數的選填說明

指令中的變數參照

如要在指令中依名稱參照變數,請使用大括號:{variable_name}

解析變數

為模型產生提示時,CX Agent Studio 會將變數參照替換為實際的執行階段值。

更新變數值

代理程式本身無法更新變數值,但工具和回呼可以更新變數值。

代理程式變數會使用 ADK 環境狀態,可用於更新變數。您可以在 Python 工具程式碼中使用名為 context 的全域變數。舉例來說,您可以在 Python 工具中使用下列陳述式,透過 ADK 功能更新變數:

context.state["variable_name"] = value