View a markdown version of this page

Generieren Sie eine Empfehlung aus Erkenntnissen - Amazon Grundgestein AgentCore
Starten Sie eine SystemaufforderungsempfehlungRufen Sie die empfohlene Aufforderung abAlternative Trace-Quellen

Generieren Sie eine Empfehlung aus Erkenntnissen

Nachdem Sie Ihre Insights-Ergebnisse überprüft haben, können Sie dieselben Agenten-Traces verwenden, um eine verbesserte Systemaufforderung zu generieren. Zeigen StartRecommendation Sie auf die abgeschlossene Batch-Auswertung, die zu Ihren Insights-Ergebnissen geführt hat.

Anmerkung

Die Generierung von Empfehlungen wird derzeit nur aus Builtin.Insight.FailureAnalysis Erkenntnisgründen unterstützt, und es werden heute nur Systemempfehlungen bereitgestellt.

Starten Sie eine Systemaufforderungsempfehlung

Geben Sie Ihre aktuelle Systemaufforderung ein und verweisen Sie auf die Batch-Auswertung, die die Traces enthält:

Beispiel
AgentCore CLI

Generieren Sie anhand eines abgeschlossenen Insights-Runs eine Empfehlung:

agentcore run recommendation --from-insights <id> --type system-prompt --bundle-name my_bundle --json

Oder verweisen Sie direkt auf einen ARN für die Batchauswertung:

agentcore run recommendation --batch-evaluation-arn <arn> --type system-prompt --bundle-name my_bundle --json
Interactive

  1. Ausführenagentcore, um die TUI zu öffnen, wählen Sie dann Ausführen und dann Empfehlung aus:

    Menü ausführen: Wählen Sie Empfehlung

    Der Assistent führt Sie durch die Auswahl einer Trace-Quelle (Insights Run oder Batch Evaluation ARN), eines Empfehlungstyps und eines Konfigurationspakets.

AWS SDK (boto3)
import boto3
import uuid

client = boto3.client("bedrock-agentcore", region_name="us-west-2")

response = client.start_recommendation(
    name=f"fix-rate-limiting-{uuid.uuid4().hex[:8]}",
    type="SYSTEM_PROMPT_RECOMMENDATION",
    recommendationConfig={
        "systemPromptRecommendationConfig": {
            "systemPrompt": {
                "text": "You are a helpful customer support assistant. Help users with their orders and returns."
            },
            "agentTraces": {
                "batchEvaluation": {
                    "batchEvaluationArn": "arn:aws:bedrock-agentcore:us-west-2:123456789012:batch-evaluate/insights-run-ABC1234567"
                }
            },
        }
    },
    clientToken=str(uuid.uuid4()),
)

recommendation_id = response["recommendationId"]
print(f"Started recommendation: {recommendation_id}")

Rufen Sie die empfohlene Aufforderung ab

Führen Sie die Umfrage durch, bis sie abgeschlossen ist, und rufen Sie dann das Ergebnis ab:

import time

while True:
    rec = client.get_recommendation(recommendationId=recommendation_id)
    if rec["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(15)

if rec["status"] == "COMPLETED":
    result = rec["recommendationResult"]["systemPromptRecommendationResult"]
    print(f"Recommended prompt:\n{result['recommendedSystemPrompt']}")
    print(f"\nExplanation:\n{result['explanation']}")

Alternative Trace-Quellen

Anstatt auf eine Batch-Auswertung zu verweisen, können Sie Traces auch über CloudWatch Logs bereitstellen:

"agentTraces": {
    "cloudwatchLogs": {
        "logGroupArns": [
            "arn:aws:logs:us-west-2:123456789012:log-group:/aws/bedrock-agentcore/runtimes/MyAgent-abc123-DEFAULT"
        ],
        "serviceNames": ["MyAgent.DEFAULT"],
        "startTime": "2026-05-27T00:00:00Z",
        "endTime": "2026-06-03T00:00:00Z",
    }
}