Saltar al contenido

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.

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:

TipoQué hace¿Pregunta antes?
LecturaTrae 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 listarNo: las lecturas se ejecutan de inmediato
CambioCambia datos: cierra un ticket, actualiza un registro. Una solicitud POST, PUT o PATCHSí: en una tarjeta de aprobación, cada vez, salvo que apruebes todo

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.

  1. Hace el paso una vez en el navegador, de la forma habitual, o te mira hacerlo.
  2. 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.
  3. 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.
  4. 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.

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 POST que 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 como cmd) nombra una lectura: get, list, search y similares.
  • Cuando la comprobación no está segura, te pregunta. Si ese POST podrí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.

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"]
}
}
CampoQué dice
nameEl 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
descriptionQué hace la llamada, en una línea de hasta 300 caracteres. El agente la lee para elegir la llamada
methodGET, HEAD, POST, PUT o PATCH. DELETE no se puede guardar; consulta Límites
urlLa 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
inputSchemaLo 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
bodyPara 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
pageSolo 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.borrowLos 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
returnsjson (el valor predeterminado), text o file; un archivo llega a los archivos de la tarea
readOnlySolo 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
targetObligatorio 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)
forbiddenFieldsCampos 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
verifyPara 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ú.

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:// o https://.
  • 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.

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:

  1. 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.
  2. El agente envía la llamada desde la pestaña de esa página, a {api_url}. Los valores de Authorization y x-tenant-id se 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.
  3. 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.

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.com para app.example.com, orders.example.com y billing.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.

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.

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).

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)

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.

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 diceQué significaQué ayuda
la página no ha llamado a ese host desde esta pestañaLa llamada va a una dirección de datos que la página de esa pestaña todavía no usó en esta sesiónUsa 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ñaNo 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 prestadoUsa 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 ocultarloEl 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ó nadaEl paso se hace en la página; no hay nada que corregir
sesión cerrada / redirigido después de enviarseEl sitio respondió como si nadie tuviera la sesión iniciadaEl agente vuelve a iniciar sesión, o te lo pide, y lo intenta una vez más
página equivocada abiertaNo 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 correctaDeja una sola pestaña en el sitio
el sitio no deja que su página llame a ese host de esta formaEl navegador rechazó la solicitud según las propias reglas CORS del sitioEl paso se hace en la página; la llamada no puede funcionar tal como está escrita
la respuesta es demasiado grandeLa 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 sitioEl sitio rechazó la llamada (403) o respondió con una página de verificaciónNo 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 noEl sitio respondió con otro error, a menudo porque no aceptó un valor; el agente lee el motivo del sitioEl 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 sitioEl 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 cosaInténtalo más tarde
la llamada puede estar desactualizadaEl sitio respondió como si la llamada ya no existieraVuelve a grabar la llamada
un valor dado parece una acción, así que no se envió nadaA una lectura se le dio un valor que parece una palabra de acciónNo se envió nada; el agente vuelve a preguntar con un valor correcto o usa la página
no se pudo guardar el archivoNo se pudo guardar en los archivos de la tarea una respuesta file o una respuesta largaLos datos no le llegaron al agente; lo dice
  • Todavía no hay eliminaciones. Una llamada DELETE no 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. Un PUT o un PATCH nunca 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.
AcciónQuién
Crear llamadas en el entrenamiento o con el constructor de agentesCualquiera que pueda editar el agente
Crear llamadas con Generar con el agenteQuien pueda cambiar el flujo de navegador
Escribir o cambiar una llamada a manoCualquiera 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 habilidadCualquier tarea que cargue la habilidad
Aprobar un cambioQuien 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