Recomendaciones

Recomendación rápida del sistema: analiza los rastros de los agentes y genera una solicitud de sistema optimizada que mejora el rendimiento del evaluador objetivo. El servicio identifica los patrones de error y agrega instrucciones de comportamiento específicas.

Recomendación sobre la descripción de la herramienta: analiza los rastros de los agentes y genera descripciones más precisas de las herramientas para reducir la confusión al seleccionar las herramientas. Esto resulta útil cuando los agentes seleccionan la herramienta equivocada para solicitudes ambiguas.

Texto en línea: proporciona la configuración directamente como una cadena en la solicitud de API. Para obtener recomendaciones rápidas del sistema, introduzca el texto de la solicitud en el systemPrompt.text campo. Para obtener recomendaciones sobre la descripción de las herramientas, introduzca el nombre y la descripción de cada herramienta en la toolDescription.toolDescriptionText.tools lista. Este modo es útil para experimentar rápidamente, cuando quieres probar una línea sobre la que estás iterando activamente o cuando la configuración no está almacenada en un paquete.

Paquete de configuración: haga referencia a una versión de un paquete de configuración existente. El servicio lee la configuración actual del paquete mediante la ruta JSON que especifiques, genera la versión optimizada y vuelve a escribir el resultado en una nueva versión del paquete. Esto mantiene el historial de optimización versionado junto con el paquete. Este modo resulta útil cuando se gestionan las configuraciones de forma centralizada con paquetes de configuración y se desea que el resultado optimizado se vuelva a incluir automáticamente en el paquete.

Cuando se utiliza un paquete de configuración, el resultado de la recomendación incluye un configurationBundle campo con la bundleArn y una nueva que versionId apunta a la versión del paquete que contiene la configuración optimizada.

CloudWatch Registros: utilícelos cuando el tiempo de ejecución de su agente escriba la telemetría en. CloudWatch El servicio lee los rastros directamente de los grupos de registros especificados dentro de un intervalo de tiempo requerido. Debe proporcionarlogGroupArns, serviceNamesstartTime, yendTime. Un rule campo opcional le permite filtrar los rastros (por ejemplo, seleccionar solo las sesiones que estén goal_success_rate por debajo de un umbral).

Intervalos de sesión en línea: utilízalo cuando tengas rastreos disponibles localmente (por ejemplo, desde una ejecución de prueba local, una CI/CD canalización o una sesión específica para la que quieras optimizar). Los intervalos se proporcionan directamente en el cuerpo de la solicitud de la API como una lista de objetos de OpenTelemetry-compatible intervalo.

Evaluación por lotes: utilícela cuando haya completado un trabajo de evaluación por lotes y desee reutilizar las sesiones para optimizarlas. En lugar de recopilar los rastros CloudWatch o proporcionar intervalos en línea, debes hacer referencia a la evaluación del lote directamente por su ARN. Esta fuente solo está disponible para recomendaciones rápidas del sistema.

Evaluación en línea: utilícela cuando tenga una configuración de evaluación en línea que evalúe continuamente las sesiones de los agentes en vivo. Como la evaluación en línea es un flujo continuo, debe especificar un intervalo de tiempo (startTimeyendTime) para determinar las sesiones evaluadas de las que se basa la recomendación. El servicio reutiliza las puntuaciones de las sesiones de evaluación en línea dentro del período especificado. Esta fuente solo está disponible para recomendaciones rápidas del sistema.