Solucionar problemas de registros de ejecución fallidos con la IA

Integración de aplicaciones ofrece soluciones de problemas basadas en IA para las ejecuciones fallidas. Esta función usa Google Gemini para analizar los registros de ejecución, determinar las causas principales y generar recomendaciones útiles. Puedes acceder a esta función desde la página Registros de ejecución de Integración de aplicaciones.

Nota: Tus datos no se almacenan en la IA de Gemini.

Principales ventajas

Si usas la función de solución de problemas basada en la IA de Gemini, puedes hacer lo siguiente:

• Entender claramente los mensajes de error complejos. La IA convierte los registros técnicos en métricas claras y útiles.
• Recibe pasos precisos para resolver los problemas, adaptados a tu lógica de integración y a los errores específicos que hayas encontrado.
• Reduce el tiempo de depuración identificando las causas principales y los pasos de corrección.

Antes de empezar

Para poder usar la función de solución de problemas con la IA de Gemini, debes cumplir los siguientes requisitos:

• Habilita las funciones de IA en la Google Cloud región específica en la que implementes tu integración. Para obtener más información sobre cómo habilitar las funciones de IA en una región nueva o en una que ya tengas, consulta Habilitar las funciones de IA para solucionar problemas.

Habilitar las funciones de IA para solucionar problemas

Para usar la IA de Gemini en la solución de problemas de ejecuciones fallidas, habilita las funciones de IA en la Google Cloud región específica en la que implementes tu integración.

Habilitar la IA en una nueva región

Para habilitar la IA en una nueva región en Integración de aplicaciones, sigue estos pasos:

1. En la Google Cloud consola, ve a la página Integración de aplicaciones.

   Ir a Integración de aplicaciones

2. En el menú de navegación, haga clic en Regiones. Aparecerá la página Regiones, donde se mostrarán todas las regiones aprovisionadas en tu proyecto.
3. Haz clic en Provision new region (Aprovisionar nueva región).
4. Despliega Configuración avanzada.
5. En Funciones de IA, haz clic en el interruptor Habilitar funciones de IA.

Habilitar la IA en una región

Para habilitar la IA en una región de Integración de aplicaciones, sigue estos pasos:

1. En la Google Cloud consola, ve a la página Integración de aplicaciones.

   Ir a Integración de aplicaciones

2. En el menú de navegación, haga clic en Regiones. Aparecerá la página Regiones, donde se mostrarán todas las regiones aprovisionadas en tu proyecto.
3. En la columna Acciones de la región que quieras editar, haz clic en Acciones de la región y selecciona Editar.

   Aparecerá el panel Editar región.

4. Despliega la sección Configuración avanzada.
5. En Funciones de IA, haz clic en el interruptor Habilitar funciones de IA.

Solucionar problemas de ejecuciones fallidas con IA

Nota: Con esta función, solo se pueden solucionar los problemas de las ejecuciones fallidas de las integraciones publicadas.

Para solucionar problemas con un registro de ejecución fallido mediante la IA de Gemini, haz lo siguiente:

1. En la Google Cloud consola, ve a la página Integración de aplicaciones.

   Ir a Integración de aplicaciones

2. En el menú de navegación, haz clic en Registros.

   Aparecerá la página Registros de ejecución, que muestra los registros de ejecución generados para las integraciones de la región predeterminada.

3. En la página Registros de ejecución, busca una entrada que muestre el estado Fallido con un error.
4. Haz clic en el icono chat_spark situado junto a la entrada de registro fallida.
   • También puede desplegar la fila correspondiente y hacer clic en Explicar esta entrada de registro.

   Se abrirá la página Resumen de errores, que muestra el resumen de errores generado por Gemini, incluidas las siguientes secciones:

   • Mensaje de error: muestra la descripción técnica del error e indica dónde se produce en el código.
   • Causa principal: explica por qué se ha producido el error.
   • Análisis detallado: (despliega esta sección) proporciona más detalles sobre el impacto del error, las áreas de código específicas implicadas y cómo corregirlo.
   • Pasos para solucionar el error: proporciona instrucciones de corrección específicas para la causa raíz identificada.
   Nota: Es posible que recibas respuestas de depuración más detalladas para los registros fallidos de los siguientes tipos de tareas: Tarea de llamada REST, Tarea de conectores, Tarea de JavaScript, Tarea de asignación de datos, Tarea de función de Cloud y Tarea de transformación de datos. Esto se debe a que se proporcionan instrucciones adicionales al modelo de Gemini para estos tipos de tareas específicos.
   Nota: Cuando se vuelve a intentar solucionar el problema, es posible que obtengas una respuesta diferente, ya que las respuestas las genera un modelo de Gemini.
   Nota: Si las funciones de IA están inhabilitadas, el botón Habilitar funciones de IA se mostrará la primera vez que intentes acceder a la página Resumen de errores.
   Tiempo de carga: la página Resumen de errores puede tardar hasta 20 segundos en cargarse la primera vez que se accede a ella debido al análisis de la IA.
5. Después de revisar el resumen de errores y entender el problema, haz clic en Cerrar para volver a la página Registros de ejecución.

Resolver problemas con recomendaciones de IA

Después de revisar el resumen del error, soluciona el problema siguiendo estos pasos:

1. Siga las recomendaciones: implemente los pasos recomendados y haga todos los cambios necesarios en la lógica de integración o en la configuración del conector, tal como se indica en la sección Pasos para corregir el error de la página Resumen de errores.
2. Prueba y vuelve a publicar: después de completar las modificaciones, prueba y vuelve a publicar la integración actualizada para confirmar que el problema se ha resuelto por completo.

Ejemplo de resumen de errores

En el siguiente ejemplo se describe un resumen de errores generado por IA de una ejecución fallida:

• Mensaje de error:

  RUNTIME ERROR: Index 0 out of bounds, not within [0, 0)
  template:16:2-59 function
  template:17:40-78 function
  :259:50-62 function
  :259:55-61 thunk from>
  template:20:39-40 thunk from>
  :1613:20-21 thunk from>
  :32:25-26 thunk from>
  :32:16-27 function
  :1613:8-22 function

• Causa principal: el error Index 0 out of bounds, not within [0, 0) indica que se ha intentado acceder al primer elemento (índice 0) de una matriz vacía. Este problema se produce en la línea 16 de tu código, concretamente en estas partes de tu secuencia de comandos:
  • Función getMergedObject(orderId): devuelve una matriz vacía [] cuando no encuentra ningún orden coincidente en ordersSalesforce.
  • Línea local orders = std.map(...);: esta línea provoca un error index 0 out of bounds cuando intenta acceder al primer elemento del resultado devuelto por getMergedObject(orderId), ya que el resultado es un array vacío [].
• Análisis detallado:
  • Función getMergedObject(orderId): busca un orden coincidente en la matriz ordersSalesforce. Si no se encuentra ninguna coincidencia, devuelve una matriz vacía []. Este es el comportamiento esperado cuando no se encuentra orderId en la matriz ordersSalesforce.
  • local orders = std.map (...);: esta línea usa la función std.map para procesar datos. Sin embargo, intenta acceder directamente al primer elemento de la matriz devuelta por getMergedObject(orderId) sin comprobar si la matriz está vacía. Si la matriz está vacía, se produce un error index 0 out of bounds.
  Pasos para solucionar el error:
  • Ve a la sección Autenticación de tu conexión de Salesforce.
  • Verifica el token de acceso y la versión del secreto.
  • Proporciona valores válidos para el token de acceso y la versión del secreto.
  • Pruebe y vuelva a publicar la integración para aplicar los cambios.