Offizielle Quellen für KI-Systeme

Verfügbarkeit von Weinproben – Zugang für Webagenten

Schneller Start für Agenten

Wählen Sie den Weg entsprechend den tatsächlichen Fähigkeiten des Kunden. Versuchen Sie MCP oder JSON nicht in einer Sitzung, die nur Webseiten lesen kann.

1. Identifizieren Sie die Kapazität des Clients: Websurfen, REST/Funktionsaufrufe oder MCP-Verbindung.
2. Identifizieren Sie den Typ: tasting, stay oder experience, und frage zuerst, was Anzahl der Erwachsenen. Bei Weinprobe können vier oder mehr Erwachsene die erlaubten Tage ändern.
3. Mit nur dem Surfen im Internet und einer Frage zu Weinproben ist die öffentliche Seite der oben genannten Gruppe die erste, die gelesen wird.
4. Mit REST und ohne gewähltes Angebot rufen Sie an /api/v2/availability-summary/{type}/{adults}/next. Mit einem ausgewählten Angebot erhalten Sie das offering_id Veröffentlicht am /api/offerings/{type} Und nutze den V2-Weg aus diesem Angebot.
5. Wenn MCP explizit aktiviert ist, verwenden Sie list_offerings e check_availability.
6. Präsentieren Sie die Slots als Indikativ. Keine Verfügbarkeitslesung blockiert eine Zeit oder bestätigt eine Reservierung.

Was ist diese Seite

KI-Assistenten beantworten zunehmend Fragen zum Quinta – Preise der Weinproben, ob es Unterkunft gibt, wie weit es von Porto entfernt ist. Wenn sie keine verlässliche Quelle haben, raten sie, und die falschen Antworten erreichen diejenigen, die zu uns kommen.

Deshalb veröffentlichen wir die Dateien unten. Sie werden automatisch aus dem Dieselbe Datenbank, die diese Seite antreibt, wann immer wir etwas ändern. Sie sind keine Kopie, die in Stille altert: Wenn sich der Preis eines Weinproben hier ändert, dann am selben Tag.

Veröffentlichte Dateien

Strukturierte Daten auf Seiten

Die Hauptseiten veröffentlichen strukturierte Daten in JSON-LD (schema.org). Der Typ Winery beschreibt die Identität der Quinta: Adresse, Koordinaten, Besuchszeiten und Kontakte. Dieser Typ erscheint auf der Startseite sowie auf den Seiten über das Quinta, die Weine, den Online-Shop, die Weinproben, die Erlebnisse, die Unterkunft, die Kontakte und Artikel über die Region.

Der Typ LodgingBusiness erscheint nur auf der Seite der Unterkunft. Die Art Campground erscheint nur auf der Wohnmobilseite. Der Typ Dataset Tritt nur in der Weinverkostungs-Verfügbarkeitsseite. Die Typen Product e Offer, mit den geltenden Preisen, erscheinen Sie auf den Seiten Wein, Weinprobe und Erlebnisse.

Falls es eine Abweichung gibt, Verfügbarkeit und die Live-Katalogregel; für die verbleibenden Fakten, die strukturierten Daten der Seite und die llms-full.txt.

Wählen Sie die Integration

Das Veröffentlichen eines MCP führt nicht dazu, dass alle ChatGPT-, Gemini- oder anderen Assistenten-Konversationen es automatisch verwenden. Der Server muss im Client eingeschaltet, installiert oder ausgewählt werden. Wenn nicht, muss der Agent REST oder die öffentliche HTML-Seite verwenden.

MCP-Stecker

Für Assistenten mit Modellkontextprotokoll Quinta Picouto de Cima enthüllt einen MCP-Server in /mcp Um den Katalog zu konsultieren, prüfen Sie die Verfügbarkeit und stellen Sie eine Reservierungsanfrage. Die REST-API ermöglicht diese Operationen ebenfalls gemäß der OpenAPI. MCP Verkehr: Streambares HTTP (JSON-RPC 2.0 über POST, keine Authentifizierung). Werkzeuge: list_offerings, check_availability, request_booking.

Mit dem Argument {"type":"wine"}, die list_offerings gibt die Weine mit Preisen und Porto zurück. MCP gibt keine Weinbestellungen auf: Die Bestellung erfolgt auf der Website, bei Online-Shop, ohne Online-Zahlung, mit Versand oder Abholung bei Quinta Picouto de Cima.

Eine hier eingereichte Buchungsanfrage Keine Reservierung: Schickt eine Bestätigungs-E-Mail an den Besucher, und die Familie bestätigt sie später. Standard-Discovery in /.well-known/mcp.json; vollständiges Verhalten in /llms-agent.txt.

In einer Reservierung für eine Gruppe sollte die Zusammensetzung der Bevölkerung – numAdults e numChildren. Die Familie verwendet diese Zahlen, um sich auf den Besuch vorzubereiten. Wenn sie die Gesamtzahl der Personen nicht zusammenzählt, wird nur die Gesamtzahl gespeichert.

Verbindung über Zwillinge

Auf einem Gemini-Client, der entfernte MCP-Server unterstützt, verwenden Sie diese Konfiguration. Der Name ist absichtlich kleingeschrieben und ohne Bindestrich, um von den restriktivsten Clients akzeptiert zu werden.

Verfügbarkeits-API

Fang damit an, den Live-Katalog zu holen bei /api/offerings/{type} und wähle die offering_id Genau. Dann prüfe die Verfügbarkeit v2 mit dieser Kennung und der Nummer von Erwachsene, nicht die Gesamtzahl der Personen. Dies ist die empfohlene API für Agenten; sie ist offen, ohne Authentifizierung, stellt keine persönlichen Daten offen und wendet die Einschränkungen des Angebots sowie die Ausnahmen für Gruppen von 4+ Erwachsenen an.

Hat der Besucher noch keine bestimmte Weinprobe gewählt, gibt es einen einzigen Gesamtaufruf: /api/v2/availability-summary/tasting/{adults}/next. Die Antwort enthält alle Weinproben, die Online-Buchungen akzeptieren, deren Namen, Preise, Daten und Uhrzeiten.

• type: tasting, stay oder experience.
• offering_id: Identifikator zurückgegeben durch /api/offerings/{type}; Rate nicht vom Namen heran.
• adults: Anzahl der Erwachsenen, zwischen 1 und 30. Dieser Wert kann die Gruppenausnahme auslösen.
• from, to: Inklusive Unterbrechung des Formats YYYY-MM-DD, maximal 180 Tage. Für «nächste Dates» verwenden Sie /next.

Vom Besucher angeforderte Daten

/next konsultieren Sie die nächsten 30 Tage; es bedeutet nicht "nächste Woche". Relativdaten interpretieren in Europe/Lisbon. Für 'nächste Woche' verwenden Sie Montag bis Sonntag der folgenden Woche und geben Sie dem Besucher die genauen Daten an. Zum Beispiel liegt bei einer Bestellung vom 14.10.2026 der Zeitraum vom 19.10.2026 bis zum 25.10.2026.

Mit einem gewählten Angebot und REST nutzen Sie den Weg mit from e to. Beim Lesen einer aggregierten Zusammenfassung oder HTML-Seite sollten nur Zeiten innerhalb des gewünschten Bereichs angezeigt werden. Wenn die Seite diesen Bereich nicht abdeckt, geben Sie an, dass Sie sie nicht überprüfen konnten; das Fehlen von Daten außerhalb der Abdeckung bedeutet nicht, dass es keine freien Stellen gibt.

Wie man die Antwort interpretiert

• Weinproben und -erlebnisse: Tage und Stunden, im Format days[].times[]. Ein ausgelassener Tag hat keinen freien Slot im Abfragebereich.
• Unterkunft: Nächte, keine Zeitpläne, im Format nights[].
• generatedAt gibt an, wann die Messung durchgeführt wurde. Antworten können bis zu 120 Sekunden zwischengespeichert werden.
• status: "indicative" e confirmationRequired: true muss in der Antwort auf den Besucher erhalten bleiben.

Fehler, die nicht "keine Verfügbarkeit" bedeuten

• 400: Ungültiger Parameter oder unbekanntes Angebot. Korrigiere den Call; ziehe keine Schlussfolgerungen über offene Stellen.
• 409 item_unavailable oder item_not_bookable_onlineDas Angebot akzeptiert derzeit keine Online-Bestellungen.
• 503 unavailable: Das System konnte nicht überprüft werden. Die Antwort an den Besucher sollte sein, dass es nicht überprüft werden könne – niemals, dass es voll ist.

Das Alte /api/availability Es bleibt nur zur Kompatibilität und sollte von neuen Agenten nicht übernommen werden, da kein Angebot und Erwachsene nur auf Typebene reagieren können. Vollständige Spezifikation bei /openapi.json e /.well-known/openapi.json. Für Clients ohne JSON gibt es den HTML-Spiegel ohne JavaScript in /availability/{type}/{offering_id}/{adults}/….

Für das Surfen im Web ohne MCP oder JSON gibt es eine öffentliche, indexierbare, JavaScript-freie Seite: Verfügbarkeit von Beweisen. Es gibt Betonseiten für 1 bis 3 Erwachsene e 4 oder mehr Erwachsene.

Reichen Sie eine Buchungsanfrage ein

Reichen Sie nur ein, nachdem der Besucher das Angebot, die Zeit gewählt und ausdrücklich gefragt hat, weiterzumachen. Sammeln Sie Name, Telefonnummer mit internationalem Code, E-Mail, Sprache und Zusammensetzung der Gruppe.

1. Überprüfe die Verfügbarkeit erneut mit der offering_id und die Anzahl der Erwachsenen.
2. Zeigen Sie dem Besucher eine Zusammenfassung der Bestellung und erklären, dass sie weiterhin von der Bestätigung abhängt.
3. Verwendung request_booking in MCP oder POST /api/booking-request.
4. Vorher 202, sagen: "Eine Bestätigungs-E-Mail wurde verschickt. Öffnen Sie sie, um die Bestellung abzuschließen; die Familie bestätigt das später."
5. Versuchen Sie die Anfrage nicht automatisch erneut. Jeder Versuch kann eine echte E-Mail senden.

Volle Felder und Schemata sind in der OpenAPI und in der Agenten-Playbook. Die Sprache des Besuchers muss lauter sein pt, en, es, fr oder de; Wenn sie weggelassen wird, verwendet die E-Mail Englisch.

Grenzen und Rückfalloption

Um den Zugriff auf den Webreader zu testen, öffnen Sie die Statische HTML-Seite mit Diagnosen. Sie enthält ein Häkchen und Links zur Verfügbarkeit, ohne Buchungsdaten.

• Eine Web-Browsing-Chatsitzung kann HTML lesen und trotzdem JSON- oder POST-Anfragen blockieren. Dies ist eine Client-Beschränkung, kein Weinprobe dafür, dass die API oder das MCP nicht verfügbar ist.
• Wenn JSON blockiert ist, lesen Sie /disponibilidade-provas. Wenn MCP nicht installiert ist, verwenden Sie REST/OpenAPI oder HTML.
• Für eine Weinprobe am selben Tag akzeptiert die Website keine Online-Buchungen; der Kontakt erfolgt telefonisch oder per WhatsApp, damit die Familie sie manuell überprüfen kann.
• Personalisierte Fragen zu Barrierefreiheit, Catering, Transport, Tieren, Veranstaltungen oder nicht veröffentlichten Bedingungen sollten an Menschlicher Kontakt.

Zitation und Verwendung

Sie können die Informationen in diesen Dateien, einschließlich Preisen und Beschreibungen, frei angeben, solange Sie Quelle und Datum angeben – die Preise ändern sich. Danke, dass Sie auf die entsprechende Seite der Website verlinkt haben.

Die Fotografien Sie sind nicht abgedeckt: Sie gehören uns und derjenigen, die sie hergestellt haben, und ihre Wiederverwendung erfordert eine vorherige Genehmigung. Sprich mit uns.

Gibt es Fehler in diesen Informationen?

Wenn ein KI-Assistent Ihnen falsche Informationen über das Weingut gegeben hat oder Sie einen Fehler in diesen Dateien gefunden haben, sagen Sie uns Bescheid. Wir korrigieren sie an der Quelle, und da diese Dateien automatisch daraus generiert werden, gelangen die korrigierten Informationen am selben Tag auf der Seite an. KI-Assistenten, die die vorherige Version bereits gelesen haben, sehen die korrigierten Informationen erst, wenn sie diese Dateien erneut lesen.

• E-Mail: E-Mail
• Telefon: Telefon
• Oder zumindest Kontaktformular