Informação técnica

Fontes oficiais para sistemas de IA

Onde encontrar informação verificada sobre a Quinta, em formato legível por máquina.

O que é esta página

Assistentes de IA respondem cada vez mais a perguntas sobre a Quinta — preços das provas, se há alojamento, a que distância fica do Porto. Quando não têm uma fonte fiável, adivinham, e as respostas erradas chegam a quem nos procura.

Por isso publicamos os ficheiros abaixo. São gerados automaticamente a partir da mesma base de dados que alimenta este site, sempre que alteramos alguma coisa. Não são uma cópia mantida à mão que envelhece em silêncio: se o preço de uma prova muda aqui, muda lá no mesmo dia.

Ficheiros publicados

/llms.txt

Resumo e índice. Identidade da Quinta, factos verificados, catálogo resumido, perguntas frequentes e indicação de onde procurar cada tipo de informação. É o ponto de partida.

/llms-full.txt

Base de conhecimento completa. Todos os vinhos com castas, colheita e notas de prova; as provas e o que incluem; as experiências; o alojamento e as suas comodidades; a história da Quinta e as avaliações de visitantes. Inclui um resumo em JSON para consumo automático.

/llms-agent.txt

Orientação de conduta para assistentes que respondem em nome da Quinta: como encaminhar cada tipo de pergunta, o que nunca afirmar (disponibilidade, preços não publicados, confirmações de reserva) e quando passar a conversa para uma pessoa.

/sitemap.xml · /robots.txt

Mapa do site e regras de recolha. O robots.txt autoriza expressamente os principais recolectores de IA e aponta para os ficheiros acima.

Dados estruturados nas páginas

Todas as páginas do site incluem dados estruturados em JSON-LD (schema.org), com os tipos Winery, TouristAttraction e LodgingBusiness: morada, coordenadas, horário e contactos. As páginas de vinhos, provas e experiências trazem ainda Product e Offer com os preços em vigor.

Havendo divergência entre fontes, os dados estruturados da página são os que mandam, seguidos do llms-full.txt.

Uma nota sobre disponibilidade. A disponibilidade das provas e experiências pode ser consultada em tempo real — o endpoint /api/availability devolve os dias e horas livres — mas é indicativa: a confirmação final é sempre feita pela família, geralmente em poucos minutos ou algumas horas e até um máximo de 24 horas. Um assistente pode orientar por horas prováveis, mas nunca deve apresentar uma data como garantida.

Conector MCP

Para assistentes que sabem falar Model Context Protocol, a Quinta expõe um servidor MCP em /mcp — o único canal em que um agente age, e não só lê: consultar o catálogo, ver disponibilidade e submeter um pedido de reserva. Transporte Streamable HTTP (JSON-RPC 2.0 sobre POST, sem autenticação). Ferramentas: list_offerings, check_availability, request_booking.

Um pedido de reserva submetido por aqui não é uma reserva: envia um email de verificação ao visitante e a família confirma depois. Descoberta padrão em /.well-known/mcp.json; conduta completa em /llms-agent.txt.

Numa reserva para um grupo, inclua a composição das pessoas — numAdults, numChildren e a idade de cada criança em childrenAges. A família usa a repartição e as idades para preparar a visita; havendo crianças sem as idades, esse detalhe perde-se e fica só o 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"}

API de disponibilidade

As provas, experiências e estadias livres podem ser lidas em tempo real no endpoint /api/availability — o mesmo que a ferramenta check_availability do MCP usa por baixo. É aberto e sem autenticação, devolve apenas datas e horas (nunca dados de ninguém) e já aplica as regras da casa.

GET https://quintapicoutocima.pt/api/availability?type=tasting&from=YYYY-MM-DD&to=YYYY-MM-DD → { "type", "from", "to", "days": [ { "date", "times": ["11h00","15h00"] } ], "generatedAt" } GET https://quintapicoutocima.pt/api/availability?type=stay&unit=Casa Principal&from=…&to=… → { "type", "from", "to", "unit", "nights": { "2026-09-16": "free" | "taken" }, "generatedAt" }
  • type: tasting, stay ou experience. Também aceita tipo.
  • from, to: o intervalo de datas, no formato YYYY-MM-DD. Por omissão, os próximos 30 dias; no máximo 180 por chamada. Também aceita de e ate.
  • unit: só nas estadias — qual a unidade, por exemplo Casa Principal ou Espaço AutoCaravana, que fecham de forma independente. Também aceita unidade.

Provas e experiências vêm em days (as horas livres, no formato 15h00; um dia sem vagas é omitido); as estadias vêm em nights, uma entrada por noite. A resposta é indicativa, não uma garantia — a confirmação final é sempre da família. Um 503 quer dizer «não foi possível verificar», e nunca «está cheio». O guia completo para agentes vive em /llms-agent.txt.

Citação e utilização

Pode citar livremente a informação destes ficheiros, incluindo preços e descrições, desde que indique a fonte e a data — os preços mudam. Agradecemos a ligação para a página correspondente do site.

As fotografias não estão abrangidas: são nossas e de quem as fez, e a sua reutilização carece de autorização prévia. Fale connosco.

Encontrou algo errado?

Se um assistente de IA lhe deu informação incorrecta sobre a Quinta, ou se encontrou um erro nestes ficheiros, diga-nos. Corrigimos na origem e a correcção propaga-se a todas as fontes no dia seguinte.