本文說明如何使用代理程式環境定義檔，在 Spanner Studio 中建立資料代理程式。資料代理程式會與單一代理程式結構定義檔案建立關聯。
如要瞭解資料代理程式，請參閱「資料代理程式總覽」。事前準備
建立代理程式前，請先完成下列先決條件。
啟用必要服務
為專案啟用下列服務：
準備 Spanner 執行個體
- 請確認 Spanner 執行個體是否可用。詳情請參閱「建立執行個體」。
- 在資料庫中填入使用者想存取的資料和結構定義。
必要角色和權限
- 將 IAM 使用者或服務帳戶新增至叢集。詳情請參閱「套用 IAM 角色」。
- 在專案層級將
spanner.databaseReader角色授予 IAM 使用者。詳情請參閱「為專案新增 IAM 政策繫結」。 - 在專案層級為必要的資料庫授予角色和權限給 IAM 使用者。
建立資料代理程式
如要建立資料代理程式，請按照下列步驟操作：
前往 Google Cloud 控制台的「Spanner」頁面。
從清單中選取執行個體，然後選取資料庫。
在導覽選單中，按一下「Spanner Studio」。
在「Explorer」窗格中，點選「資料代理」旁邊的「查看動作」。
按一下「建立代理程式」。
在「服務專員名稱」中，提供專屬服務專員名稱。代理程式名稱會區分大小寫，且可包含英文字母、數字、連字號和底線。
選用。在「Agent description」(代理程式說明) 中，新增代理程式的說明。
選用。按一下「顯示進階選項」，然後在「選取位置」中，選取代理脈絡資料的儲存區域。
點選「建立」。
建構代理程式環境
建立代理程式後，請按照「使用 Gemini CLI 建構情境」一文中的步驟，建立代理程式情境檔案。接著編輯代理程式，上傳內容檔案。
編輯代理程式
如要編輯資料代理程式，請按照下列步驟操作：
前往 Google Cloud 控制台的「Spanner」頁面。
從清單中選取執行個體，然後選取資料庫。
在導覽選單中，按一下「Spanner Studio」。
在「Explorer」窗格中，點選「資料代理」旁邊的「查看動作」。
按一下「編輯代理程式」。
選用：編輯代理程式說明。
按一下「Upload agent context file」(上傳代理程式結構定義檔案) 專區中的「Browse」(瀏覽)，然後選取代理程式結構定義檔案。
按一下 [儲存]。
刪除資料代理程式
如要刪除資料代理程式，請執行下列步驟：
前往 Google Cloud 控制台的「Spanner」頁面。
從清單中選取執行個體，然後選取資料庫。
在導覽選單中，按一下「Spanner Studio」。
在「Explorer」窗格中，點選「資料代理」旁邊的「查看動作」。
按一下「刪除代理程式」。
在「Delete agent」(刪除服務專員) 確認對話方塊中，輸入服務專員名稱。
按一下「確認」即可刪除代理程式。
後續步驟
- 進一步瞭解資料代理程式。
- 瞭解如何檢查及呼叫資料代理程式。