View a markdown version of this page

Genere una recomendación a partir de información y hallazgos - Amazon Bedrock AgentCore
Inicie una recomendación rápida del sistemaRecupera el mensaje recomendadoFuentes de rastreo alternativas

Genere una recomendación a partir de información y hallazgos

Tras revisar los resultados de tus estadísticas, puedes utilizar los mismos rastros de los agentes para generar un mensaje de sistema mejorado. StartRecommendationSeñale la evaluación del lote completa que produjo sus conclusiones.

nota

Actualmente, solo se admite la generación de recomendaciones para Builtin.Insight.FailureAnalysis obtener información y, en la actualidad, solo se proporcionan recomendaciones rápidas del sistema.

Inicie una recomendación rápida del sistema

Proporcione el mensaje de su sistema actual y consulte la evaluación del lote que contiene las trazas:

ejemplo
AgentCore CLI

Genere una recomendación a partir de una consulta de información completa:

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

O consulte directamente un ARN de evaluación de lotes:

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

  1. Ejecute agentcore para abrir la TUI, luego seleccione ejecutar y elija Recomendación:

    Menú Ejecutar: seleccione Recomendación

    El asistente le guía para seleccionar una fuente de rastreo (ARN de evaluación por lotes o ejecución de insights), un tipo de recomendación y un paquete de configuración.

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}")

Recupera el mensaje recomendado

Realice una encuesta hasta que se complete y, a continuación, recupere el resultado:

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']}")

Fuentes de rastreo alternativas

En lugar de hacer referencia a una evaluación de un lote, también puede proporcionar los seguimientos a través de CloudWatch los registros:

"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",
    }
}