為您的應用程式建立代理程式 - Amazon Bedrock

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

為您的應用程式建立代理程式

若要使用 Amazon 基岩建立代理程式，請設定下列元件：

  • 代理程式的組態，定義代理程式的用途，並指出它用來產生提示和回應的基礎模型 (FM)。

  • 至少下列其中一項：

    • 動作群組，可定義代理程式設計要執行的動作。

    • 資料來源的知識庫，可透過允許搜尋和查詢來增強代理程式的生成能力。

您可以最低限度地建立只有名稱的代理程式。若要準備代理程式以便測試或部署代理程式，您必須以最低限度的方式設定下列元件：

組態 描述
代理資源角色 具有呼叫代理程式API作業之權限ARN的服務角色
基礎型號 (FM) 用於呼叫代理程式以執行協調作業的 FM
指示 自然語言描述代理程式應該做什麼，以及它應該如何與使用者互動

您也應該為代理程式設定至少一個動作群組或知識庫。如果您準備沒有動作群組或知識庫的代理程式，它只會根據 FM 和指示以及基本提示範本傳回回應。

若要瞭解如何建立代理程式，請選取與您選擇的方法相對應的索引標籤，然後依照下列步驟執行。

Console
建立代理程式

  1. 登入 AWS Management Console 使用具有 Amazon 基岩許可的IAM角色，並在以下位置打開 Amazon 基岩控制台。https://console.aws.amazon.com/bedrock/

  2. 從左側導覽窗格中選取「代理程式」。

  3. 在「代理程式」段落中，選擇建立代理程式

  4. (選擇性) 變更代理程式自動產生的「名稱」，並提供選擇性的「說明」。

  5. 選擇 Create (建立)。您的代理程式已建立，您將會被帶到新建立的代理程式的 A gent Builder，您可以在其中設定代理程式。

  6. 您可以繼續執行下列程序來設定代理程式，或稍後返回代理程式產生器。

設定您的代理程式

  1. 如果您尚未在代理程式產生器中，請執行下列動作：

    1. 登入 AWS Management Console 使用具有 Amazon 基岩許可的IAM角色，並在以下位置打開 Amazon 基岩控制台。https://console.aws.amazon.com/bedrock/

    2. 從左側導覽窗格中選取「代理程式」。然後，在「代理程式」區段中選擇代理程式。

    3. 在 [代理程式產生器] 中選擇

  2. 您可以在「代理程式詳細資訊」段落中設定下列組態：

    1. 編輯代理程式名稱或代理程式說明。

    2. 針對代理程式資源角色，選取下列其中一個選項：

      • 建立和使用新的服務角色 — 讓 Amazon 基岩建立服務角色，並代表您設定所需的許可。

      • 使用現有的服務角色 — 使用您先前設定的自訂角色。

    3. 針對 「選取型號」，選取要在協調流程期間呼叫代理程式的 FM。

    4. 在代理程式的指示中，輸入詳細資料以告知代理程式應該執行什麼動作，以及應該如何與使用者互動。這些指示會取代協調流程提示範本中的 $ 指示 $ 預留位置。以下是指令的一個例子：

      You are an office assistant in an insurance agency. You are friendly and polite. You help with managing insurance claims and coordinating pending paperwork.

    5. 如果您展開其他設定，您可以修改下列模型組態：

      使用者輸入 — 選擇是否允許代理程式在沒有足夠資訊的情況下向使用者要求更多資訊。

      • 如果您選擇 [已啟用]，代理程式會傳回觀察重新提示使用者以取得更多資訊 (如果它需要API在動作群組中呼叫，但沒有足夠的資訊來完成要求)。API

      • 如果您選擇 [停用]，代理程式不會要求使用者提供其他詳細資訊，而是通知使用者沒有足夠的資訊來完成工作。

      • KMS金鑰選取 — (選用) 依預設，會使用AWS受管理金鑰AWS加密代理程式資源。若要使用您自己的客戶管理金鑰加密您的代理程式，請在KMS金鑰選擇區段中，選取 [自訂加密設定 (進階)]。若要建立新的金鑰，請選取 [建立AWSKMS金鑰]，然後重新整理此視窗。若要使用現有的金鑰，請為 [選擇金鑰] 選取AWSKMS金鑰。

      • 閒置工作階段逾時 — 依預設，如果使用者在使用 Amazon Bdrock 代理程式的工作階段中 30 分鐘沒有回應，則代理程式將不再維護對話歷史記錄。對話歷程記錄可用來恢復互動，也可以使用對話中的內容來擴增回應。若要變更此預設時間長度，請在「階段作業逾時」欄位中輸入數字，然後選擇時間單位。

    6. 對於 [IAM權限] 區段，對於 [代理程式] 資源角色，請選擇服務角色。若要讓 Amazon 基岩代表您建立服務角色，請選擇建立並使用新的服務角色。若要使用先前建立的自訂角色，請選擇 [使用現有的服務角色]。

      注意

      Amazon 基岩為您建立的服務角色不包含預覽版功能的許可。若要使用這些功能，請將正確的權限附加至服務角色。

    7. (選擇性) 依預設， AWS 加密代理程式資源 AWS 受管金鑰。 若要使用您自己的客戶管理金鑰加密您的代理程式，請在KMS金鑰選擇區段中，選取 [自訂加密設定 (進階)]。若要建立新金鑰，請選取 [建立金鑰] AWS KMS 鍵，然後重新整理此視窗。若要使用現有的金鑰，請為 [選擇] 選取金鑰 AWS KMS 索引鍵。

    8. (選擇性) 若要將標籤與此代理程式產生關聯，請在「標籤-選用」區段中，選擇「新增標記」並提供金鑰-值配對。

    9. 完成代理程式組態設定後，請選取 [下一步]。

  3. 在 [動作群組] 區段中，您可以選擇 [新增]，將動作群組新增至您的代理程式。如需有關設定動作群組的詳細資訊，請參閱使用動作群組定義代理程式要執行的動作。若要瞭解如何將動作群組新增至代理程式，請參閱在 Amazon 基岩中將動作群組新增至您的代理程式。

  4. 在 [知識庫] 區段中，您可以選擇 [新增]，將知識群組與您的代理程式產生關聯。如需設定知識庫的詳細資訊，請參閱使用知識庫擷取資料並產生 AI 回應。若要瞭解如何將知識庫與代理程式建立關聯，請參閱利用知識庫，為您的代理商增強回應生成。

  5. 在「護欄詳細資料」區段中，您可以選擇 「編輯」，將護欄與代理程式建立關聯，以封鎖和過濾掉有害內容。從「選取護欄」下的下拉式功能表中選取您要使用的護欄，然後在護欄版本下選擇要使用的版本。您可以選取「檢視」以查看護欄設定。如需詳細資訊，請參閱使用 Amazon 基岩護欄阻止模型中的有害內容。

  6. 在 [進階提示] 區段中，您可以選擇 [編輯]，自訂代理程式在協調流程的每個步驟中傳送至 FM 的提示。若要取得有關可用於自訂之提示樣板的更多資訊，請參閱〈〉使用 Amazon 基岩中的進階提示範本提升客服人員的準確性。若要瞭解如何設定進階提示，請參閱設定進階提示範本。

  7. 完成設定代理程式後，請選取下列其中一個選項：

    • 若要留在代理程式產生器中，請選擇 [儲存]。然後，您可以準備代理程式，以便在測試視窗中使用更新的組態對其進行測試。若要瞭解如何測試代理程式，請參閱測試和疑難排解代理程式。

    • 若要返回「代理程式詳細資訊」頁面，請選擇儲存並結束。

API

若要建立代理程式，請傳送 CreateAgent向 Amazon 基岩建置時間端點的代理程式請求 (請參閱請求和回應格式的連結以及欄位詳細資訊)。

查看程式碼範例

若要準備代理程式並對其進行測試或部署，以便您可以進行測試或部署，您必須最低限度包含下列欄位 (如果您願意，可以略過這些設定，稍後傳送 UpdateAgent請求）：

欄位 使用案例
agentResourceRole阿恩 指定具有呼叫代理程式API作業之權限ARN的服務角色
foundationModel 若要指定代理程式要協調的基礎模型 (FM)
指令 提供指示，告訴代理該怎麼做。用於協調流程提示範本的 $ 指示 $ 預留位置。

下列欄位為選擇性欄位：

欄位 使用案例
description 描述代理程式的功能
idleSessionTTLInSeconds 代理程式結束工作階段並刪除任何已儲存資訊的持續時間。
customerEncryptionKey阿恩 ARN加密代理程式資源的KMS金鑰
標籤 將標籤與您的代理程式建立關聯。
promptOverrideConfiguration 在協調流程的每個步驟中自訂傳送至 FM 的提示。
guardrailConfiguration 將護欄加入至代理程式。指定護欄ARN的 ID 或以及要使用的版本。
clientToken 識別碼，以確保API請求只完成一次。

回應會傳回 CreateAgent包含有關您新建代理程式之詳細資訊的物件。如果您的代理程式無法建立，CreateAgent響應中的對象返回一個列表failureReasons和一個列表recommendedActions供您進行故障排除。