Llamadas al sitio
Cuando haces clic en Cerrar en un ticket en la mayoría de las aplicaciones web, la página envía una solicitud al sitio que está detrás, y el sitio cierra el ticket. Una llamada al sitio es una de esas solicitudes, guardada en una habilidad para que el agente pueda enviarla por su cuenta. En lugar de abrir cada ticket, buscar el botón, elegir un motivo y esperar a la página, el agente cierra tres tickets con una sola llamada, desde su propio navegador, donde ya tiene la sesión iniciada en el sitio.
Una habilidad con llamadas al sitio sigue teniendo sus pasos de siempre. Cada vez que una llamada no se puede usar —el sitio la rechaza, el sitio cambió, el espacio de trabajo no permite llamadas— el agente hace ese paso en la página, como lo ha hecho siempre.
Las llamadas al sitio suelen formar parte de un flujo de navegador: un conector para un sitio web cuyas herramientas llevan, cada una, las llamadas de un área de trabajo. Cómo organizarlo está en Organizar un flujo de navegador.
Qué es una llamada al sitio
Sección titulada «Qué es una llamada al sitio»Una llamada al sitio es un archivo en los Scripts de una habilidad, dentro
de calls/; por ejemplo, calls/close_ticket.json. Dice qué solicitud enviar,
qué debe completar el agente y qué puede cambiar la llamada y qué no. Una
habilidad tiene hasta 20 llamadas.
Cuando una tarea usa una, la solicitud sale desde la pestaña del navegador del agente en ese sitio, en nombre de quien tenga la sesión iniciada ahí: la misma solicitud que habría enviado la página del sitio. El sitio tiene que estar abierto en esa pestaña. Una llamada va solo al propio sitio o a las direcciones de datos que usa su propia página; una llamada a cualquier otro sitio no se envía.
Hay dos tipos de llamadas:
| Tipo | Qué hace | ¿Pregunta antes? |
|---|---|---|
| Lectura | Trae datos: una lista de tickets abiertos, los detalles de un ticket, un informe. Una solicitud GET o HEAD, o un POST que el sitio usa solo para buscar o listar | No: las lecturas se ejecutan de inmediato |
| Cambio | Cambia datos: cierra un ticket, actualiza un registro. Una solicitud POST, PUT o PATCH | Sí: en una tarjeta de aprobación, cada vez, salvo que apruebes todo |
Cómo se crean las llamadas al sitio
Sección titulada «Cómo se crean las llamadas al sitio»Hay tres maneras, y cada una termina con la aprobación de una persona o con su propia edición.
1. Entrena al agente. En una sesión de entrenamiento haces el trabajo en la computadora del agente, tú mismo o dejando que el agente lo haga mientras miras. Mientras se usa el sitio, el agente puede ver las solicitudes que envía la página del sitio: sus direcciones, los nombres de sus campos y de sus encabezados y la forma de cada respuesta, no los valores que contienen; los valores están en una grabación del paso. Escribe una llamada para cada paso que valga la pena convertir, comprueba cada una contra lo que se vio enviar al sitio y guarda la habilidad en Aprendido hasta ahora. Cuando pulsas Guardar · N, la tarjeta describe cada llamada con palabras sencillas:
- «get_ticket» lee: Read one ticket: its status, assignee and notes. (GET /api/tickets/{id}) de desk.example.com
- «close_ticket» cambia datos: PUT /api/tickets/{id}/status en desk.example.com — nunca cambia assignee, priority — se vuelve a leer con «get_ticket» después — siempre envía status = closed
Cada valor que una llamada envía siempre, rellene lo que rellene el agente, aparece en una línea siempre envía, para que veas los valores fijos antes de aprobar (una lista larga se acorta a unas pocas líneas y cuántos más hay). Una credencial, o un valor de un campo con nombre de contraseña, token o clave, se nombra pero nunca se muestra: siempre envía token (una credencial, oculta).
Aprobar guarda la habilidad con sus llamadas. Una llamada que escribió el agente solo se puede guardar si pasó su comprobación con exactamente el contenido que se guarda, así que una llamada que cambias en la tarjeta tiene que volver a comprobarla el agente antes de poder guardarse.
Generar con el agente, en un flujo de navegador, funciona igual para las herramientas de un flujo: usan el sitio juntos en la computadora de la sesión, el agente encuentra y comprueba las solicitudes, y la tarjeta de su propuesta guarda las herramientas con sus llamadas.
2. Pídeselo al constructor de agentes. En Crear o Refinar, con la computadora de Pruébalo abierta y a la vista, usa el sitio en esa computadora —o deja que lo use el asistente— y pídele que convierta un paso en una llamada al sitio. Comprueba cada llamada de la misma manera y agrega la habilidad a tu borrador, donde la sección Habilidades muestra sus llamadas. Guardar el agente es la aprobación: la habilidad se guarda como una de las habilidades propias del agente. El constructor nunca envía una llamada de cambio, ni siquiera para probarla.
3. Escríbela a mano. Cualquiera que pueda editar una habilidad puede
agregar una llamada: en la página de la habilidad, en su panel del constructor
de agentes o en el Editor de una herramienta de un flujo de navegador, elige
Agregar script y dale una ruta como calls/close_ticket.json. Una llamada
escrita a mano se revisa en busca de errores al guardar, pero no contra el
sitio, y la habilidad lo indica: Escrita a mano, sin comprobar contra el
sitio.
Cómo encuentra el agente una solicitud
Sección titulada «Cómo encuentra el agente una solicitud»- Hace el paso una vez en el navegador, de la forma habitual, o te mira hacerlo.
- Lee la lista de solicitudes que envió la página en esa pestaña: el método y la dirección de cada una, los nombres de sus campos de consulta y de cuerpo, los nombres de los encabezados que llevaba y la forma de su respuesta, no los valores. Cuando una llamada necesita un valor que la página nunca muestra, como el de un campo oculto, lee lo que envió la página en una grabación del paso, con las credenciales ocultas, o te pide que grabes el paso una vez.
- Solo toma una solicitud que hizo la propia página del sitio. Nunca adivina una dirección, y nunca convierte en llamada una solicitud de inicio de sesión, de seguridad, de tokens o de analítica.
- Para un cambio, lee las reglas del propio formulario del sitio —campos obligatorios, longitudes, patrones, las opciones de una lista— sin enviarlo, y las escribe en los datos de entrada de la llamada. Si no puede ver una regla, te pregunta.
Cómo se comprueba una llamada
Sección titulada «Cómo se comprueba una llamada»Antes de que se pueda guardar una llamada que escribió el agente, el agente la comprueba contra el sitio, en la misma sesión:
- La página del sitio tiene que haber hecho esa solicitud en esa sesión: el mismo método, la misma dirección, los mismos campos de consulta y de cuerpo y los mismos encabezados prestados. Una llamada que deja fuera un encabezado de inicio de sesión que envió la página no pasa la comprobación, porque el sitio la rechazaría.
- Una lectura se ejecuta una vez de verdad, y su respuesta se le muestra al
agente. Un
POSTque el sitio usa solo para buscar o listar se ejecuta de verdad en una comprobación solo cuando la propia página envió exactamente esa solicitud a la misma dirección, el sitio la respondió con éxito, y su dirección (o un campo comocmd) nombra una lectura: get, list, search y similares. - Cuando la comprobación no está segura, te pregunta. Si ese
POSTpodría cambiar algo —su dirección no es exactamente la de la página, sus campos son otros, no nombra una lectura o una palabra suya puede nombrar una acción—, una tarjeta pregunta ¿Enviarla una vez de verdad?, con exactamente la solicitud y el motivo de la duda. Aprobar envía exactamente esa solicitud una vez; Rechazar no envía nada. Ni Aprobar todo, ni un nivel de aprobación, ni siquiera No preguntar nunca, ni una automatización la responden por ti, y una prueba de habilidad nunca la envía. - Un cambio se arma y se muestra, pero no se envía. Si nombras un registro que se puede cambiar sin riesgo, el agente también puede hacer ese único cambio de verdad mientras la comprueba: en una tarjeta de aprobación, y solo después de que lo apruebes. Nunca cambia un registro que no nombraste.
- La comprobación cubre el contenido exacto. Si cambias algo después —la regla de un dato, la descripción, incluso un espacio— hay que volver a comprobar la llamada antes de poder guardarla.
- Ninguna credencial en una llamada. Una llamada que lleva escrita una contraseña, un token, una clave o una cadena de conexión no pasa la comprobación y se rechaza al guardarla, la haya escrito el agente o la hayas editado tú. Una llamada toma prestado el inicio de sesión de la página; nunca lleva uno.
Exportar lo comprobado. Pídele al agente que exporte sus llamadas
comprobadas: escribe cada una, tal como se comprobó y con cualquier credencial
oculta, como un archivo en la computadora del agente, en out/site-calls/. Es
útil cuando una llamada se comprobó al principio de una sesión larga. Para
descargar una, pídele al agente que la añada a los archivos de la tarea.
En un espacio de trabajo que guarda datos regulados, las llamadas no se ejecutan contra el sitio: solo se comprueban el archivo y su coincidencia con las solicitudes de la página.
Un ejemplo
Sección titulada «Un ejemplo»Una mesa de servicio en desk.example.com muestra cada ticket en su propia
página, y la página lo lee con una solicitud y lo cierra con otra. Una habilidad
para cerrar tickets resueltos podría llevar estas dos llamadas.
calls/get_ticket.json, una lectura:
{ "name": "get_ticket", "description": "Read one ticket: its status, assignee and notes.", "method": "GET", "url": "https://desk.example.com/api/tickets/{id}", "inputSchema": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[0-9]+$" } }, "required": ["id"] }, "returns": "json"}calls/close_ticket.json, un cambio:
{ "name": "close_ticket", "description": "Close one ticket with a reason and an optional note.", "method": "PUT", "url": "https://desk.example.com/api/tickets/{id}/status", "inputSchema": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[0-9]+$" }, "reason": { "type": "string", "enum": ["Resolved", "Duplicate"] }, "note": { "type": "string", "maxLength": 200 } }, "required": ["id", "reason"] }, "body": { "kind": "json", "template": { "status": "closed", "reason": "{reason}", "note": "{note}" } }, "auth": { "borrow": ["x-csrf-token"] }, "target": { "param": "id", "label": "Ticket" }, "forbiddenFields": ["assignee", "priority"], "verify": { "call": "get_ticket", "params": { "id": "{id}" }, "ignore": ["status", "closedAt", "updatedAt"] }}Cada campo
Sección titulada «Cada campo»| Campo | Qué dice |
|---|---|
name | El nombre de la llamada: letras minúsculas, dígitos y _, empezando por una letra, hasta 40 caracteres. Tiene que ser también el nombre del archivo: close_ticket vive en calls/close_ticket.json |
description | Qué hace la llamada, en una línea de hasta 300 caracteres. El agente la lee para elegir la llamada |
method | GET, HEAD, POST, PUT o PATCH. DELETE no se puede guardar; consulta Límites |
url | La dirección, de hasta 2.000 caracteres. Empieza con una dirección fija del sitio (https://desk.example.com/…, o http:// para un sitio que se sirve así) o con una de las variables de la habilidad seguida de una ruta ({site_url}/api/…; consulta Direcciones y ajustes). Los espacios en blanco del tipo {id} de la ruta y de la consulta se completan con los datos de entrada. La dirección del sitio nunca puede venir de un dato de entrada, el nombre de un campo de consulta nunca puede ser un espacio en blanco, y no hay #fragmento |
inputSchema | Lo que el agente debe proporcionar: un objeto cuyas properties (hasta 50) son cada una string, integer, number o boolean, con required para las que hay que dar. Una propiedad puede llevar description, enum (una lista de valores permitidos), pattern (hasta 200 caracteres), minLength y maxLength, minimum y maximum, o format (date o date-time). allOf con pares if / then puede hacer que un dato sea obligatorio solo cuando otro tiene un valor dado. Un valor que rompe una regla no se envía |
body | Para un cambio, los campos que se envían, como json o como formulario (form), escritos como una plantilla (template) con espacios en blanco. Envía los campos que envió la página: todos los que siempre envió y ninguno que nunca envió. Un valor opcional que el agente no da tampoco se incluye en la solicitud |
page | Solo para un sitio cuyos datos viven en otra dirección: la dirección de la página desde la que se envía la llamada, como {site_url}. Consulta Sitios cuyos datos viven en otra dirección |
auth.borrow | Los nombres de los encabezados de inicio de sesión que envía la propia página del sitio con esa solicitud, como x-csrf-token, x-xsrf-token, authorization o cualquier x-…-token. Sus valores se toman prestados de la página en el momento de la llamada; nunca se escriben en el archivo. No se pueden incluir cookie, host ni los encabezados que pone el propio navegador |
returns | json (el valor predeterminado), text o file; un archivo llega a los archivos de la tarea |
readOnly | Solo en un POST que el sitio usa para buscar o listar: true lo convierte en lectura. Su dirección y su cuerpo no pueden nombrar una acción, y un dato de entrada en su ruta tiene que tener un enum o un pattern. Cada lugar que muestra la llamada dice Este POST se trata como una lectura, así que se ejecuta sin tarjeta |
target | Obligatorio en un cambio: qué dato de entrada identifica el registro (tiene que ser obligatorio) y cómo llamarlo en la tarjeta de aprobación (Ticket 4812) |
forbiddenFields | Campos que esta llamada nunca debe enviar, y que el sitio nunca debe cambiar de paso (assignee, approvedBy). Una llamada cuyo cuerpo nombra uno no se puede guardar. Un campo que el cambio debe alterar va en verify.ignore |
verify | Para un cambio: una llamada de lectura de la misma habilidad (nunca la propia llamada), con los datos que hay que darle, que se ejecuta antes y después de cada cambio para comprobar qué cambió de verdad. ignore enumera los campos que el cambio debe alterar o que el sitio actualiza por su cuenta |
Una llamada que escribió el agente también lleva un registro de la solicitud con
la que se comparó (observed); esa parte nunca la escribes tú.
Direcciones y ajustes
Sección titulada «Direcciones y ajustes»Una llamada de un flujo de navegador sirve para todas las empresas que usan el flujo, porque su dirección empieza con una de las variables del flujo y no con el sitio de una empresa:
"url": "{site_url}/api/tickets/{id}"Cada empresa completa su propio valor de site_url al crear su conector, y la
llamada se arma con ese valor cuando se ejecuta la tarea. Se cumplen tres
reglas:
- Una variable al principio de una dirección es solo la dirección del
sitio:
https://desk.example.com, con o sin/final. Un valor con ruta, consulta o nombre de usuario (https://desk.example.com/app) se rechaza al armar la llamada: The variable “site_url” must be the site’s address only (like https://host), with no path, query or sign-in. Si el sitio vive bajo una ruta, pon la ruta en la llamada:{site_url}/app/api/tickets/{id}. - Tiene que ir seguida de una ruta, y tiene que ser una de las variables
del propio flujo. Dale a esa variable el tipo Dirección web, para que los
ajustes del conector rechacen todo lo que no sea una dirección
http://ohttps://. - Otras variables pueden aparecer dentro de la dirección o del cuerpo, como
una empresa o una región de tipo Texto (
{site_url}/api/{tenant}/orders). Solo las variables de tipo Dirección web cuentan como direcciones del flujo cuando se comparten encabezados de inicio de sesión entre ellas; una variable de tipo Texto que contiene una dirección nunca cuenta.
Sitios cuyos datos viven en otra dirección
Sección titulada «Sitios cuyos datos viven en otra dirección»Muchas aplicaciones web inician tu sesión en una dirección y traen sus datos de
otra: la página que usas es app.example.com, mientras que sus listas y
registros vienen de api.example.com. La página inicia sesión una vez, guarda
un token de sesión y lo envía con cada solicitud a la dirección de los datos,
normalmente como un encabezado Authorization: Bearer …, a menudo junto a un
encabezado de empresa o de idioma.
Una llamada para un sitio así indica con page la página desde la que se envía:
{ "name": "list_open_orders", "description": "Every open order, newest first.", "method": "GET", "url": "{api_url}/orders?status=open", "page": "{site_url}", "auth": { "borrow": ["authorization", "x-tenant-id"] }, "returns": "json"}Qué pasa cuando el agente la usa:
- Se inicia sesión en la página de
{site_url}, en el navegador del agente: lo hace el agente con un inicio de sesión guardado, o tú en la vista en vivo. La página llama entonces a su dirección de datos como siempre. - El agente envía la llamada desde la pestaña de esa página, a
{api_url}. Los valores deAuthorizationyx-tenant-idse toman prestados de la solicitud más reciente de la propia página a esa dirección: el token nunca se guarda, nunca se escribe en la habilidad y nunca se le muestra al agente. - Las reglas del propio sitio sobre qué páginas pueden llamarlo (su configuración CORS) se aplican igual que para la página. Si el sitio no deja que su página haga la llamada, se le dice al agente y hace el paso en la página.
Las reglas que lo mantienen seguro:
- Solo las direcciones que usa la propia página. Una llamada va a otra dirección solo si la página de esa pestaña ya la llamó durante la sesión de la computadora, o si llamó a otra de las direcciones de datos del mismo flujo, según la regla de más abajo. El agente no puede dirigir una página con sesión iniciada a una dirección que elija él. Hasta entonces, la transcripción dice la página no ha llamado a ese host desde esta pestaña.
- El encabezado tiene que haberse visto. Un encabezado prestado viene de lo que la página envió desde esa pestaña. Si la página todavía no lo envió, no se envía nada: The page has not sent authorization to api.example.com from this tab yet. Use the site’s page once (or reload it), then check again.
- Todo lo demás no cambia. Las lecturas se hacen al momento, los cambios piden permiso en una tarjeta, el registro tiene que haberse visto en la tarea y cada respuesta se limpia de valores de sesión antes de que el agente la lea.
En un flujo de navegador, declara cada dirección como una variable de tipo
Dirección web —site_url para la página y api_url para la dirección de
los datos— y las llamadas las usan como {site_url} y {api_url}. Los
encabezados cortos que no son secretos, como un id de empresa o de idioma, se
envían tal cual; un token de sesión corto se rechaza, porque no se podría
mantener fuera de la respuesta.
Un sitio, varias direcciones de datos
Sección titulada «Un sitio, varias direcciones de datos»Algunos sitios reparten sus datos entre varias direcciones, y la página envía su
token de sesión solo a algunas: envía Authorization a orders.example.com,
por ejemplo, mientras que la llamada que necesitas va a billing.example.com,
a la que la página llega de otra manera. Entonces una llamada puede usar los
encabezados de inicio de sesión que la página envió a otra de las direcciones
de datos del mismo flujo de navegador, solo cuando se cumplen las tres cosas:
- Las dos direcciones son ajustes de ese flujo. La dirección de la propia
llamada y la que presta son valores de variables de tipo Dirección web del
flujo (
{orders_url},{billing_url}). Una dirección que no es una de ellas nunca presta ni toma prestado. - Las dos están en el mismo sitio que la página: el mismo dominio
registrable, como
example.comparaapp.example.com,orders.example.comybilling.example.com. - La propia página llamó a la dirección que presta, desde la misma pestaña.
La dirección de la propia página ({site_url}) nunca presta: solo prestan las
direcciones de datos. Un encabezado que la página envió a la dirección de la
propia llamada siempre gana sobre uno prestado, y un valor prestado se limpia de
la respuesta como cualquier otro.
Nunca se comparten: los nombres de intranet (tms o tms.corp), las
direcciones IP y los dominios de alojamiento compartido en los que la aplicación
de cada cliente es un sitio aparte, por ejemplo una dirección que termina en
azurewebsites.net, herokuapp.com, github.io o cloudfront.net. Ahí cada
dirección necesita los encabezados que la página le envió a ella. Una
computadora que todavía no tiene la última actualización tampoco comparte nada.
Varios registros en una llamada
Sección titulada «Varios registros en una llamada»El agente puede darle a una llamada varios conjuntos de datos a la vez, sus elementos:
- Una lectura acepta hasta 10 elementos: diez tickets leídos en una llamada.
- Un cambio acepta hasta 25 elementos, y una sola tarjeta de aprobación los cubre, con cada registro y los valores que va a poner. Más registros necesitan otra llamada, y otra tarjeta.
Los pasos de una habilidad deberían decirlo: Llama a «close_ticket» una vez, con todos los tickets que hay que cerrar (hasta 25 por llamada). Si se rechaza o falla, haz el paso en la página. No deberían pedir además tu aprobación en la conversación: la tarjeta es la aprobación, y preguntar dos veces solo te hace perder tiempo.
Respuestas largas
Sección titulada «Respuestas largas»Una lectura puede traer mucho más de lo que el agente debería arrastrar por la conversación: un mes de facturas, miles de filas. Una respuesta de más de unos 20 KB se guarda como archivo en los archivos de la tarea, igual que el resultado grande de un conector:
- El agente recibe la ruta del archivo y una vista previa breve, y lee el archivo con un script en su computadora. Los conteos, los totales y los filtros se calculan sobre todas las filas del archivo, nunca a partir de la vista previa y nunca volviendo a teclearlas. Una lista de diez filas o más se guarda además como archivo de datos para eso.
- Puedes abrirlo y descargarlo. El archivo aparece en la pestaña Documentos del panel lateral de la tarea, en Artefactos del agente, y se abre en el visor de archivos; ahí una respuesta JSON larga en una sola línea se presenta ordenada para leerla, mientras que la descarga es la respuesta tal como la envió el sitio.
- Sigue la regla de los conectores. Se retira de la computadora del agente unos minutos después de llegar, y se vuelve a colocar cuando uno de los scripts del agente lo necesita. Se puede abrir y descargar durante una hora desde que se obtuvo, porque los datos de un sitio se desactualizan; después, el agente vuelve a llamar al sitio. Un registro que el agente leyó del archivo cuenta como visto en la tarea mientras el archivo se conserva.
- Hasta 8 MB. Una respuesta más larga no se lee: se le indica al agente que pida menos (un filtro, una página más pequeña, un rango de fechas más corto).
- Nunca se corta por la mitad. Si parte de una respuesta no le llegó al agente, se le dice y no puede enviar nada que dependa de ella, como con un conector; consulta Cuando los datos de un conector llegan incompletos.
Una lectura de varios elementos conserva todas las respuestas. Cuando el agente lee más de un elemento en una llamada, la respuesta de cada uno también se guarda como archivo, aunque sea corta, para que un script pueda trabajar sobre todas. Esto necesita un agente que pueda ejecutar scripts en su computadora; si no, las respuestas llegan en la conversación.
Una habilidad cuyas lecturas pueden ser largas debería decirlo en sus pasos: Una respuesta larga llega como archivo: cuéntala, súmala o fíltrala con un script que lea ese archivo. La línea de la transcripción sigue contando cada elemento: Se leyeron 1.901 elementos de desk.example.com (GET, 200).
Qué las hace seguras
Sección titulada «Qué las hace seguras»Las lecturas se ejecutan sin preguntar; los cambios siempre preguntan. Cada llamada de cambio espera en una tarjeta de aprobación de hasta 25 registros —El agente quiere ejecutar “close_ticket” de “‹habilidad›” en desk.example.com para 3 registros. ¿Lo permites?— que muestra cada registro y los valores que va a poner. Aprobar hace esos cambios una vez, Aprobar todo cubre también los cambios posteriores de llamadas al sitio en la tarea, y Rechazar no envía nada. En una tarea que inició una automatización que se ejecuta sola, los cambios se hacen sin tarjeta, y la transcripción indica que cada uno se hizo sin preguntar, como con las demás acciones del agente.
El registro debe haberse visto en la tarea. Un cambio solo se envía para un registro cuyo identificador vino de una respuesta anterior en la misma tarea —de una llamada al sitio o de un conector, incluida una respuesta larga guardada— o de tu propio mensaje. Un identificador que el agente inventó, o que copió mal, no se envía.
Lectura antes y después. Una llamada de cambio con verify lee el registro
antes y después de cada cambio. Si cambió algo más de lo que la llamada debe
cambiar, la transcripción dice cambió más de lo esperado y el resto del lote
se detiene. Los campos que todo cambio toca por sí solo —updatedAt,
version, etag y similares— no cuentan.
Campos protegidos. Los campos de forbiddenFields nunca se envían, y la
lectura posterior avisa si alguno cambió.
A su ritmo. Los cambios van de uno en uno, con al menos un segundo entre ellos, y una tarea cambia como máximo 500 registros de esta manera; a partir de ahí, una tarea nueva continúa el trabajo.
Un sitio que rechaza detiene las llamadas. Si el sitio rechaza una llamada, o responde con una página de verificación, el agente no envía más llamadas a ese sitio en la tarea y hace el paso en la página. Si al agente se le cerró la sesión, vuelve a iniciarla en el navegador, o te pide que lo hagas en la vista en vivo, y lo intenta de nuevo.
Un sitio que cambió vuelve a la página. Cuando un sitio responde que la llamada ya no existe, no se envía nada más, el agente hace el paso en la página y la transcripción anota ‹llamada›: La llamada necesita volver a grabarse. Grábala de nuevo con el entrenamiento, el constructor o Generar con el agente.
Un cambio nunca se envía dos veces por su cuenta. Si el sitio falla mientras se hace un cambio, al agente se le dice que puede haberse aplicado o no, y lee el registro antes de volver a intentarlo. La transcripción dice Puede que se haya cambiado Ticket 4812 en desk.example.com.
Los tokens y las cookies se quedan en el navegador. Los valores de inicio de sesión que necesita una llamada se toman prestados de la página en el momento en que se envía: encabezados de hasta 32 KB cada uno, así que también funcionan los tokens de sesión largos que usan algunos sitios. Nunca se guardan, nunca se escriben en una habilidad y nunca se muestran al agente ni en la transcripción; todo lo que el sitio devuelve se limpia de ellos antes de que el agente lo lea. Una respuesta que todavía lleva el token de la página, aunque sea codificado, no se entrega. Los scripts del propio agente en la computadora no pueden llegar al navegador con la sesión iniciada.
Se ocultan las credenciales con una forma reconocible. Se llame como se
llame su campo, un valor se muestra como [hidden:secret] cuando tiene la
forma de una credencial: una cadena de conexión con contraseña, un token de
inicio de sesión, una clave privada, una dirección web con una contraseña o una
clave de API en un formato conocido. Se oculta en una grabación, en la
respuesta de una llamada y en las tarjetas. Una contraseña o un token que
parece texto corriente puede no reconocerse, y entonces no se oculta. Un
archivo que guarda una llamada conserva los valores originales del sitio en la
computadora del agente; lo que el agente lee de él sí se oculta. Un archivo
guardado con demasiadas credenciales para ocultarlas una a una se le retiene
entero al agente, y se le dice.
Se ejecuta lo que se guardó. Una tarea ejecuta las llamadas tal como estaban guardadas cuando cargó la habilidad. Un guardado hecho mientras la tarea está en marcha se aplica desde la siguiente tarea, y nada en la computadora puede cambiar lo que hace una llamada.
Cada llamada deja una línea en la transcripción:
- Se leyeron 42 elementos de desk.example.com (POST, 200)
- Se cambió Ticket 4812 en desk.example.com (PUT, 200)
- No se cambió Ticket 4812 en desk.example.com: rechazado por el sitio (403)
Pruebas de habilidades
Sección titulada «Pruebas de habilidades»Cuando se prueba una habilidad con llamadas —una prueba de habilidad en una sesión de entrenamiento, o una prueba de habilidad en una tarea—, sus llamadas de lectura se ejecutan de verdad y sus llamadas de cambio nunca se envían. Un cambio en una prueba se responde como un ensayo, sin enviar nada al sitio.
Cuando una llamada no sale
Sección titulada «Cuando una llamada no sale»Una llamada que no se puede enviar, o cuya respuesta no se puede usar, termina en una línea como No se pudo leer de api.example.com: la página no ha llamado a ese host desde esta pestaña. Entonces el agente hace el paso en la página, o lo intenta de nuevo cuando la causa desaparece. Qué significa cada motivo:
| La línea dice | Qué significa | Qué ayuda |
|---|---|---|
| la página no ha llamado a ese host desde esta pestaña | La llamada va a una dirección de datos que la página de esa pestaña todavía no usó en esta sesión | Usa la página del sitio una vez para que cargue sus datos, y el agente vuelve a llamar. Para un sitio con varias direcciones de datos, consulta Un sitio, varias direcciones de datos |
| la página aún no envió ‹encabezado› desde esta pestaña | No se ha visto, en las solicitudes de la página a esa dirección, un encabezado de inicio de sesión que la llamada toma prestado | Usa la página una vez, o recárgala, después de iniciar sesión. Si la página nunca envía ese encabezado a esa dirección, el auth.borrow o la dirección de la llamada están mal |
| el encabezado ‹encabezado› es demasiado corto para ocultarlo | El valor de inicio de sesión del propio sitio es demasiado corto para mantenerlo fuera de la respuesta sin riesgo, así que no se envió nada | El paso se hace en la página; no hay nada que corregir |
| sesión cerrada / redirigido después de enviarse | El sitio respondió como si nadie tuviera la sesión iniciada | El agente vuelve a iniciar sesión, o te lo pide, y lo intenta una vez más |
| página equivocada abierta | No hay ninguna pestaña en el sitio de la llamada, o hay más de una; al agente se le pide que cierre las demás y deje la que tiene la sesión de la cuenta correcta | Deja una sola pestaña en el sitio |
| el sitio no deja que su página llame a ese host de esta forma | El navegador rechazó la solicitud según las propias reglas CORS del sitio | El paso se hace en la página; la llamada no puede funcionar tal como está escrita |
| la respuesta es demasiado grande | La respuesta pasa de 8 MB (256 KB para un cambio, o en una computadora sin la última actualización) | Pide menos: un filtro, una página más pequeña, un rango de fechas más corto |
| rechazado por el sitio | El sitio rechazó la llamada (403) o respondió con una página de verificación | No se envían más llamadas a ese sitio en esta tarea. Comprueba que la cuenta pueda hacerlo en la página |
| el sitio dijo que no | El sitio respondió con otro error, a menudo porque no aceptó un valor; el agente lee el motivo del sitio | El agente corrige el valor, o hace el paso en la página |
| el sitio dijo que falló | El sitio respondió, pero su respuesta dice que el cambio no funcionó | El agente lee por qué, y hace el paso en la página si no lo puede arreglar |
| error del sitio | El sitio tuvo un error propio. Una lectura se intenta dos veces; un cambio puede haberse aplicado o no, y se vuelve a leer antes de cualquier otra cosa | Inténtalo más tarde |
| la llamada puede estar desactualizada | El sitio respondió como si la llamada ya no existiera | Vuelve a grabar la llamada |
| un valor dado parece una acción, así que no se envió nada | A una lectura se le dio un valor que parece una palabra de acción | No se envió nada; el agente vuelve a preguntar con un valor correcto o usa la página |
| no se pudo guardar el archivo | No se pudo guardar en los archivos de la tarea una respuesta file o una respuesta larga | Los datos no le llegaron al agente; lo dice |
Límites
Sección titulada «Límites»- Todavía no hay eliminaciones. Una llamada
DELETEno se puede guardar. El agente elimina en la página, preguntando antes como siempre. - Una lectura que parece una acción se rechaza al guardar. Una lectura cuya
dirección contiene una palabra de acción —close, update, save, delete,
create, send y similares— no se puede guardar, aunque sea inofensiva
(
/post/{id}). Entonces el agente hace ese paso en la página. UnPUTo unPATCHnunca es una lectura. - Desactivadas en espacios de trabajo regulados. En un espacio de trabajo que guarda datos regulados, ninguna tarea usa llamadas al sitio, y ahí no se pueden comprobar contra el sitio.
- Hace falta una computadora actualizada. Hasta que la computadora de una tarea tenga la actualización, el agente usa la página.
- El inicio de sesión sigue en la página. Iniciar sesión, las comprobaciones de seguridad y todo lo que tenga que ver con contraseñas nunca son llamadas al sitio; el agente inicia sesión en la página, con un inicio de sesión guardado o con tu ayuda.
- Límites fijos. Hasta 20 llamadas por habilidad, 10 elementos por lectura, 25 registros por tarjeta de aprobación y 500 registros cambiados por tarea, a un cambio por segundo. Todavía no se pueden ajustar por sitio.
- Las respuestas tienen un tamaño máximo. La respuesta de una lectura puede llegar a 8 MB, y una de más de unos 20 KB se guarda como archivo. La respuesta de un cambio se lee hasta 256 KB, igual que toda respuesta en una computadora que todavía no tiene la última actualización. Una llamada que devuelve un archivo puede traer uno de hasta 25 MB a los archivos de la tarea.
Quién puede hacer qué
Sección titulada «Quién puede hacer qué»| Acción | Quién |
|---|---|
| Crear llamadas en el entrenamiento o con el constructor de agentes | Cualquiera que pueda editar el agente |
| Crear llamadas con Generar con el agente | Quien pueda cambiar el flujo de navegador |
| Escribir o cambiar una llamada a mano | Cualquiera que pueda editar la habilidad; en una habilidad propia de un agente, cualquiera que pueda editar el agente; en una herramienta de un flujo de navegador, quien pueda cambiar el flujo |
| Usar las llamadas de una habilidad | Cualquier tarea que cargue la habilidad |
| Aprobar un cambio | Quien responda la tarjeta de aprobación de la tarea, como con cualquier otra aprobación |
| Responder ¿Enviarla una vez de verdad? | Quien responda las tarjetas de la tarea; Aprobar todo nunca la cubre |