Ejemplos de trabajo con el Connector
Encuentra prompts de ejemplo y las llamadas a herramientas previstas.
En esta página
Elige un prompt de ejemplo y adapta los nombres de proyecto y el dominio a tu Space. Un Space es un espacio de trabajo compartido en la app.
Nota
Escribe el prompt en una conversación donde el Connector esté activado. La conexión se aplica al Space y el Space no está bloqueado.
Los prompts que hacen cambios o leen un archivo requieren el rol Usuario o superior; consultar funciona con cualquier rol. Las publicaciones, los proyectos y los dominios cuentan para los límites de tu plan.
La aplicación decide qué herramientas ejecuta realmente. La página explica lo que debe provocar un prompt.
Atención
Un borrador recién creado empieza vacío. Si cambias un archivo de un proyecto existente mediante el Connector y publicas, la nueva versión solo contiene lo que haya en el borrador. Más información en Un borrador se convierte en una versión.
Cómo leer los ejemplos
- Los prompts en inglés proceden de los ejemplos vinculantes; su versión en alemán aparece en cada desplegable y se conserva como parte del ejemplo original. Sustituye los nombres de proyecto de demostración por los tuyos.
- La aplicación debe identificar primero el Space con
whoamiy el proyecto conhosting_list_projects. Si hay varios Spaces posibles, debe preguntar. - El Connector exige una frase de confirmación para tres herramientas:
hosting_delete_project,hosting_remove_domainyhosting_set_visibilitycuando hace público un proyecto. Cualquier otra confirmación de estos ejemplos depende de la aplicación y puede no ocurrir.
Consulta tus sitios web
Listar sitios web y su visibilidad
Which websites do I have on TEISENDA, and which of them are public?
Prompt original en alemán
Welche Websites habe ich bei TEISENDA, und welche davon sind öffentlich?
¿Qué debe provocar este prompt?
El prompt debe ejecutar whoami y hosting_list_projects; ambos solo leen. En el Space de demostración, la aplicación debe nombrar los tres proyectos e indicar que solo demo-private es privado.
Crea un proyecto y publícalo
Crear y publicar un proyecto de una sola página
Create a TEISENDA project for a one-page site and publish it.
Prompt original en alemán
Erstelle ein TEISENDA-Projekt für eine Website mit einer einzigen Seite und veröffentliche es.
¿Qué debe provocar este prompt?
El prompt debe ejecutar hosting_create_project, hosting_put_files (escribe la página como index.html en un nuevo borrador) y hosting_deploy. El proyecto queda privado; hosting_set_visibility solo lo hace público tras recibir la frase de confirmación.
Crear y publicar un proyecto con nombre y texto
Create a TEISENDA project called review-test with a single page that says "Hello from the review", and publish it.
Prompt original en alemán
Erstelle ein TEISENDA-Projekt namens review-test mit einer einzigen Seite, auf der „Hello from the review“ steht, und veröffentliche es.
¿Qué debe provocar este prompt?
El prompt debe ejecutar las mismas herramientas, con el nombre review-test y la frase del prompt en la index.html. La aplicación debe pedir confirmación antes de publicar, después indicar la dirección y explicar que el proyecto es privado hasta que lo hagas público.
Gestiona un sitio web publicado
Volver a la versión anterior
Roll back my TEISENDA site to the previous deployment.
Prompt original en alemán
Setze meine TEISENDA-Website auf die vorherige Version zurück.
¿Qué debe provocar este prompt?
El prompt debe ejecutar hosting_list_projects, hosting_list_deploys (para identificar la versión anterior) y hosting_rollback. La herramienta solo vuelve a una versión que ya estuvo publicada y todavía existe; no cuenta como publicación.
Consultar el estado de un proyecto
Show me the status of demo-landing: is it live, and which domains and redirects does it have?
Prompt original en alemán
Zeig mir den Status von demo-landing: Ist es online, und welche Domains und Weiterleitungen hat es?
¿Qué debe provocar este prompt?
El prompt debe ejecutar hosting_list_projects y hosting_project_status; ambos solo leen. hosting_list_redirects lista las reglas de redirección.
Leer un archivo de la versión publicada
Show me the index.html of the published version of demo-landing.
Prompt original en alemán
Zeig mir die index.html der veröffentlichten Version von demo-landing.
¿Qué debe provocar este prompt?
El prompt debe ejecutar hosting_list_projects, hosting_list_deploys y hosting_read_file con la ruta index.html. La herramienta solo lee, pero requiere el rol Usuario o superior; lee archivos de hasta 200 KB y devuelve como máximo 40.000 caracteres por llamada.
Conecta un dominio y añade redirecciones
Conectar un dominio personalizado
Connect my domain example.com to my TEISENDA project and tell me which DNS records to set.
Prompt original en alemán
Verbinde meine Domain example.com mit meinem TEISENDA-Projekt und sag mir, welche DNS-Einträge ich setzen muss.
¿Qué debe provocar este prompt?
El prompt debe ejecutar hosting_list_projects y hosting_add_domain; la herramienta indica los registros DNS que debes configurar en el proveedor de DNS del dominio cuando el nodo de hosting ya conoce el dominio; si no, los lista hosting_check_domain. Después, hosting_check_domain comprueba el DNS. El dominio solo sirve el sitio web cuando el DNS es correcto y existe el certificado.
Añadir una redirección
Atención
hosting_set_redirects sustituye toda la lista de reglas. La aplicación debe enviar las reglas existentes junto con la nueva.
On demo-redirects, add a redirect from /old to /new and keep the existing rules.
Prompt original en alemán
Füge bei demo-redirects eine Weiterleitung von /old nach /new hinzu und behalte die bestehenden Regeln.
¿Qué debe provocar este prompt?
El prompt debe ejecutar hosting_list_projects, hosting_list_redirects y hosting_set_redirects. La última herramienta sustituye toda la lista; por eso, la aplicación debe enviar las reglas existentes junto con la nueva y pedir confirmación antes.
Si algo falla
Encontrarás todos los mensajes con su causa y solución en Resolver errores del Connector.
Tu rol en este Space no lo permite.
Tienes el rol Solo lectura en el Space; las herramientas de escritura de estos ejemplos y hosting_read_file requieren permiso para editar. Pide a un miembro con el rol Propietario o Administrador que te asigne Usuario o un rol superior.
El plan de este Space permite … despliegues y … ya están utilizados. No se ha subido nada ni se ha creado ninguna versión. El plan de este Space figura en TEISENDA, en Ajustes › Planes.
El Space ha consumido las publicaciones de su plan; TEISENDA rechaza hosting_put_files y hosting_deploy y no se ha creado ninguna versión. Sigue siendo posible volver a publicar una versión que ya estuvo publicada mediante hosting_rollback o hosting_deploy y su número. Max permite más publicaciones; consulta Planes.
El plan de este Space no permite más proyectos: … de … ya están creados. No se ha creado nada. El plan de este Space figura en TEISENDA, en Ajustes › Planes.
El plan del Space no permite otro proyecto. Elimina un proyecto; Max permite más, como se explica en Planes.
Falta el index.html en la carpeta raíz.
El borrador no tiene index.html en la carpeta raíz y por eso hosting_deploy no puede finalizarlo. Pide que se escriba index.html en la carpeta raíz con hosting_put_files y vuelve a publicar.
El DNS de … todavía no es correcto:
No es un rechazo: hosting_check_domain ha detectado que el DNS del dominio todavía no es correcto e indica qué falta. Configura los registros DNS y pide a la aplicación que vuelva a comprobarlo.