Examples for using the Connector
Find example prompts and their intended tool calls.
On this page
Choose an example prompt and adapt the project names and domain to your Space. A Space is a shared workspace in the app.
Note
Write the prompt in a conversation with the Connector enabled. The connection covers the Space, and the Space is not locked.
Prompts that change something or read a file need the User role or higher; viewing is possible with any role. Publications, projects and domains count towards your plan limits.
The application decides which tools it actually calls. This page explains what a prompt is intended to trigger.
Warning
A newly created draft starts empty. If you change a file in an existing project through the Connector and publish, the new version contains only what is in the draft. See A draft becomes a version.
How to read these examples
- The English prompts come from the authoritative examples; each accordion contains the German version. Replace demo project names with your own.
- The application should first use
whoamito determine the Space andhosting_list_projectsto determine the project. If several Spaces could apply, it should ask. - The Connector requires a confirmation sentence for three tools:
hosting_delete_project,hosting_remove_domainandhosting_set_visibilitywhen it makes a project public. Any other confirmation in these examples comes from the application itself and may not appear.
View your websites
List websites and their visibility
Which websites do I have on TEISENDA, and which of them are public?
Prompt in German
Welche Websites habe ich bei TEISENDA, und welche davon sind öffentlich?
What should this prompt trigger?
The prompt should trigger whoami and hosting_list_projects; both only read. In the demo Space, the application should name the three projects and say that only demo-private is private.
Create and publish a project
Create and publish a project for a single page
Create a TEISENDA project for a one-page site and publish it.
Prompt in German
Erstelle ein TEISENDA-Projekt für eine Website mit einer einzigen Seite und veröffentliche es.
What should this prompt trigger?
The prompt should trigger hosting_create_project, hosting_put_files (writes the page as index.html in a new draft) and hosting_deploy. The project is then private; hosting_set_visibility only makes it public after the confirmation sentence.
Create and publish a project with a name and text
Create a TEISENDA project called review-test with a single page that says "Hello from the review", and publish it.
Prompt in German
Erstelle ein TEISENDA-Projekt namens review-test mit einer einzigen Seite, auf der „Hello from the review“ steht, und veröffentliche es.
What should this prompt trigger?
The prompt should trigger the same tools, with the name review-test and the sentence from the prompt in the index.html. The application should ask for confirmation before publishing, then give the address and say that the project is private until you make it public.
Maintain a published website
Go back to the previous version
Roll back my TEISENDA site to the previous deployment.
Prompt in German
Setze meine TEISENDA-Website auf die vorherige Version zurück.
What should this prompt trigger?
The prompt should trigger hosting_list_projects, hosting_list_deploys (to find the previous version) and hosting_rollback. The tool can only return to a version that was published before and still exists; this does not count as a publication.
Check a project's status
Show me the status of demo-landing: is it live, and which domains and redirects does it have?
Prompt in German
Zeig mir den Status von demo-landing: Ist es online, und welche Domains und Weiterleitungen hat es?
What should this prompt trigger?
The prompt should trigger hosting_list_projects and hosting_project_status; both only read. Redirect rules are listed by hosting_list_redirects.
Read a file from the published version
Show me the index.html of the published version of demo-landing.
Prompt in German
Zeig mir die index.html der veröffentlichten Version von demo-landing.
What should this prompt trigger?
The prompt should trigger hosting_list_projects, hosting_list_deploys and hosting_read_file with the path index.html. The tool only reads, but requires User or higher; it reads files up to 200 KB and returns at most 40,000 characters per call.
Connect a domain and add redirects
Connect a custom domain
Connect my domain example.com to my TEISENDA project and tell me which DNS records to set.
Prompt in German
Verbinde meine Domain example.com mit meinem TEISENDA-Projekt und sag mir, welche DNS-Einträge ich setzen muss.
What should this prompt trigger?
The prompt should trigger hosting_list_projects and hosting_add_domain; the tool gives the DNS records to set at the domain's DNS provider once the hosting node knows the domain. Otherwise, they are listed by hosting_check_domain. Then hosting_check_domain checks DNS. The domain only serves the website once DNS is correct and the certificate is ready.
Add a redirect
Warning
hosting_set_redirects replaces the entire rule list. The application must send the existing rules together with the new one.
On demo-redirects, add a redirect from /old to /new and keep the existing rules.
Prompt in German
Füge bei demo-redirects eine Weiterleitung von /old nach /new hinzu und behalte die bestehenden Regeln.
What should this prompt trigger?
The prompt should trigger hosting_list_projects, hosting_list_redirects and hosting_set_redirects. The last tool replaces the entire list; the application should therefore send the existing rules together with the new one and ask for confirmation first.
If something goes wrong
All messages, their causes and solutions are listed under Troubleshoot the Connector.
Your role in this Space doesn't allow that.
Your role in the Space is Read-only; the writing tools in these examples and hosting_read_file require editing permission. Ask a member with the Owner or Administrator role to give you User or higher.
“This Space's plan allows … deployments; … have been used. Nothing was uploaded and no version was created. …”
The Space has used its plan's publications; TEISENDA rejects hosting_put_files and hosting_deploy and no version is created. You can still republish a previously published version with hosting_rollback or with hosting_deploy and its number. The Max plan allows more publications; see Plans.
“This Space's plan does not allow more projects: … of … have been created. Nothing was created. …”
The Space's plan does not allow another project. Delete a project; the Max plan allows more projects. See Plans.
The top-level folder is missing index.html.
The draft has no index.html in its root folder, so hosting_deploy cannot complete it. Have the application write the index.html into the root folder with hosting_put_files and publish again.
“The DNS for … is not correct yet:”
This is not a rejection: hosting_check_domain found that the domain's DNS is not correct yet and explains what is missing. Set the DNS records and have the application check again.