Cómo revisar las instrucciones del Agente IA

Revisa las instrucciones de tu Agente IA para identificar problemas de configuración antes de publicar o actualizar el Agente.

La revisión verifica tus Instrucciones y las instrucciones de acción habilitadas del Agente IA respecto a la configuración de tu Espacio de trabajo. Puede identificar referencias inválidas, acciones mal configuradas, instrucciones no admitidas, instrucciones en conflicto y otros problemas que pueden afectar el funcionamiento de tu Agente IA.

Cómo revisar tu Agente IA

1. Ve a Agentes IA.

2. Crea un Agente IA nuevo o selecciona uno existente para editar.

3. Haz clic en Review.

4. Espera a que la revisión complete.

5. Si se encuentran problemas, selecciona Review issues para verlos.

Puedes revisar los problemas y las correcciones sugeridas antes de hacer cambios en tu Agente IA.

Qué verifica la revisión

La revisión comprueba varias partes de la configuración de tu Agente IA.

Referencias y tokens

La revisión verifica que los elementos del Espacio de trabajo referenciados en tus instrucciones existan y se usen correctamente.

Esto incluye:

• Campos de contacto:$FieldName

• Flujos de trabajo: !WorkflowName

• Usuarios y equipos: @UserName y @TeamName

• Etiquetas: %TagName

Por ejemplo, se puede detectar un problema si tus instrucciones hacen referencia a un Campo de contacto o una Etiqueta que ya no existe.

Para los Campos de contacto, la revisión también puede detectar cuando se usa el valor de un campo sin suficiente contexto para que el Agente IA entienda a qué se refiere ese valor.

Acciones del Agente IA

La revisión comprueba si las acciones del Agente IA descritas en tus instrucciones coinciden con las acciones configuradas para el Agente IA.

Se pueden detectar problemas cuando:

• Tus instrucciones hacen referencia a una acción que no está habilitada.

• Una acción habilitada a la que hacen referencia tus instrucciones no tiene instrucciones de acción.

• Tus instrucciones hacen referencia a una acción que no está disponible.

• Una acción usa un destino inválido, como una

  Asignar a agente o equipo acción sin destino o una Agregar comentario acción que mencione a un equipo o a un Agente IA en lugar de a un Usuario.

• Tus instrucciones se contradicen sobre cuándo o cómo debe usarse una acción.

Obtén más información sobre cómo configurar y usar las acciones del Agente IA. La guía existente sobre acciones ya explica el comportamiento de las acciones, como que las acciones se ejecutan antes de las respuestas y la necesidad de usar los nombres exactos de los elementos del Espacio de trabajo.

Instrucciones no admitidas

La revisión puede detectar instrucciones que pidan al Agente IA realizar tareas no admitidas.

Por ejemplo:

• Leer las Etiquetas existentes de un Contacto.

• Leer los Comentarios internos.

• Buscar información en una Fuente de conocimiento basándose en el título del documento en lugar de en su contenido.

• Enviar tipos de adjuntos no admitidos, como videos, notas de voz o stickers.

Para más información sobre a qué pueden acceder los Agentes IA y a qué no, consulta Agentes IA: limitaciones conocidas y soluciones alternativas.

Instrucciones de seguimiento y límites

La revisión verifica si tus instrucciones se mantienen dentro de los límites admitidos para los Agentes IA.

Pueden detectarse problemas por:

• Más de 5 pasos de seguimiento.

• Un seguimiento programado más de 24 horas después del mensaje anterior.

• Ramas o múltiples secuencias de seguimiento paralelas.

• Instrucciones que pidan al Agente IA que se refiera a más de los últimos 20 mensajes en una conversación.

Claridad y consistencia de las instrucciones

La revisión también comprueba si tus instrucciones ofrecen un flujo claro y consistente para que el Agente IA lo siga.

Puede identificar:

• Instrucciones en conflicto para la misma situación.

• Un objetivo ausente o poco claro.

• Ninguna condición de salida clara.

• Instrucciones que no tienen suficiente estructura para el flujo previsto.

Para obtener orientación sobre cómo estructurar tus instrucciones, consulta Cómo redactar prompts efectivos para Agentes IA.

Revisar y corregir problemas

Cuando se detecten problemas, selecciona Review para verlos con más detalle.

Los problemas se agrupan según dónde aparecen, por ejemplo en tus principales Instrucciones o en una Acción individual.

Para problemas con una solución sugerida:

1. Selecciona los problemas que quieras corregir.

2. Revisa los cambios sugeridos.

3. Selecciona Aplicar correcciones.

4. Verifica los cambios propuestos antes de confirmarlos.

Tus instrucciones no se cambian hasta que confirmes las correcciones. Después de aplicar las correcciones, las instrucciones se revisan nuevamente en busca de problemas restantes.

Ignorar un problema

Selecciona Ignorar si no quieres abordar un problema durante la revisión actual.

Ignorar un problema:

• Lo elimina de la lista actual de problemas abiertos.

• No cambia las instrucciones de tu Agente IA.

• No marca el problema como resuelto de forma permanente.

Los problemas ignorados se eliminan cuando ejecutas una nueva revisión, por lo que un problema puede volver a aparecer si todavía se detecta.