Soluciona problemas de registros de ejecución fallidos con IA

Application Integration proporciona solución de problemas impulsada por IA para las ejecuciones con errores. Esta función usa Google Gemini para analizar los registros de ejecución, determinar las causas raíz y generar recomendaciones prácticas. Puedes acceder a esta función desde la página Execution Logs en Application Integration.

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

Ventajas clave

Con la función de solución de problemas potenciada por IA de Gemini, puedes hacer lo siguiente:

• Comprender claramente los mensajes de error complejos La IA convierte los registros técnicos en estadísticas claras y prácticas.
• Recibirás pasos de resolución precisos y personalizados según tu lógica de integración única y los errores específicos que encuentres.
• Reduce el tiempo de depuración identificando las causas raíz y los pasos de corrección para las soluciones.

Antes de comenzar

Antes de usar la función de solución de problemas con IA de Gemini, debes hacer lo siguiente:

• Habilita las capacidades de IA para la Google Cloud región específica en la que implementas tu integración. Para obtener más información sobre cómo habilitar las capacidades de IA para una región nueva o existente, consulta Habilita las capacidades de IA para la solución de problemas.

Habilita las funciones basadas en IA para la solución de problemas

Para usar la IA de Gemini y solucionar problemas de ejecuciones fallidas, habilita las capacidades de IA para la Google Cloud región específica en la que implementas tu integración.

Habilita la IA para una región nueva

Para habilitar la IA en una región nueva en Application Integration, sigue estos pasos:

1. En la consola de Google Cloud , ve a la página Application Integration.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Regiones. Aparecerá la página Regiones con todas las regiones aprovisionadas en tu proyecto.
3. Haz clic en Aprovisionar región nueva.
4. Expande la opción Configuración avanzada.
5. Haz clic en el botón de activación Habilitar funciones potenciadas por IA en Funciones potenciadas por IA.

Habilita la IA en una región existente

Para habilitar la IA en una región existente en Application Integration, realiza los siguientes pasos:

1. En la consola de Google Cloud , ve a la página Application Integration.

   Ir a Application Integration

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

   Aparecerá el panel Editar región.

4. Expande la sección Configuración avanzada.
5. Haz clic en el botón de activación Habilitar funciones potenciadas por IA en Funciones potenciadas por IA.

Soluciona problemas de ejecuciones fallidas con IA

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

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

1. En la consola de Google Cloud , ve a la página Application Integration.

   Ir a Application Integration

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

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

3. En la página Registros de ejecución, busca una entrada que muestre el estado Con errores error.
4. Haz clic en el ícono chat_spark junto a la entrada de registro con errores.
   • También puedes expandir la fila específica y hacer clic en Explica esta entrada de registro.

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

   • Mensaje de error: Muestra la descripción técnica del error y señala dónde se produce en el código.
   • Causa raíz: Explica por qué ocurrió el error.
   • Análisis detallado: (Expande esta sección) Proporciona más detalles sobre el impacto del error, las áreas específicas del código involucradas y cómo corregirlo.
   • Pasos para corregir 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 con errores de los siguientes tipos de tareas: Tarea de llamada a REST, Tarea de conectores, Tarea de JavaScript, Tarea de asignación de datos, Tarea de Cloud Functions 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 la solución de problemas, es posible que obtengas una respuesta diferente, ya que las respuestas las genera un modelo de Gemini.
   Nota: Si las funciones basadas en IA estaban inhabilitadas, el botón Habilitar funciones basadas en 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 en su acceso inicial debido al análisis de IA.
5. Después de revisar el resumen de errores y comprender el problema, haz clic en Cerrar para volver a la página Registros de ejecución.

Resuelve problemas con recomendaciones basadas en IA

Después de revisar el resumen del error, resuelve el problema completando los siguientes pasos:

1. Sigue las recomendaciones: Implementa los pasos recomendados y realiza todos los cambios necesarios en la lógica de integración o la configuración del conector, según 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 resolvió por completo.

Ejemplo de resumen de error

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 raíz: El error Index 0 out of bounds, not within [0, 0) indica un intento de acceder al primer elemento (índice 0) de un array vacío. Este problema ocurre en la línea 16 de tu código, específicamente en estas partes de tu secuencia de comandos:
  • Función getMergedObject(orderId): Esta función devuelve un array vacío [] cuando no puede encontrar un pedido 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 que devuelve getMergedObject(orderId) porque el resultado es un array vacío [].
• Análisis detallado:
  • Función getMergedObject(orderId): Esta función busca un pedido coincidente en el array ordersSalesforce. Si no se encuentra ninguna coincidencia, se muestra un array vacío []. Este es el comportamiento esperado cuando no se encuentra orderId en el array ordersSalesforce.
  • Línea local orders = std.map (...);: Esta línea usa la función std.map para procesar datos. Sin embargo, intenta acceder directamente al primer elemento del array que devuelve getMergedObject(orderId) sin verificar si el array está vacío. Cuando el array está vacío, se produce un error index 0 out of bounds.
  Pasos para corregir el error:
  • Ve a la sección Autenticación en 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.
  • Prueba y vuelve a publicar la integración para aplicar los cambios.