本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
測試和疑難排解代理程式
創建代理後，您將有一個工作草案。工作草案是代理程式的版本，可以用來反覆組建代理程式。每次您對代理進行更改時，工作草案都會更新。當您對代理程式的設定感到滿意時，您可以建立一個版本 (代理程式的快照) 以及指向該版本的別名。然後，您可以呼叫別名，將代理程式部署到應用程式。如需詳細資訊，請參閱將 Amazon 基岩代理程式部署並整合到您的應用程式中。
下列清單說明您如何測試代理程式：
-
在 Amazon 基岩主控台中，您可以在側面開啟測試視窗，然後傳送輸入以供您的代理回應。您可以選擇工作草稿或已創建的版本。
-
在中API，工作草稿是
DRAFT版本。您通過使用將輸入發送給您的代理 InvokeAgent測試別名TSTALIASID，或指向靜態版本的不同別名。
為了協助疑難排解代理程式的行為，Amazon 基岩代理程式可讓您在與代理程式的工作階段期間檢視追蹤。跟踪顯示了代理的 step-by-step 推理過程。如需追蹤的詳細資訊，請參閱使用跟踪跟踪跟踪代 step-by-step 理的推理過程。
以下是測試代理的步驟。選擇與您選擇的方法相對應的選項卡，然後按照步驟操作。
- Console
-
若要測試代理程式
-
登入 AWS Management Console 使用具有 Amazon 基岩許可的IAM角色，並在以下位置打開 Amazon 基岩控制台。https://console.aws.amazon.com/bedrock/
-
從左側導覽窗格中選取「代理程式」。然後，在「代理程式」區段中選擇代理程式。
-
在「代理程式」區段中，從代理程式清單中選取要測試之代理程式的連結。
-
[測試] 視窗會出現在右側窗格中。
注意
如果 [測試] 視窗已關閉，您可以選取代理程式詳細資訊頁面頂端或其中任何頁面的 [測試]，以重新開啟測試視窗。
-
建立代理程式之後，您必須使用下列其中一種方式準備，將其與工作中的草稿變更一起封裝：
-
在「測試」視窗中，選取「準備」。
-
在 [工作草稿] 頁面中，選取頁面頂端的 [準備]。
注意
每次更新工作草稿時，您都必須準備代理程式，以最新的變更封裝代理程式。最佳做法是，建議您務必在 [工作草稿] 頁面的 [代理程式概觀] 區段中檢查代理程式的上次準備時間，以確認您是否使用最新的組態來測試代理程式。
-
-
若要選擇要測試的別名和相關版本，請使用「測試」視窗頂端的下拉式功能表。依預設，會選取 TestAlias：工作拔模組合。
-
(選擇性) 若要為您的別名選取佈建輸送量，您所選測試別名下方的文字將指示使用ODT或使用 PT。若要建立佈建輸送量模型，請選取變更。如需詳細資訊，請參閱使用 Amazon 基岩中的佈建輸送量增加模型叫用容量。
-
若要測試代理程式，請輸入訊息並選擇 [執行]。當您等待回應產生或產生回應時，您可以使用下列選項：
-
若要檢視代理程式協調流程每個步驟的詳細資料，包括每個步驟的提示、推論組態和代理程式的推理程序，以及其動作群組和知識庫的使用情況，請選取顯示追蹤。追蹤會即時更新，因此您可以在傳回回應之前加以檢視。若要展開或收合步驟的追蹤，請選取步驟旁邊的箭頭。如需有關「追蹤」視窗的詳細資訊以及顯示的詳細資訊，請參閱使用跟踪跟踪跟踪代 step-by-step 理的推理過程。
-
如果代理程式呼叫知識庫，回應會包含註腳。若要檢視 S3 物件的連結，其中包含回應特定部分的被引用資訊，請選取相關註腳。
-
如果您將代理程式設定為傳回控制項，而不是使用 Lambda 函數來處理動作群組，則回應會包含預測的動作及其參數。提供動作API或函數的範例輸出值，然後選擇「送出」以產生代理程式回應。如需範例，請參閱下列影像：
您可以在「測試」視窗中執行下列動作：
-
若要與代理程式開始新的交談，請選取重新整理圖示。
-
欲檢視「追蹤」視窗，請選取展開圖示。若要關閉「追蹤」視窗，請選取「縮小」圖示。
-
若要關閉 [測試] 視窗，請選取向右箭頭圖示。
-
您可以啟用或停用動作群組和知識庫。使用此功能可透過不同的設定來評估代理程式的行為，藉由隔離哪些動作群組或知識庫需要更新，進而對代理程式進行疑難排解。
若要啟用動作群組或知識庫
-
登入 AWS Management Console 使用具有 Amazon 基岩許可的IAM角色，並在以下位置打開 Amazon 基岩控制台。https://console.aws.amazon.com/bedrock/
-
從左側導覽窗格中選取「代理程式」。然後，在「代理程式」區段中選擇代理程式。
-
在「代理程式」區段中，從代理程式清單中選取要測試之代理程式的連結。
-
在代理程式詳細資訊頁面的工作草稿區段中，選取工作草稿的連結。
-
在 [動作群組] 或 [知識庫] 區段中，將滑鼠游標暫留在您要變更其狀態之動作群組或知識庫的 [狀態] 上。
-
顯示編輯按鈕。選取編輯圖示，然後從下拉式功能表中選擇動作群組或知識庫為 [啟用] 或 [停用]。
-
如果動作群組為 [已停用]，則代理程式不會使用動作群組。如果知識庫為 [停用]，代理程式就不會使用知識庫。啟用或停用動作群組或知識庫，然後使用 [測試] 視窗對代理程式進行疑難排解。
-
選擇 [準備]，在測試代理程式之前，先套用您對代理程式所做的變更。
-
- API
-
在您第一次測試代理程式之前，您必須透過傳送 PrepareAgent向 Amazon 基岩建置時間端點的代理程式請求 (請參閱請求和回應格式的連結以及欄位詳細資訊)。在請求
agentId中包含。這些變更會套用至TSTALIASID別名指向的DRAFT版本。注意
每次更新工作草稿時，您都必須準備代理程式，以最新的變更封裝代理程式。最佳做法是，我們建議您傳送 GetAgent向 Amazon Bdrock 建置時間端點的代理程式請求 (請參閱請求和回應格式的連結以及欄位詳細資訊)，並檢查您的代理程式是否正在使用最新組態測試代理程式的
preparedAt時間。若要測試您的代理程式，請傳送 InvokeAgent使用 Amazon 基岩執行階段端點的代理程式請求 (請參閱請求和回應格式的連結以及欄位詳細資訊)。
注意
所以此 AWS CLI 不支持 InvokeAgent.
請求中存在下列欄位：
-
最低限度提供下列必要欄位：
欄位 簡短說明 agentId 代理程式的識別碼 agentAliasId 別名的識別碼。用 TSTALIASID於調用DRAFT版本sessionId 工作階段的英數字元識別碼 (2—100 個字元) inputText 傳送至代理程式的使用者提示 -
下列欄位為選擇性欄位：
回應會在事件串流中傳回。每個事件都包含一個
chunk，其中包含bytes字段中的響應的一部分，必須對其進行解碼。如果代理程式查詢知識庫，則chunk也會包含citations。也可以返回以下對象：-
如果您啟用追蹤，也會傳回
trace物件。如果發生錯誤，則返回一個帶有錯誤消息的字段。如需如何讀取追蹤的更多資訊，請參閱使用跟踪跟踪跟踪代 step-by-step 理的推理過程。
-
