Editor de solicitudes

El Editor de solicitudes es el área de texto enriquecido de Agent Builder donde escribes la solicitud del sistema y la solicitud del usuario. Los argumentos, las herramientas, los contextos, las escaladas y las salidas se representan como referencias en línea codificadas por colores, denominadas píldoras, en lugar de marcadores de posición escritos.

El Editor de solicitudes está disponible para agentes autónomos y conversacionales y se aplica a la solicitud del sistema y a la solicitud del usuario.

El desencadenador @

El editor de solicitudes utiliza una única clave de desencadenador para todos los tipos de referencia.

Al escribir @ en cualquier parte de la solicitud, se abre el selector de referencias. El selector agrupa las referencias disponibles en cinco secciones en orden fijo:

1. Entradas: argumentos que el agente recibe en runtime
2. Herramientas: herramientas conectadas al agente
3. Contexto: fuentes de contextualización
4. Escalaciones: rutas de escalada
5. Salidas: salidas de pasos anteriores, cuando corresponda

Si sigues escribiendo después de @ la lista se reduce con coincidencias difusas; no es necesario un prefijo exacto. Por ejemplo, @srch coincide con tools.web_search.

Navegación por teclado en el selector

Clave	Acción
↑ / ↓	Mueve la selección hacia arriba o hacia abajo
Tab/Mayús+Tab	Igual que las teclas de flecha
Enter	Inserta la referencia resaltada
Esc	Cierra el selector sin insertar
Selección con el ratón	Inserta la referencia seleccionada

Cuando @ no abre el selector

Para evitar la activación involuntaria durante la escritura normal, el carácter @ abre el selector solo cuando aparece:

• al principio de una línea, o
• inmediatamente después de un carácter de espacio en blanco.

Escribir [e-mail] en medio de una oración no abre el selector: @ se conserva como texto sin formato. Escribir un espacio antes de @ fuerza al selector a abrirse.

Compatibilidad con {{ }} marcadores de posición

Las solicitudes existentes que contienen {{argument_name}} siguen funcionando sin ningún paso de migración. Cuando el editor carga una solicitud, los marcadores de posición {{ }} se convierten automáticamente en píldoras en pantalla. Cuando se guarda la solicitud, las píldoras de entrada se vuelven a escribir en el almacenamiento como {{argument_name}} y las píldoras de herramienta, contexto y salida como @{tools.search}, conservando la compatibilidad con cualquier sistema de backend que lea las solicitudes como texto.

Escribir {{ ... }} directamente mientras editas no es un desencadenador de creación: se conserva como texto sin formato y solo se convierte en una píldora cuando la solicitud se guarda y se vuelve a abrir, siempre que el nombre interno coincida con un argumento existente. Usa @ para insertar referencias.

Referencias como píldoras

Cada referencia de una solicitud se representa como una píldora en línea que contiene:

• un icono de categoría
• una etiqueta: el último segmento de la ruta de referencia (por ejemplo, web_search en lugar de tools.web_search)
• un color que refleja la categoría de referencia: entradas en azul, herramientas, contextos y escaladas en verde, salidas en naranja

Las píldoras se comportan como unidades únicas:

• Las teclas de flecha mueven el cursor sobre una píldora con una pulsación de tecla.
• Retroceso o Eliminar eliminan toda la referencia.
• Cada píldora tiene un botón × al mantener el puntero para eliminarla con el ratón.
• Las píldoras pueden copiarse y pegarse en diferentes campos de solicitud en el mismo agente o en las solicitudes de otro agente. Cuando las píldoras se pegan en un destino de texto sin formato fuera del editor, vuelven al formato de texto {{...}} o @{...}.

Referencias no válidas

Cuando una referencia apunta a un recurso que ya no existe, por ejemplo, una herramienta que se eliminó o un argumento al que se cambió el nombre manualmente, la píldora se pone roja. Esta es solo una señal visual; la solicitud se guarda como está.

Puedes resolver una referencia no válida eliminando la píldora roja y seleccionando un reemplazo con @, o cambiando el nombre del recurso subyacente para que la referencia vuelva a ser válida.

Propagación automática de cambios de nombre

Cuando se cambia el nombre de una herramienta, un argumento, un contexto, una escalada o una salida dentro de la definición del agente, el editor detecta el cambio y actualiza automáticamente cada píldora que hace referencia a ella en todos los campos de la solicitud. Las rutas anidadas también se reescriben de forma coherente.

No se detectan los cambios de nombre realizados fuera de la definición del agente, por ejemplo editando JSON sin procesar directamente.

Editar y Vista previa

La barra de herramientas Arriba del editor incluye una alternancia de Edición/Vista previa.

• Editar: el modo de edición en vivo para introducir texto, aplicar formato e insertar referencias.
• Vista previa: una representación de solo lectura de la solicitud con todas las píldoras y lenguaje markdown aplicados. Usa la vista previa para verificar la apariencia final de las solicitudes largas o con gran formato antes de guardar.

Al cambiar a Vista previa se conserva el borrador actual. Al volver a Editar se devuelve al estado de edición exacto que había antes del cambio.

Barra de herramientas de formato

En el Modo de edición, la barra de herramientas expone las siguientes acciones de formato:

Botón	Efecto	Atajo del teclado
H	Alternancia de encabezado en la línea actual	—
B	Pone en negrita el texto seleccionado	—
I	Pone en cursiva el texto seleccionado	—
</>	Código en línea	—
Lista numerada	Alternancia de lista numerada	—
Lista con viñetas	Alternancia de lista con viñetas	—
Deshacer	Paso hacia atrás en las ediciones	Ctrl/⌘ + Z
Rehacer	Paso hacia adelante en las ediciones	Ctrl/⌘ + Mayúsculas + Z

El lenguaje markdown aplicado a través de la barra de herramientas se conserva palabra por palabra en la solicitud guardada y se representa con el estilo de marcado completo, incluidos encabezados, listas, bloques de código delimitados, citas y tablas, en el modo de vista previa.La barra de herramientas está deshabilitada mientras el modo de vista previa está activo.

Aspectos destacados de la cobertura

Cuando hay datos de cobertura disponibles después de ejecutar un conjunto de evaluación, aparece una alternancia de cobertura en la barra de herramientas.

Al seleccionar Cobertura, el editor cambia a Vista previa con destacados en línea que muestran qué instrucciones de la solicitud se aplicaron durante las ejecuciones de evaluación. Al seleccionar una sección resaltada, se abre una ventana emergente que enumera las ejecuciones de evaluación específicas que la cubrieron. El botón ↻ junto a la alternancia vuelve a calcular la cobertura cuando la solicitud o el conjunto de evaluación han cambiado.

Volver a Editar desactiva el resaltado de cobertura.

Revisar sugerencias de IA

Cuando Autopilot u otro asistente de IA propone reescribir tu solicitud, el editor entra en modo de diferencia:

• El contenido eliminado aparece con un tachado rojo.
• El contenido añadido aparece con un resaltado verde.
• El editor es de solo lectura mientras se muestra la diferencia.

En la parte inferior derecha del editor aparecen dos botones: Aceptar, que reemplaza la solicitud con la versión sugerida, y Rechazar, que descarta la sugerencia y restaura el original. La solicitud original se conserva exactamente hasta que se selecciona uno de estos botones.

Edición de pantalla completa

El icono Expandir del extremo derecho de la barra de herramientas abre el editor en un modal de pantalla completa. Esto es útil para las solicitudes largas en las que el espacio en pantalla disponible es limitado. Las ediciones realizadas en el modal se conservan cuando el modal se cierra.

Accesibilidad

• Se puede acceder a todos los botones de la barra de herramientas con la tecla Tab e incluyen información sobre la herramienta y aria-label.
• El selector de referencias funciona completamente desde el teclado, por lo que no se necesita un ratón para insertar cualquier referencia.
• La alternancia de Edición/Vista previa y la de Cobertura exponen su estado a través de la semántica aria-pressed.
• El editor anuncia el nombre del campo activo a los lectores de pantalla, por ejemplo, "Solicitud del sistema" a través de su configuración ariaLabel.

Preguntas frecuentes

¿Se interrumpirán las solicitudes existentes?

No. El editor lee y escribe en el mismo formato que antes, {{argument}} para las entradas y @{path} para las herramientas, contextos y salidas. Las solicitudes existentes se abren como píldoras automáticamente; no es necesario ningún paso de migración.

Can I still type {{ to insert an argument?

No. {{ }} ya no es un desencadenador de creación en el editor. Usa @ en su lugar. Cualquier {{ ... }} escrito mientras editas se conserva como texto sin formato y se convierte en una píldora solo cuando la solicitud se guarda y se vuelve a abrir, siempre que el nombre interno coincida con un argumento existente.

Does the @ trigger conflict with email addresses or social handles?

No. El selector solo se abre cuando @ aparece al inicio de una línea o directamente después de un carácter de espacio en blanco, por lo que [e-mail] en el centro de una oración se trata como texto sin formato.

¿Qué sucede si cambio el nombre de un argumento o herramienta?

El editor detecta los cambios de nombre realizados dentro de la definición del agente y actualiza cada referencia en todas las solicitudes automáticamente. Una referencia se vuelve roja solo cuando se elimina el recurso subyacente o se cambia su ruta de forma que el editor no pueda inferir.

¿Puedo deshabilitar el nuevo editor?

El Editor de solicitudes está restringido por un indicador de función durante la implementación. Para volver al editor anterior durante la ventana de implementación, ponte en contacto con tu representante de UiPath.

Ver también

• Solicitudes: solicitudes del sistema, solicitudes del usuario y guía para la escritura de solicitudes
• Definir argumentos: crea argumentos de entrada y salida y haz referencia a ellos en las solicitudes