AI 共同建構工具：Arc

AI Co-Builder：Arc (或簡稱 Arc) 是直接在 CX Agent Studio 建構的程式碼代理。具備建構代理應用程式所需的所有技能：

• 多代理架構
• 操作說明
• 工具實作 (例如 OpenAPI 工具和 Python 工具)
• 回呼實作
• 防護機制
• 版本

如要使用 Arc，請按一下代理建構工具頂端的「Arc」圖示，然後向代理提供提示。

上傳檔案

您可以在訊息中附加檔案，為 Arc 提供更多背景資訊，例如產品需求文件、樣本資料檔案、需要呼叫的外部服務詳細資料，或現有設定的封存檔。

Arc 會根據檔案格式，以三種方式處理檔案：

檔案限制如下：

• 每則訊息最多 5 個檔案
• 檔案大小上限為 20 MB
• ZIP 封存檔大小上限為 500 MB

檔案儲存空間

上傳的檔案會儲存在專案的 Cloud Storage bucket 中，前置字串為 agent-assist-uploads/。這個 bucket 位於 Cloud Storage 位置，與代理應用程式的位置相符，且該位置的所有代理應用程式都會共用這個 bucket：

如果 bucket 不存在，控制台會在您以登入使用者身分上傳檔案時建立 bucket，但您必須具備 storage.buckets.create 權限；Customer Engagement Suite 服務代理會在 Arc 為對話生成檔案時建立 bucket。必須具備 storage.objects.create 權限，才能上傳檔案。

Arc 會使用下列設定建立值區：

• 生命週期規則會在檔案上傳 63 天後自動刪除檔案。
• 已啟用統一 bucket 層級存取權和禁止公開存取功能。
• 標籤 goog-drz-ces-app-id 和 goog-drz-ces-app-location 會保留導致 Arc 建立 bucket 的代理程式應用程式 ID 和位置。

如果專案中已有 bucket，Arc 會直接使用，並套用其生命週期政策。Arc 不會檢查或變更其位置、標籤或預設金鑰。

組織政策和加密金鑰

如果您使用 constraints/gcp.resourceLocations 組織政策限制條件限制資源位置，政策必須允許 bucket 的位置，例如 EU 多區域的值組 in:eu-locations。否則 Arc 無法建立值區，上傳作業也會失敗。

如果專案使用客戶自行管理的加密金鑰 (CMEK)，Arc 會使用代理應用程式位置的金鑰做為預設金鑰來建立 bucket，如果無法使用該金鑰，則不會建立 bucket。如要允許 Cloud Storage 使用金鑰，請按照下列步驟操作：

• 在與 bucket 位置相符的金鑰位置建立金鑰：US 多區域為 us，EU 多區域為 europe。

• 將金鑰的 roles/cloudkms.cryptoKeyEncrypterDecrypter 角色授予專案的 Cloud Storage 服務代理 service-PROJECT_NUMBER@gs-project-accounts.iam.gserviceaccount.com。下列指令會建立服務代理 (如果尚未建立)，並授予角色：

  gcloud storage service-agent --project=PROJECT_ID --authorize-cmek=KEY_RESOURCE
  

  將 PROJECT_ID 替換為專案 ID，並將 KEY_RESOURCE 替換為金鑰的完整資源名稱。

預先建立 bucket

您可以自行建立 bucket，例如 Arc 使用者沒有 storage.buckets.create 權限時。請使用本節前述表格中的名稱和位置，並為 bucket 指定與 Arc 相同的設定。首先，將下列生命週期規則儲存至名為 lifecycle-63d.json 的檔案：

{"rule": [{"action": {"type": "Delete"}, "condition": {"age": 63}}]}

接著建立 bucket，並新增標籤和生命週期規則：

gcloud storage buckets create gs://PROJECT_ID-agent-assist-artifacts-LOCATION \
    --project=PROJECT_ID --location=LOCATION --default-storage-class=STANDARD \
    --uniform-bucket-level-access --public-access-prevention
gcloud storage buckets update gs://PROJECT_ID-agent-assist-artifacts-LOCATION \
    --update-labels=goog-drz-ces-app-id=APP_ID,goog-drz-ces-app-location=LOCATION \
    --lifecycle-file=lifecycle-63d.json

如果專案使用 CMEK，請先按照上一節所述，授予服務代理金鑰存取權。接著，在 create 指令中加入 --default-encryption-key 旗標，將金鑰設為 bucket 的預設金鑰：

gcloud storage buckets create gs://PROJECT_ID-agent-assist-artifacts-LOCATION \
    --project=PROJECT_ID --location=LOCATION --default-storage-class=STANDARD \
    --uniform-bucket-level-access --public-access-prevention \
    --default-encryption-key=KEY_RESOURCE

將 PROJECT_ID 替換為專案 ID、LOCATION 替換為 us 或 eu、APP_ID 替換為該位置中任一代理應用程式的 ID，以及 KEY_RESOURCE 替換為金鑰的完整資源名稱。

在位置感知儲存空間推出前上傳的檔案

Arc 於 YEAR 年 MONTH 開始將檔案儲存在代理程式應用程式的位置。如果是在這之後設定 Arc，可以略過本節。

在 Arc 將檔案儲存在代理應用程式的位置之前，會將每個上傳的檔案保存在單一 bucket PROJECT_ID-agent-assist-artifacts 中，位於 US 多區域，適用於每個位置的代理應用程式。該 bucket 的名稱沒有位置後置字串。

如要區分檔案，請查看存放檔案的 bucket：

• 在位置感知儲存空間推出前上傳的檔案，會存放在 PROJECT_ID-agent-assist-artifacts bucket。
• 之後上傳的檔案會儲存在代理應用程式位置的 bucket (PROJECT_ID-agent-assist-artifacts-LOCATION)，如「檔案儲存空間」表格所示。Arc 在您首次上傳後顯示的通知會列出 bucket 名稱。傳送郵件前，您可以將滑鼠游標懸停在附加檔案上，查看檔案的儲存位置。

在位置感知儲存空間推出前開始的對話，會繼續將 Arc 生成的檔案儲存在 PROJECT_ID-agent-assist-artifacts bucket。Arc 不會變更 bucket 或移動檔案，因此生命週期規則仍會在檔案上傳 75 天後刪除檔案，且 bucket 在對話停止使用後會自動清空。無論附加到哪個對話，附加的檔案都會傳送至代理應用程式位置的 bucket。

如要延長上傳至這些對話的檔案保留時間，請將檔案複製到不會自動刪除檔案的自有 bucket：

gcloud storage cp -r gs://PROJECT_ID-agent-assist-artifacts/agent-assist-uploads \
    gs://ARCHIVE_BUCKET/

將 ARCHIVE_BUCKET 替換為符合需求的位置中的 bucket。副本僅供封存，這些對話會繼續從 PROJECT_ID-agent-assist-artifacts bucket 讀取。

在最後一次使用這些對話後，經過 60 天，刪除 PROJECT_ID-agent-assist-artifacts bucket；Arc 會在最後一次活動後 60 天刪除對話。如要刪除 bucket 和當中的檔案，請執行下列指令：

gcloud storage rm -r gs://PROJECT_ID-agent-assist-artifacts

思維鏈

處理時，Arc 會分段顯示思維鏈。您可以展開任一區段，查看代理推論的詳細資料。

選取情境

在提示詞對話方塊中，按一下「選取背景資訊」按鈕，然後選取要讓 Arc 用於提示詞的其他背景資訊項目。例如，您可以點選這個按鈕，接著在代理建構工具中點選特定代理，然後要求 Arc 為您說明該代理。