Fuentes para sistemas de IA — Quinta Picouto de Cima

Disponibilidad de catas de vino – entrada para agentes web

Si solo puede navegar por páginas web, empieza aquí: Consulta la página pública y renderizada por servidor de Disponibilidad de catas. Después de pedir el número de adultos, usa directamente De 1 a 3 adultos o 4 o más adultos. Estas páginas son la vía principal hacia agentes web, no un último recurso, y no requieren acceso a JavaScript, MCP ni JSON.

Inicio rápido para agentes

Elija el camino según las capacidades reales del cliente. No pruebes MCP o JSON en una sesión que solo puede leer páginas web.

Identifica la capacidad del cliente: navegación web, llamada REST/función o MCP conectado.
Identifica el tipo: tasting, stay o experience, y pregunta primero qué Número de adultos. Para las carreras, cuatro o más adultos pueden cambiar los días permitidos.
Con solo navegar por internet y una pregunta sobre catas de vinos, la página pública del grupo anterior es la primera en leer.
Con REST y sin oferta elegida, llama /api/v2/availability-summary/{type}/{adults}/next. Con una oferta elegida, consigue el offering_id Publicado en /api/offerings/{type} Y usar la vía v2 de esa oferta.
Con MCP activado explícitamente, usa list_offerings e check_availability.
Presenta las tragaperras como Indicativo. No hay lectura de disponibilidad que bloquee una hora o confirme una reserva.

{ "agent_contract_version": "2026-10-14", "canonical_origin": "https://quintapicoutocima.pt", "timezone": "Europe/Lisbon", "supported_types": ["tasting", "stay", "experience"], "party_rule_input": "adults", "availability_is_indicative": true, "availability_holds_a_slot": false, "booking_request_is_a_confirmed_booking": false, "human_confirmation_required": true, "preferred_web_route_for_tastings": "/disponibilidade-provas", "web_group_routes": ["/disponibilidade-provas/1-a-3-adultos", "/disponibilidade-provas/4-ou-mais-adultos"], "preferred_unselected_offering_api": "/api/v2/availability-summary/{type}/{adults}/next", "preferred_selected_offering_api": "/api/v2/availability/{type}/{offering_id}/{adults}/next", "preferred_mcp": "/mcp", "source_priority_depends_on_client_capability": true }

Regla esencial: Una respuesta 200 con un horario significa "este tiempo parece libre en la lectura actual". No significa "tiempo reservado". A 202 Enviar una solicitud tampoco es una reserva: el visitante sigue confirmando el correo y la familia acepta la solicitud más tarde.

¿Qué es esta página?

Cada vez más asistentes de IA responden preguntas sobre la Quinta — precios de las catas, si hay alojamiento, qué distancia está de Oporto. Cuando no tienen una fuente fiable, adivinan, y las respuestas equivocadas llegan a quienes acuden a nosotros.

Por eso publicamos los archivos a continuación. Se generan automáticamente a partir de La misma base de datos que alimenta este sitio, cada vez que cambiamos algo. No son una copia que se guarda a mano y envejece en silencio: si el precio de una cata cambia aquí, cambia allí el mismo día.

Archivos publicados

/llms.txt

Resumen y índice. Identidad de la finca, hechos verificados, catálogo breve, preguntas frecuentes e indicaciones de dónde buscar cada tipo de información. Es el punto de partida.

/llms-full.txt

Base de conocimientos completa. Todos los vinos con variedades de uva, notas de cosecha y cata; catas de vinos y sus contenidos; experiencias; alojamiento y sus servicios; historia de la Quinta y opiniones de visitantes. Incluye un resumen en JSON para consumo automático.

/llms-agent.txt

Guía de conducta para los respondedores en el nombre Desde la finca: cómo encaminar cada tipo de pregunta, qué no decir nunca (disponibilidad garantizada, precios no publicados, confirmaciones de reserva) y cuándo pasar la conversación a una sola persona.

/sitemap.xml · /robots.txt

Mapa del sitio y normas de colección. O robots.txt autoriza expresamente a los principales coleccionistas de IA y señala los archivos anteriores.

Datos estructurados en páginas

Las páginas principales publican datos estructurados en JSON-LD (schema.org). Del tipo Winery describe la identidad de la Quinta: dirección, coordenadas, horarios de visita y contactos. Este tipo aparece en la página principal y en las páginas sobre la Quinta, los vinos, la tienda online, las catas de vinos, las experiencias, el alojamiento, los contactos y los artículos sobre la región.

El tipo LodgingBusiness solo aparece en la página del alojamiento. El tipo Campground solo aparece en la página de autocaravanas. El tipo Dataset solo aparece en el Página de disponibilidad para catas de vinos. Los tipos Product e Offer, con los precios vigentes, aparece en las páginas de vinos, catas y experiencias.

Si hay divergencia, disponibilidad y la regla del catálogo en vivo; para los hechos restantes, los datos estructurados de la página y el llms-full.txt.

Una nota sobre la disponibilidad. Para la corrección, los agentes con navegación web deberían empezar por el Página de Disponibilidad Pública y elige el grupo de adultos. Los clientes de REST usan la API v2 por oferta y número de adultos; los clientes con MCP activado usan las herramientas disponibles. El número de adultos es necesario porque algunas ofertas tienen restricciones semanales que cambian a grupos de 4+ adultos. En cualquier canal, la respuesta es indicativo: la confirmación final siempre la hace la familia, normalmente en unos minutos o unas horas y hasta un máximo de 24 horas.

Elija la integración

Capacidad de Clientes	Uso	Cuando
Navegación web sin JSON	`/disponibilidade-provas`	Primera opción para agentes web que buscan catas de vinos. Está renderizado en servidor, sin JavaScript, y tiene páginas separadas para 1–3 y 4+ adultos.
MCP remoto conectado	`https://quintapicoutocima.pt/mcp`	Prefiere cuando el cliente tiene este MCP activado explícitamente. Permite listar ofertas, comprobar disponibilidad y enviar una solicitud.
REST o llamada de función	`/openapi.json`	Importa el contrato OpenAPI. Para una pregunta general, utiliza primero el resumen agregado; para una oferta concreta, utiliza la ruta v2 mediante `offering_id`.
Conocimiento, ninguna disponibilidad	`/llms-full.txt`	Catálogo, descripciones, precios, inclusiones, ubicación y políticas. No sustituye la disponibilidad en directo.

Publicar un MCP no hace que todas las conversaciones de ChatGPT, Gemini u otros asistentes lo usen automáticamente. El servidor debe encenderse, instalarse o seleccionarse en el cliente. Cuando no lo hace, el agente debe usar REST o la página pública de HTML.

Conector MCP

Para asistentes con Protocolo de Contexto de Modelo en, Quinta Picouto de Cima expone un servidor MCP en /mcp para consultar el catálogo, compruebe la disponibilidad y envíe una solicitud de reserva. La API REST también permite estas operaciones, según el OpenAPI. MCP Transporte: HTTP transmitible (JSON-RPC 2.0 sobre POST, sin autenticación). Herramientas: list_offerings, check_availability, request_booking.

Con la discusión {"type":"wine"}, el list_offerings devuelve los vinos, con precios y gastos de envío. MCP no realiza pedidos de vino: el pedido se realiza en la página web, en Tienda online, sin pago online, con envío o recogida en Quinta Picouto de Cima.

Una solicitud de reserva se ha enviado aquí No es una reserva: Envía un correo electrónico de verificación al visitante, y la familia lo confirma más tarde. Descubrimiento estándar en /.well-known/mcp.json; Conducta completa en /llms-agent.txt.

En una reserva para un grupo, incluye la composición de las personas — numAdults e numChildren. La familia utiliza estos números para prepararse para la visita. Si no suman el número total de personas, solo se salva el número total.

POST https://quintapicoutocima.pt/mcp {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18"}} {"jsonrpc":"2.0","id":2,"method":"tools/list"} POST https://quintapicoutocima.pt/mcp {"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_offerings","arguments":{"type":"tasting"}}} POST https://quintapicoutocima.pt/mcp {"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"check_availability","arguments":{"type":"tasting","offering_id":"ID_FROM_LIST_OFFERINGS","adults":4}}}

Conexión a través de Gemini

En un cliente Gemini que soporte servidores MCP remotos, utiliza esta configuración. El nombre es deliberadamente minúsculo y sin guion para ser aceptado por los clientes más restrictivos.

{ "type": "mcp_server", "name": "quintapicoutocima", "url": "https://quintapicoutocima.pt/mcp", "allowed_tools": [ "list_offerings", "check_availability", "request_booking" ] }

API de disponibilidad

Empieza por conseguir el catálogo en directo en /api/offerings/{type} y elige el offering_id Exacto. Luego comprueba la disponibilidad v2 con ese identificador y el número de Adultos, no el número total de personas. Esta es la API recomendada para agentes; es abierta, sin autenticación, no expone datos personales y aplica las restricciones de la oferta y la excepción a grupos de 4+ adultos.

Si el visitante aún no ha elegido una cata de vinos específica, hay una única llamada agregada: /api/v2/availability-summary/tasting/{adults}/next. La respuesta incluye todos los justificantes que aceptan la reserva online, sus nombres, precios, fechas y horarios.

# Visitante: “Somos 4 adultos. Quais são as próximas datas para uma prova?” GET https://quintapicoutocima.pt/api/v2/availability-summary/tasting/4/next → { "type": "tasting", "adults": 4, "status": "indicative", "confirmationRequired": true, "offerings": [ { "offering_id": "…", "name": "Prova Essencial", "price": "30€ por pessoa", "days": [ { "date": "YYYY-MM-DD", "times": ["11h00", "15h00"] } ] } ], "generatedAt": "ISO-8601" } # Visitante já escolheu a oferta GET https://quintapicoutocima.pt/api/offerings/tasting → { "offerings": [ { "offering_id", "type", "name", "bookable_online", … } ] } GET https://quintapicoutocima.pt/api/v2/availability/tasting/{offering_id}/{adults}/2026-09-28/2026-10-04 → { "type", "offering_id", "adults", "from", "to", "days", "status": "indicative", "confirmationRequired": true, "generatedAt" } GET https://quintapicoutocima.pt/api/v2/availability/tasting/{offering_id}/{adults}/next → a mesma resposta, de hoje em Lisboa até 30 dias depois

type: tasting, stay o experience.
offering_id: identificador devuelto por /api/offerings/{type}; No adivines por el nombre.
adults: Número de adultos, entre 1 y 30. Es este valor el que puede desencadenar la excepción de grupo.
from, to: pausa inclusiva en el formato YYYY-MM-DD, un máximo de 180 días. Para «próximas fechas», usa /next.

Fechas solicitadas por el visitante

/next consulta los próximos 30 días; no significa "la próxima semana". Interpreta las fechas relativas en Europe/Lisbon. Para 'la próxima semana', utiliza el horario de lunes a domingo de la semana siguiente y proporciona al visitante las fechas exactas. Por ejemplo, para un pedido realizado el 14/10/2026, el rango es del 19/10/2026 al 25/10/2026.

Con una oferta elegida y REST, utiliza la ruta con from e to. Al leer un resumen agregado o una página HTML, solo deben mostrarse los tiempos dentro del rango solicitado. Si la página no cubre este rango, diga que no pudo consultarla; la ausencia de fechas fuera de cobertura no significa falta de vacantes.

Cómo interpretar la respuesta

Catas y experiencias de vino: días y horas, en el formato days[].times[]. Un día omitido no tiene una plaza libre dentro del rango consultado.
Alojamiento: noches, no horarios, en el formato nights[].
generatedAt indica cuándo se realizó la lectura. Las respuestas pueden almacenarse en caché hasta 120 segundos.
status: "indicative" e confirmationRequired: true debe ser preservado en la respuesta al visitante.

Errores que no significan "ausencia de disponibilidad"

400: Parámetro inválido o oferta desconocida. Corregir la llamada; no concluir nada sobre vacantes.
409 item_unavailable o item_not_bookable_online: La oferta no acepta pedidos online por el momento.
503 unavailable: el sistema no podía ser comprobado. La respuesta al visitante debería ser que no podía comprobarse — nunca que estaba lleno.

Los viejos /api/availability Permanece solo por compatibilidad y no debe ser recogida por nuevos agentes, ya que no hay oferta y los adultos solo pueden responder al nivel del tipo. Especificación completa en /openapi.json e /.well-known/openapi.json. Para clientes sin JSON, existe el espejo HTML sin JavaScript en /availability/{type}/{offering_id}/{adults}/….

Para la navegación web sin MCP ni JSON, hay una página pública, indexable y libre de JavaScript: Disponibilidad de catas. Tiene páginas concretas para De 1 a 3 adultos e 4 o más adultos.

Envía una solicitud de reserva

Solo envía la solicitud después de que el visitante haya elegido la oferta, la hora y haya solicitado explícitamente que siga adelante. Recoge el nombre, número de teléfono con código internacional, correo electrónico, idioma y composición del grupo.

Consulta la disponibilidad de nuevo con el offering_id y el número de adultos.
Muestra al visitante un resumen del pedido y explica que aún depende de la confirmación.
Uso request_booking en MCP o POST /api/booking-request.
Antes 202, di: "Se ha enviado un correo de verificación. Ábrelo para completar el pedido; la familia lo confirmará más tarde."
No intentes la solicitud automáticamente. Cada intento puede enviar un correo electrónico real.

Los campos completos y esquemas están en el OpenAPI y en la Manual de Agente. El idioma del visitante debe ser pt, en, es, fr o de; Si se omite, el correo utiliza inglés.

Límites y respaldo

Para probar el acceso al lector web, abre la Página HTML estática de diagnósticos. Contiene una marca de verificación y enlaces a disponibilidad, sin datos de reserva.

Una sesión de chat de navegación web puede ser capaz de leer HTML y aun así bloquear solicitudes JSON o POST. Esto es una limitación del cliente, no una cata de que la API o MCP no estén disponibles.
Cuando JSON está bloqueado, lee /disponibilidade-provas. Cuando MCP no esté instalado, utiliza REST/OpenAPI o HTML.
Para una cata de vinos el mismo día, la web no acepta reservas online; el contacto es por teléfono o WhatsApp, para que la familia pueda consultarlo manualmente.
Las preguntas personalizadas sobre accesibilidad, catering, transporte, animales, eventos o condiciones no publicadas deben ir a Contacto humano.

Cita y uso

Puede citar libremente la información de estos archivos, incluidos precios y descripciones, siempre que indiques la fuente y la fecha — los precios cambian. Gracias por enlazar a la página correspondiente de la web.

El Fotografías No están cubiertas: son nuestras y de quienes las fabricaron, y su reutilización requiere autorización previa. Háblanos.

¿Algún error en esta información?

Si un asistente de IA te ha dado información incorrecta sobre la finca, o si has encontrado un error en estos archivos, dínoslo. Lo corregimos en la fuente, y dado que estos archivos se generan automáticamente a partir de ella, la información corregida llega al sitio y a los archivos el mismo día. Los asistentes de IA que ya han leído la versión anterior solo ven la información corregida cuando vuelven a leer esos archivos.

Correo electrónico: Correo electrónico
Teléfono: Teléfono
O al menos Formulario de contacto