Diseñar agentes conversacionales

Configure el comportamiento, las capacidades y las integraciones del sistema empresarial para un agente conversacional en Studio Web.

Esta página cubre las opciones de configuración en tiempo de diseño para los agentes conversacionales en Studio Web. Usa esta configuración para definir el comportamiento, las capacidades y la integración de tu agente con los sistemas empresariales.

Crear un agente conversacional

1. Ve a studio.uipath.com.
2. Selecciona Crear nuevo y luego selecciona Agente.
3. Selecciona Conversacional.
4. Describe tu agente a Autopilot para generar una configuración de inicio o selecciona Empezar de nuevo.

Solicitud del sistema

La solicitud del sistema es la base del comportamiento de tu agente. Define el perfil del agente, los objetivos, las restricciones y las instrucciones para manejar diferentes escenarios.

Qué incluir

Una solicitud del sistema completa debe abordar:

• Identidad y persona: ¿quién es el agente? ¿Qué tono debería utilizar?
• Ámbito y límites: ¿qué temas debería manejar el agente? ¿Qué debería rechazar?
• Directrices de uso de herramientas: ¿cuándo debe utilizar el agente herramientas específicas?
• Criterios de escalada: ¿Cuándo debe el agente escalar a un humano?
• Formato de respuesta: ¿cómo debe estructurar el agente sus respuestas?

Ejemplo de solicitud de sistema

Eres un asistente de RR. HH. de Contoso Corporation. Tu rol es ayudar a los empleados con preguntas sobre las políticas de la empresa, los beneficios y los procedimientos de recursos humanos.

Directrices

• Sé profesional, amigable y conciso
• Busca siempre en la base de conocimientos antes de responder preguntas sobre políticas
• Cita documentos específicos cuando hagas referencia a políticas
• Si no puedes encontrar una respuesta, haz una oferta para escalar la pregunta a un representante de recursos humanos

Límites

• No discutas sobre el rendimiento individual ni las compensaciones de los empleados
• No hagas promesas sobre las excepciones de la política
• Redirige las preguntas sobre legislación al departamento legal

Usar Autopilot para generar solicitudes

Autopilot puede ayudarte a crear solicitudes del sistema efectivas:

1. En la sección de solicitud del sistema, describe tu caso de uso en lenguaje natural.
2. Autopilot genera una solicitud estructurada en función de tu descripción.
3. Revisa y refina la solicitud generada para que coincida con tus requisitos específicos.

Consejo:

Comienza con la solicitud generada por Autopilot y luego itera en función de las pruebas. El chat de depuración te ayuda a identificar las brechas en tu solicitud que deben abordarse.

Usar puntuación de agente

La puntuación de agente analiza la configuración de tu agente y proporciona recomendaciones de mejora. La puntuación evalúa:

• Calidad de la solicitud del sistema: claridad, exhaustividad, coherencia, razonamiento lógico y demostraciones.
• Configuración de la herramienta: cantidad, claridad de contexto y exhaustividad.

Para ver la puntuación de tu agente:

1. En el diseñador de agentes, busca el indicador Abrir puntuación de salud.
2. Selecciónalo para ver recomendaciones detalladas.
3. Aborda las sugerencias para mejorar la eficacia de tu agente.

Para obtener más detalles, consulta Puntuación del agente.

Selección de modelo

Los agentes conversacionales admiten varios modelos lingüísticos de gran tamaño (LLM). Selecciona un modelo en función de tus requisitos de capacidad, latencia y coste.

Para obtener más información sobre cómo elegir el modelo correcto, consulta Elegir el mejor modelo para tu agente.

Nota:

Los agentes conversacionales están disponibles con modelos gestionados por UiPath y admiten configuraciones de LLM para que puedas utilizar tus propias suscripciones de LLM.

Entradas

Las entradas son variables con nombre definidas en un agente de conversación en Data Manager y pueden incluirse en la plantilla de la solicitud del sistema y los argumentos de llamada de herramienta. Usa entradas cuando la superficie de la llamada quiera pasar contexto adicional al agente en cada turno, más allá de lo que ya se lleva en el historial de conversación.

Importante:

El historial de conversaciones (mensajes de usuario, mensajes de agente y resultados de llamadas de herramientas anteriores) ya se pasa implícitamente al agente en la ejecución de cada turno. Las entradas solo deben definirse para contexto adicional que el agente no puede derivar de la propia conversación. Comienza sin entradas personalizadas e introdúcelas cuando tu caso de uso específico las requiera.

Cómo exponen las superficies las entradas

La superficie de conversación puede establecer valores de entrada iniciales cuando inicia la conversación y también puede actualizarlos en cualquier momento durante la conversación.

• Las superficies prediseñadas como la gestión de instancias y la incrustación de iFrame proporcionan un formulario en el que el usuario rellena los valores de entrada antes o durante la conversación.
• El SDK de TypeScript de UiPath te da control directo sobre cómo se establecen los valores de entrada en tu superficie personalizada. Por ejemplo, puedes conectar entradas al estado de IU web, o a cualquier otro estado del lado del cliente, para que el agente reciba el último contexto de superficie automáticamente en cada turno.

Herramientas

Las herramientas amplían las capacidades de tu agente más allá de la conversación. Los agentes conversacionales admiten las mismas herramientas que los agentes autónomos.

Tipos de herramienta admitidos

Tipo de herramienta	Descripción	Use case
Conexión a tierra del contexto	Búsqueda de índices de la base de conocimientos	Preguntas y respuestas basadas en RAG sobre documentos
Analizar archivos	Proceso de archivos cargados con LLM	Análisis de documento, extracción de formularios
Actividades de Integration Service	Conectores prediseñados para sistemas externos	Operaciones de calendario, correo electrónico, CRM
Flujos de trabajo de API	Automatizaciones basadas en API personalizadas	Integraciones de backend
Flujos de trabajo de RPA	Automatizaciones multiplataforma y basadas en Windows	Interacciones del sistema heredado
Agentes autónomos	Ejecución de agente anidado	Tareas complejas de varios pasos
Servidores MCP	Integraciones de protocolo de contexto de modelo	Ecosistemas de herramientas externas
Modelos de Extracción y Procesamiento Inteligentes (IXP)	Procesamiento inteligente de documentos	Extracción de documento estructurado

Añadir herramientas

1. En el diseñador de agentes, selecciona Añadir herramienta.
2. Elige el tipo de herramienta y configura sus parámetros.
3. Proporciona una descripción clara de cuándo y cómo debe utilizar el agente la herramienta.

Consejo:

Para los flujos de trabajo que realizan llamadas de API exclusivamente, utiliza los flujos de trabajo de API en lugar de los flujos de trabajo de RPA para obtener un mejor rendimiento en los escenarios de chat en tiempo real.

Descripciones de las herramientas

Las descripciones de las herramientas guían al agente sobre cuándo utilizar cada herramienta. Escribe descripciones que indiquen claramente:

• Qué hace la herramienta
• Cuándo utilizarla (opcional)

Ejemplo de descripción de la herramienta

Search HR Policies: Use this tool to find information about company policies,
benefits, and HR procedures. Always use this tool before answering questions
about policies.

Barreras de seguridad de la herramienta

Aplica barreras de seguridad a las herramientas para aplicar las políticas de runtime. Las barreras de seguridad pueden:

• Restringir cuándo se puede ejecutar una herramienta.
• Validar las entradas antes de la ejecución.
• Filtrar o transformar las salidas.

Para obtener más detalles, consulta Barreras de seguridad.

Confirmaciones de llamadas de herramientas

Utilice confirmaciones de llamada de herramienta para herramientas que no deben ejecutarse hasta que el usuario revise la acción propuesta. Por ejemplo, requerir confirmación antes de que una herramienta cree un evento, envíe un correo electrónico, actualice un registro empresarial o desencadene una automatización con efectos secundarios externos.

Para requerir confirmación para una herramienta:

1. En el diseñador de agentes, selecciona la herramienta que quieres configurar.
2. En la configuración de las barreras de seguridad de la herramienta, habilita Requerir confirmación.
3. Guarda y publica el agente.

Cuando una herramienta requiere confirmación, el agente se detiene antes de ejecutar la herramienta y muestra al usuario los parámetros de entrada que planea utilizar. El usuario puede aprobar la llamada de herramienta, modificar los valores de entrada antes de la aprobación o rechazar la llamada de herramienta.

En runtime:

• Si el usuario aprueba sin cambios, la herramienta se ejecuta con las entradas originales propuestas por el agente.
• Si el usuario modifica las entradas y las aprueba, la herramienta se ejecuta con las entradas modificadas.
• Si el usuario rechaza la confirmación, la herramienta no se ejecuta.

Nota:

Las confirmaciones de llamada de herramienta se configuran por herramienta. Habilítelos para acciones en las que se requiera la revisión del usuario antes de la ejecución, y déjelos deshabilitados para herramientas de solo lectura o herramientas que sean seguras para ejecutarse automáticamente.

Context

El contexto conecta tu agente a los índices de la base de conocimientos de contextualización, lo que permite la generación aumentada por recuperación (RAG) para respuestas precisas respaldadas por citas.

Añadir un contexto

1. Selecciona Añadir contexto.
2. Elige un índice de contextualización de tus índices disponibles.
3. Configura los parámetros de búsqueda (opcional).

El agente consulta automáticamente el índice cuando es relevante para la pregunta del usuario e incluye citas en sus respuestas.

Para obtener más detalles sobre la creación y gestión de Índices, consulta Contextos.

Gestión de archivos

Los agentes conversacionales pueden procesar los archivos cargados durante el chat. Esto permite casos de uso como el análisis de documentos, el procesamiento de formularios y la interpretación de imágenes.

Habilitar cargas de archivo

Para habilitar el análisis de archivos, añade una herramienta capaz de procesar archivos:

• Analizar archivos: herramienta integrada para el análisis general de archivos utilizando LLM.
• Modelos de Extracción y Procesamiento Inteligentes (IXP): para la extracción de documentos estructurados.

Tipos de archivo compatibles

Tipo de archivo	Herramienta recomendada
Imágenes (GIF, JPE, JPEG, PNG, WEBP)	Analizar archivos
Documentos PDF	Analizar archivos, Extracción y Procesamiento Inteligentes (IXP)

Importante:

Las cargas de archivo están limitadas a 5 MB.

Escaladas

Las escaladas permiten al agente pasar las conversaciones a un humano cuando no puede resolver una solicitud de forma segura.

Cómo funcionan las escaladas

1. El agente determina que necesita asistencia humana (en función de los criterios de solicitud de tu sistema).
2. El agente crea una tarea de escalada en Action Center.
3. La conversación se detiene hasta que un humano resuelve la escalada.
4. Una vez resuelto, el agente continúa con la entrada del humano.

Configurar escaladas

1. En el diseñador de agentes, selecciona Añadir escalada.
2. Configura el tipo de escalada.
3. Recuerda definir criterios de escalada en tu solicitud de sistema.

Nota:

Las conversaciones se ejecutan de forma sincrónica durante la escalada. El agente detiene toda interacción hasta que se resuelva la escalada.

Para obtener más información, consulta Escaladas y memoria de agente.

Mejores prácticas de diseño

Comienza con un perfil claro

Define una identidad específica para tu agente en lugar de dejar que sea genérica. Un perfil claro ayuda al agente a mantener un tono y un comportamiento coherentes.

Menos efectivo: "Eres un asistente útil." Más efectivo: "Eres un asistente de RRHH amigable para Contoso Corporation que se especializa en ayudar a los empleados a comprender las políticas y los beneficios de la empresa."

Diseña para la imprevisibilidad

Los usuarios pueden proporcionar información incompleta, ambigua o incorrecta. Tu solicitud del sistema debe dar instrucciones al agente para:

• Hacer preguntas de aclaración cuando sea necesario.
• Manejar información parcial de forma elegante.
• Recuperarse de los malentendidos.

Guíar el uso de la herramienta explícitamente

No asumas que el agente sabe cuándo utilizar herramientas. Incluye instrucciones explícitas:

## Tool usage
- ALWAYS search the knowledge base before answering policy questions
- Use the calendar tool when the user asks about scheduling
- NEVER create calendar events without explicit user confirmation

Itera con evaluaciones

Crea casos de prueba tanto para escenarios esperados (ruta feliz) como para inesperados (caso límite). Actualiza la configuración de tu agente en función de los resultados de la evaluación.

Próximos pasos

• Evaluación: prueba el comportamiento de tu agente
• Implementación: publica e implementa tu agente
• Prácticas recomendadas para crear agentes: orientación de diseño adicional