Exemples d’utilisation du Connector

Vous trouvez des exemples de prompts et les appels d’outils prévus.

Sur cette page

Choisissez un exemple de prompt et adaptez les noms des projets et le domaine à votre Space. Un Space est un espace de travail partagé dans l’app.

À savoir

Écrivez le prompt dans une conversation où le Connector est activé. La connexion inclut le Space, et celui-ci n’est pas bloqué.

Les prompts qui modifient quelque chose ou lisent un fichier nécessitent le rôle Utilisateur ou supérieur ; la consultation est possible avec chaque rôle. Les publications, projets et domaines comptent dans les limites de votre offre.

L’application décide des outils qu’elle appelle réellement. Cette page indique ce qu’un prompt doit déclencher.

Attention

Un nouveau brouillon est vide. Si vous modifiez un fichier d’un projet existant via le Connector puis publiez, la nouvelle version ne contient que ce qui se trouve dans le brouillon. Consultez Un brouillon devient une version.

Comment lire les exemples

  • Les prompts anglais proviennent des exemples de référence ; la version allemande figure dans chaque accordéon. Remplacez les noms des projets de démonstration par les vôtres.
  • L’application doit d’abord déterminer le Space avec whoami et le projet avec hosting_list_projects. Elle doit vous demander en cas de plusieurs Spaces possibles.
  • Le Connector exige une phrase de confirmation pour trois outils : hosting_delete_project, hosting_remove_domain et hosting_set_visibility lorsqu’il rend un projet public. Toute autre demande de confirmation dans ces exemples vient de l’application elle-même et peut ne pas avoir lieu.

Consulter vos sites web

Lister les sites et leur visibilité

Prompt en anglais
Which websites do I have on TEISENDA, and which of them are public?
Prompt en allemand
Prompt en allemand
Welche Websites habe ich bei TEISENDA, und welche davon sind öffentlich?
Que doit déclencher ce prompt ?

Le prompt doit déclencher whoami et hosting_list_projects ; tous deux ne font que lire. Dans le Space de démonstration, l’application doit nommer les trois projets et indiquer que seul demo-private est privé.

Créer et publier un projet

Créer et publier un projet d’une seule page

Prompt en anglais
Create a TEISENDA project for a one-page site and publish it.
Prompt en allemand
Prompt en allemand
Erstelle ein TEISENDA-Projekt für eine Website mit einer einzigen Seite und veröffentliche es.
Que doit déclencher ce prompt ?

Le prompt doit déclencher hosting_create_project, hosting_put_files (écrit la page comme index.html dans un nouveau brouillon) et hosting_deploy. Le projet reste privé ; hosting_set_visibility ne le rend public qu’après la phrase de confirmation.

Créer et publier un projet avec un nom et un texte

Prompt en anglais
Create a TEISENDA project called review-test with a single page that says "Hello from the review", and publish it.
Prompt en allemand
Prompt en allemand
Erstelle ein TEISENDA-Projekt namens review-test mit einer einzigen Seite, auf der „Hello from the review“ steht, und veröffentliche es.
Que doit déclencher ce prompt ?

Le prompt doit déclencher les mêmes outils, avec le nom review-test et la phrase du prompt dans index.html. L’application doit demander confirmation avant la publication, puis indiquer l’adresse et préciser que le projet reste privé jusqu’à ce que vous le rendiez public.

Gérer un site publié

Revenir à la version précédente

Prompt en anglais
Roll back my TEISENDA site to the previous deployment.
Prompt en allemand
Prompt en allemand
Setze meine TEISENDA-Website auf die vorherige Version zurück.
Que doit déclencher ce prompt ?

Le prompt doit déclencher hosting_list_projects, hosting_list_deploys (pour déterminer la version précédente) et hosting_rollback. L’outil ne revient qu’à une version déjà publiée et encore présente ; cela ne compte pas comme une publication.

Consulter l’état d’un projet

Prompt en anglais
Show me the status of demo-landing: is it live, and which domains and redirects does it have?
Prompt en allemand
Prompt en allemand
Zeig mir den Status von demo-landing: Ist es online, und welche Domains und Weiterleitungen hat es?
Que doit déclencher ce prompt ?

Le prompt doit déclencher hosting_list_projects et hosting_project_status ; tous deux ne font que lire. hosting_list_redirects liste les règles de redirection.

Lire un fichier de la version publiée

Prompt en anglais
Show me the index.html of the published version of demo-landing.
Prompt en allemand
Prompt en allemand
Zeig mir die index.html der veröffentlichten Version von demo-landing.
Que doit déclencher ce prompt ?

Le prompt doit déclencher hosting_list_projects, hosting_list_deploys et hosting_read_file avec le chemin index.html. L’outil ne fait que lire, mais exige le rôle Utilisateur ou supérieur ; il lit les fichiers jusqu’à 200 Ko et renvoie au maximum 40 000 caractères par appel.

Relier un domaine et ajouter des redirections

Relier un domaine personnalisé

Prompt en anglais
Connect my domain example.com to my TEISENDA project and tell me which DNS records to set.
Prompt en allemand
Prompt en allemand
Verbinde meine Domain example.com mit meinem TEISENDA-Projekt und sag mir, welche DNS-Einträge ich setzen muss.
Que doit déclencher ce prompt ?

Le prompt doit déclencher hosting_list_projects et hosting_add_domain ; cet outil indique les enregistrements DNS à configurer chez le fournisseur DNS du domaine dès que le nœud d’hébergement connaît le domaine, sinon hosting_check_domain les liste. Ensuite, hosting_check_domain vérifie le DNS. Le domaine ne sert le site que lorsque le DNS est correct et que le certificat est disponible.

Ajouter une redirection

Attention

hosting_set_redirects remplace toute la liste des règles. L’application doit envoyer les règles existantes avec la nouvelle.

Prompt en anglais
On demo-redirects, add a redirect from /old to /new and keep the existing rules.
Prompt en allemand
Prompt en allemand
Füge bei demo-redirects eine Weiterleitung von /old nach /new hinzu und behalte die bestehenden Regeln.
Que doit déclencher ce prompt ?

Le prompt doit déclencher hosting_list_projects, hosting_list_redirects et hosting_set_redirects. Le dernier outil remplace toute la liste ; l’application doit donc envoyer les règles existantes avec la nouvelle et demander confirmation auparavant.

En cas de problème

Tous les messages, leurs causes et leurs solutions figurent dans Résoudre les problèmes du Connector.

Votre rôle dans ce Space ne le permet pas.

Vous avez le rôle Lecture seule dans le Space ; les outils d’écriture de ces exemples et hosting_read_file exigent le droit de modification. Demandez à un membre ayant le rôle Propriétaire ou Administrateur de vous attribuer le rôle Utilisateur ou supérieur.

L'offre de ce Space autorise … déploiements, dont … sont déjà utilisés. Rien n'a été envoyé et aucune version n'a été créée. L'offre de ce Space figure dans TEISENDA sous Paramètres › Offres.

Le Space a utilisé toutes les publications de son offre ; TEISENDA refuse hosting_put_files et hosting_deploy, et aucune version n’a été créée. Vous pouvez encore republier une version déjà publiée avec hosting_rollback ou avec hosting_deploy et son numéro. Max autorise davantage de publications ; consultez Offres.

L'offre de ce Space n'autorise aucun projet supplémentaire : … sur … sont créés. Rien n'a été créé. L'offre de ce Space figure dans TEISENDA sous Paramètres › Offres.

L’offre du Space n’autorise aucun projet supplémentaire. Supprimez un projet ; Max autorise davantage de projets, consultez Offres.

Le fichier index.html est absent du dossier racine.

Le brouillon n’a pas d’index.html dans le dossier racine ; hosting_deploy ne peut donc pas le terminer. Demandez l’écriture d’index.html dans le dossier racine avec hosting_put_files, puis publiez à nouveau.

Le DNS de … n'est pas encore correct :

Ce n’est pas un refus : hosting_check_domain a constaté que le DNS du domaine n’est pas encore correct et indique ce qui manque. Configurez les enregistrements DNS et demandez à l’application de vérifier à nouveau.

Pour continuer