Recopilación de datos de diagnóstico de problemas de rendimiento

1. Datos del inquilino y del entorno

Empieza por compartir información básica sobre el entorno. Ayuda al servicio de asistencia IBM a identificar su implantación y región, lo que es fundamental para localizar los problemas relacionados con la infraestructura.

Comparte los siguientes detalles:

• ID del inquilino o CRN: Incluya el CRN de su inquilino. Puedes encontrarlo haciendo clic en tu perfil > Acerca de. Adjunte una captura de pantalla de la página Acerca de.

• Plataforma: Especifique si su entorno se ejecuta en AWS o IBM Cloud.

• Región: puedes encontrarla haciendo clic en tu perfil > Región.

Los detalles sobre el inquilino y la región permiten al servicio de asistencia IBM comprobar los factores de rendimiento específicos de la plataforma o de la región.

2. Detalles del modelo de IA

Indique el nombre del modelo de IA utilizado en el agente afectado. Es fundamental porque los distintos modelos tienen arquitecturas, capacidades y limitaciones conocidas únicas.

Siga estos pasos para encontrar los detalles del modelo de IA:

1. En el menú principal, vaya a Construir.

2. Vaya a Todos los agentes y seleccione el agente afectado.

3. En la página de configuración del agente, copie y guarde los detalles del modelo de IA de la lista Modelos de IA.

Por ejemplo:

llama-3-2-90b-vision-instruct

Conocer el modelo exacto ayuda al servicio de asistencia IBM a diagnosticar los problemas de rendimiento específicos de cada modelo y a aplicar correcciones específicas.

3. Configuración del perfil de agente

La configuración del agente determina cómo éste interpreta las consultas y responde. Una configuración incorrecta puede provocar un comportamiento inesperado o latencia.

A continuación se indican los pasos para encontrar los detalles:

1. En el menú principal, vaya a Construir.

2. Vaya a Todos los agentes y seleccione el agente afectado.

3. En la página de configuración del agente, vaya a Conocimiento.

4. Confirme el estilo de Agente (Predeterminado o ReAct ).

5. Confirme si la modalidad de voz está habilitada e identifique los modelos STT y TTS en uso.

4. Detalles de la configuración de conocimientos

Las fuentes de conocimiento afectan al modo en que los agentes recuperan y procesan los datos. A continuación se indican los pasos para encontrar los detalles de la configuración de conocimientos:

1. En el menú principal, vaya a Construir.

2. Vaya a Todos los agentes y seleccione el agente afectado.

3. En la página de configuración del agente, vaya a Conocimiento.

4. Observe los siguientes detalles en Fuente de conocimiento.

   • Fuentes de conocimiento: Milvus, Elasticsearch, Servicio personalizado, Astra DB.

   • Carga de archivos (si procede):

     • Tipos de documento:.docx,.pdf,.pptx,.xlsx,.csv,.html,.txt.

     • Tamaño del documento.

5. Herramientas y agentes colaboradores

Las herramientas y los agentes colaboradores desempeñan un papel fundamental en el rendimiento de su agente. Cada herramienta añade pasos de procesamiento, y las integraciones pueden introducir latencia o errores. Proporcionar estos detalles ayuda a IBM Support a comprender la complejidad de su agente y a localizar posibles cuellos de botella.

A continuación se indican los pasos para encontrar las herramientas y los datos del agente colaborador:

1. En el menú principal, vaya a Construir.

2. Vaya a Todos los agentes y seleccione el agente afectado.

3. En la página de configuración del agente, vaya a Conjunto de herramientas.

4. Observe los detalles en Herramientas. El número de herramientas que se utilizan y el tipo de herramienta utilizada ( OpenAPI,Python, MCP Server, Flow, Langflow).

5. Tenga en cuenta los detalles de los agentes, como los agentes de catálogo, los agentes externos, el asistente de watsonx Orchestrate o el agente externo {{ site.data.keyword. conversación breve}}.

6. Canales y configuraciones personalizadas

Enumera todos los canales y configuraciones personalizadas, tales como: agente integrado, Microsoft Teams, Facebook Messenger, etc. A continuación se indican los pasos para encontrar los detalles de los canales:

1. En el menú principal, vaya a Construir.

2. Vaya a Todos los agentes y seleccione el agente afectado.

3. En la página de configuración del agente, vaya a Canales.

4. Observe los canales habilitados.

7. Documentar los cambios y acontecimientos recientes

Los cambios suelen ir seguidos de problemas de rendimiento. Revisa y anota los siguientes datos:

• Cambios recientes en los agentes (herramientas, configuraciones)

• Factores ambientales en el momento en que comenzó el problema

8. Recopilar y exportar datos de seguimiento

Los registros son fundamentales para diagnosticar problemas de rendimiento. A continuación se indican los pasos para recopilar los datos de seguimiento:

1. En el menú principal, ve a «Analizar» y selecciona el agente.

2. Haz clic en el estado de un mensaje en la tabla _Traces_ para ver todos los detalles del seguimiento.

3. Haz clic en «Nueva ventana» para abrir el seguimiento en la interfaz de usuario de Jaeger.

4. En « Jaeger », selecciona «Trace Timeline» > «Trace JSON» para ver el seguimiento en formato JSON.

5. Para guardar el trazo:

   • Haz clic con el botón derecho y selecciona «Guardar como…»

   • Ponle un nombre al archivo y guárdalo para consultarlo más adelante.

Consulte la página de análisis del agente de supervisión para obtener más información.

9. Opcional: Datos del agente de exportación

La exportación de los detalles del agente proporciona al servicio de asistencia IBM una instantánea completa de la configuración y los ajustes del agente.

Puedes exportar la configuración de tu agente utilizando el archivo watsonx Orchestrate Kit de desarrollo de agentes.

Ejecute el siguiente comando para exportar los detalles del agente:

orchestrate agents export -n <agent_name> -k native -o <agent_name>.zip