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

使用代理程式擷取來查詢知識庫

代理程式擷取使用基礎模型，以智慧方式將複雜的查詢分解為子查詢、反覆從您的知識庫擷取相關資訊，並評估擷取的結果是否足以回答原始查詢。此方法可改善單一擷取傳遞可能無法完全解決之複雜多步驟問題的擷取準確性。

例如，假設查詢「Arthur's magazine 或 First for women？」，代理程式擷取會將其分解為個別的子查詢，例如「Arthur's Gallery 何時成立？」 和「何時首次為女性建立？」， 會擷取每個結果，並評估合併的結果是否足夠。

代理程式擷取的運作方式

當您傳送請求至 AgenticRetrieveStream API 時，會發生下列程序：

先決條件

您必須先擁有下列項目，才能使用代理程式擷取：

使用代理程式擷取查詢知識庫

若要使用代理程式擷取，請傳送 AgenticRetrieveStream請求。回應是包含擷取結果和追蹤事件的串流。

下表說明金鑰請求欄位：

如需完整的請求和回應語法，請參閱 API 參考AgenticRetrieveStream中的 。

代理程式擷取回應

AgenticRetrieveStream 回應是包含下列事件類型的串流：

使用 AgentCore 記憶體進行代理程式擷取

您可以授予 Amazon Bedrock AgentCore 記憶體資源的代理程式擷取存取權。透過記憶體存取，擷取可以繼續較早的工作階段，並利用客服人員在先前工作階段中學到的內容。使用您帳戶中處於 ACTIVE 狀態memoryId的記憶體資源的 提供 memoryConfiguration 欄位。

記憶體是選用的。僅設定 memoryConfiguration的 memoryId 無效。當您提供 時memoryConfiguration，您必須至少使用下列兩種方式之一的記憶體資源：

提供與記憶體策略上設定的命名空間完全相同的命名空間，預留位置已解析。例如，如果策略定義命名空間 /strategy/{memoryStrategyId}/actor/{actorId}，請提供解析的值，而不是範本。如需命名空間、策略和記憶體記錄的詳細資訊，請參閱《Amazon Bedrock AgentCore 開發人員指南》中的記憶體術語。

設定 sessionBinding 時，使用 persistenceMode 控制目前交換是否寫回工作階段：

下列範例會還原較早的工作階段，讓代理程式存取該演員的長期記憶體，並將交換保留回工作階段：

{
    "messages": [
        {
            "content": {
                "text": "What did we decide about the migration timeline?"
            },
            "role": "user"
        }
    ],
    "retrievers": [
        {
            "configuration": {
                "knowledgeBase": {
                    "knowledgeBaseId": "KB12345678"
                }
            }
        }
    ],
    "agenticRetrieveConfiguration": {
        "foundationModelType": "MANAGED",
        "rerankingModelType": "MANAGED"
    },
    "memoryConfiguration": {
        "memoryId": "projectAssistantMemory-1a2b3c4d5e",
        "sessionBinding": {
            "actorId": "user-123",
            "sessionId": "session-456"
        },
        "retrievalConfigs": [
            {
                "namespace": "/strategy/summarization-1a2b3c4d5e/actor/user-123"
            }
        ],
        "persistenceMode": "DEFAULT"
    }
}

回應串流會報告記憶體活動。還原會顯示為工作階段歷史記錄負載追蹤事件。長期記憶體傳回的記錄會顯示在來源類型為 的擷取追蹤事件上BedrockAgentCoreMemory，以擷取的步驟為準。

擷取本身的顯示方式取決於何時發生。當基礎模型選擇搜尋記憶體 （通常在持續的工作階段上） 時，擷取會顯示為規劃追蹤事件上的memoryRetrieve動作。在新的工作階段上，代理程式可以在推測擷取期間，在第一個規劃步驟之前擷取長期記憶體，在這種情況下不會發出memoryRetrieve任何動作。如需詳細資訊，請參閱代理程式擷取回應。

代理程式擷取的必要許可

若要使用 AgenticRetrieveStream API，呼叫 IAM 身分必須具有下列許可：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "bedrock:AgenticRetrieveStream",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "bedrock:Retrieve",
                "bedrock:GetDocumentContent"
            ],
            "Resource": "arn:aws:bedrock:region:account-id:knowledge-base/*"
        },
        {
            "Effect": "Allow",
            "Action": "bedrock:InvokeModelWithResponseStream",
            "Resource": "*"
        }
    ]
}

如果您使用具有代理程式擷取的護欄，請新增下列許可：

{
    "Effect": "Allow",
    "Action": [
        "bedrock:GetGuardrail",
        "bedrock:ApplyGuardrail"
    ],
    "Resource": "*"
}

如果您使用 AgentCore 記憶體資源進行代理程式擷取，請新增下列許可：

{
    "Effect": "Allow",
    "Action": [
        "bedrock-agentcore:GetMemory",
        "bedrock-agentcore:ListEvents",
        "bedrock-agentcore:RetrieveMemoryRecords",
        "bedrock-agentcore:CreateEvent"
    ],
    "Resource": "arn:aws:bedrock-agentcore:region:account-id:memory/memory-id"
}

bedrock-agentcore:ListEvents 只有在您設定 時才需要 sessionBinding。只有在您設定 時才bedrock-agentcore:RetrieveMemoryRecords需要 retrievalConfigs。只有在 persistenceMode為 時才bedrock-agentcore:CreateEvent需要 DEFAULT。

如果使用客戶受管金鑰加密記憶體資源，請在該金鑰上新增下列許可：

{
    "Effect": "Allow",
    "Action": "kms:Decrypt",
    "Resource": "arn:aws:kms:region:account-id:key/key-id"
}

考量事項

使用代理程式擷取時，請記住下列事項：