Saltar al contenido

Documentación

Ejemplos reales

Dos conversaciones tal como ocurren, con las llamadas a herramientas incluidas. La primera lleva un error de validación a propósito, porque ver al asistente corregirse explica el diseño mejor que cualquier párrafo.

Montar una página desde cero

Un token con alcance de leer y escribir, sobre una página que todavía no tiene nada. El asistente lee primero, falla una llamada y la arregla con lo que le contestó el servidor.

  1. Tú

    Tengo un taller pequeño de bicis. Móntame la página: qué hago, un precio para las tres reparaciones más comunes, mi horario y un formulario para pedir cita.

  2. Asistente

    Miro qué tiene ahora la página y qué bloques puedo usar.

  3. Llamadalist_pages

    RespuestaUna página, en borrador, que alcanza este token.

  4. Llamadaget_page

    RespuestaUna cabecera y un grupo vacío.

  5. Llamadalist_block_kinds

    RespuestaTodos los tipos de bloque con sus variantes y sus diseños.

  6. Asistente

    Voy a añadir servicios, precios, horario y una razón de contacto. Empiezo por precios.

  7. Llamadaadd_block

    RespuestaRechazada. Variante price-table desconocida para un bloque de precios. Variantes válidas: list, cards, compact.

  8. Asistente

    Esa variante no existe. El catálogo ofrece list, cards y compact, y cards se lee mejor en el móvil, así que uso esa.

  9. Llamadaadd_block

    RespuestaBloque de precios añadido, con las tres reparaciones y su precio.

  10. Llamadaadd_block

    RespuestaServicios, horario y la razón de contacto añadidos al mismo grupo.

  11. Llamadapreview_page

    RespuestaUn enlace de vista previa del borrador.

  12. Asistente

    El borrador tiene cuatro bloques y un formulario de cita. Abre el enlace, léelo con tu voz y publícalo tú cuando suene bien. Este token no puede publicar.

Lo interesante es la llamada rechazada. El servidor no dijo que no, dijo qué tres variantes existen, así que el siguiente intento salió bien sin preguntarte nada.

Un cambio en varias páginas

El mismo token, tres páginas y un dato que cambió. El asistente va página por página y se para antes de publicar.

  1. Tú

    El estudio se ha mudado. Cambia la dirección en las tres páginas y déjamelas listas para revisar.

  2. Asistente

    Miro qué páginas alcanza este token.

  3. Llamadalist_pages

    RespuestaTres páginas: estudio, taller y cursos.

  4. Llamadaget_page

    RespuestaCada una lleva un bloque de ubicación con la dirección vieja.

  5. Llamadaupdate_block

    RespuestaDirección cambiada en los tres borradores, una llamada por cada uno.

  6. Llamadapreview_page

    RespuestaTres enlaces de vista previa, uno por página.

  7. Asistente

    Tres borradores cambiados y tres enlaces para revisar. Nada está publicado: este token no tiene alcance de publicar, y aun teniéndolo la última palabra seguiría siendo tuya.

Tres páginas y siete llamadas, todas sobre el borrador. Lo que ven los visitantes no se movió hasta que lo decidiste tú.