Praia Films · 2026 · Praia Films AI Gateway

Marco Zero da Web Agêntica

Um registro público de como a Praia Films passou a publicar suas informações institucionais em formato legível por agentes de IA: fonte única, JSON, contrato OpenAPI e índice em texto simples.

Marco Zero é o nome interno deste marco de projeto: o momento em que a Praia Films passou a manter uma fonte única, pública e versionada das próprias informações institucionais em formato legível por agentes de IA. Não é uma posição de mercado.

Arquitetura

Como um agente de IA consulta a Praia Films

Uma fonte única de conteúdo, quatro formas públicas de acesso. Nenhuma delas exige autenticação e nenhuma permite escrita.

1

Descoberta

O agente encontra o índice em /llms.txt ou o contrato em /openapi.json, ambos públicos e sem autenticação.

2

Consulta

A leitura automática acontece em /functions/aiGatewayPublic, que responde application/json com CORS liberado.

3

Conteúdo

A resposta traz versão do schema, versão do conteúdo, dados institucionais, serviços, processo, perguntas e limites declarados.

4

Atribuição

O conteúdo pode ser lido e citado com indicação da fonte. Não existe endpoint público de escrita.

Recursos públicos do AI Gateway e resposta medida
RecursoEndereçoResposta medidaObservação
Página semântica/ai HTTP 200
text/html; charset=utf-8
Conteúdo completo em texto estruturado, para leitura humana.
Endpoint JSON/functions/aiGatewayPublic HTTP 200
application/json; charset=utf-8
Resposta nativa da API. CORS liberado e cache de 5 minutos.
Rota do site/api/public/ai-info HTTP 200
text/html; charset=utf-8
Espelho legível no navegador. Não é resposta JSON.
Contrato OpenAPI/openapi.json HTTP 200
application/json
Descreve os recursos públicos. O contrato revisado entra no ar junto com esta página.
Índice para LLMs/llms.txt HTTP 200
text/plain; charset=utf-8
Resumo e links oficiais em texto simples.

Status e tipo de conteúdo medidos diretamente nos endereços em 2026-11-07.

Leitura em uma linha

curl -s https://praiafilms.com.br/functions/aiGatewayPublic

Limitações e homologação

O que está implementado e o que responde de fato

Implementação é código escrito e testado. Disponibilidade é a resposta HTTP real. Esta seção separa as duas coisas, incluindo a limitação de arquitetura do próprio site.

Implementação

Código versionado, conteúdo mantido em um único registro administrativo, contrato escrito e suíte de testes automatizados executada a cada alteração.

Disponibilidade HTTP

Medida nos endereços públicos, com status, tipo de conteúdo e cabeçalhos registrados na seção de arquitetura. O que não foi medido não é apresentado como disponível.

A limitação da aplicação de página única

  • O site da Praia Films é uma aplicação de página única (SPA): as rotas são montadas no navegador.
  • Por isso, a rota /api/public/ai-info responde text/html, mesmo contendo o conteúdo completo. Medido em 2026-11-07.
  • Para leitura automática, o endereço correto é /functions/aiGatewayPublic, que responde application/json.
  • Consequência prática: um agente que segue apenas o caminho do site recebe a página; um agente que segue a documentação recebe o JSON. O conteúdo é o mesmo.
Estado de homologação de cada recurso público
RecursoEstadoBase do estado
Conteúdo institucionalhomologadoVersão 1.0, validada por testes automatizados.
Endpoint JSONhomologadoHTTP 200, application/json, CORS liberado, cache de 5 minutos.
Rota do sitehomologada como visualizaçãoHTTP 200, text/html. Não homologada como resposta JSON.
Contrato OpenAPIrevisadoA revisão que separa JSON de HTML é publicada junto com esta página.
Índice llms.txthomologadoHTTP 200, text/plain.
Dados estruturadosimplementadoSchema.org gerado dentro da página, não é arquivo separado.

Evidências

O que pode ser conferido hoje

Só entra nesta lista o que foi medido ou executado. Não há estimativa, projeção nem número de resultado comercial.

Versão do conteúdo

1.0

Schema 1.0. Versão devolvida no próprio JSON.

Testes automatizados

9 de 9

Suíte do módulo, executada em 2026-11-07 sem falhas.

CORS

Access-Control-Allow-Origin: *

Medido no endpoint JSON, apenas para leitura.

Cache

5 minutos

Cache-Control público no endpoint. O contrato OpenAPI usa 1 hora.

Cabeçalho próprio

X-Ai-Gateway: praia-films

Identifica a origem da resposta.

Somente leitura

Sem escrita pública

Nenhuma rota pública cria, altera ou remove conteúdo.

Dados sensíveis

Nenhum exposto

Teste automatizado confirma ausência de credenciais, e-mails de administrador e IDs internos.

Acesso por agente

Verificado

Requisição identificada como GPTBot recebeu o conteúdo na auditoria.

Fonte única

Registro administrativo

Leitura pública, escrita restrita a administradores.

Verificação de 2026-11-07. Os estados são pontuais: qualquer alteração posterior exige nova medição.

Linha do tempo

Marcos verificáveis

Cada entrada traz a fonte da data. Nenhum marco é apresentado como anterior ao primeiro registro do projeto.

  1. 2026-11-07 02:40 UTC

    Implementação do AI Gateway

    Fonte única de dados institucionais, endpoint público somente leitura, contrato OpenAPI, índice llms.txt e painel administrativo.

    Fonte: Histórico de versões do projeto

  2. 2026-11-07

    Auditoria de exposição pública

    Verificação de status HTTP, cabeçalhos, CORS, cache, ausência de dados sensíveis e acesso por agente de IA.

    Fonte: Medição direta nos endpoints

  3. 2026-11-07 03:16 UTC

    Correção do contrato

    O endpoint JSON canônico passa a ser a resposta nativa da API, e a rota do site passa a ser descrita como HTML. Revisão aplicada em OpenAPI, llms.txt, página /ai e cabeçalho do site.

    Fonte: Histórico de versões do projeto

  4. 2026-11-07

    Publicação desta página

    O Marco Zero passa a documentar a arquitetura, as limitações e o estado de homologação em endereço público.

    Fonte: Publicação do site

As datas acima vêm do histórico de versões do projeto e de medição direta. A data de publicação no domínio não é reproduzida aqui por não estar registrada de forma verificável nesta página.

Limites declarados

O que não afirmamos

Esta lista existe para evitar leitura publicitária do projeto. Se um texto futuro contrariar qualquer item abaixo, o texto está errado, não esta página.

  • Não afirmamos ser a primeira agência do Brasil, do Espírito Santo ou do mundo a publicar informações para agentes de IA.
  • Não afirmamos posição em ranking, prêmio, certificação, patente ou registro de qualquer natureza.
  • Não afirmamos que modelos de IA vão citar a empresa, preferir suas respostas ou recomendar seus serviços.
  • Não apresentamos métricas de audiência, alcance, vendas ou faturamento como resultado deste projeto.
  • Não afirmamos que o conteúdo publicado está imune a erro de interpretação por agentes: ele descreve o que a empresa declara sobre si.

Módulo editorial

Textos prontos para publicar

Copie o bloco que precisar, publique no canal correspondente e siga as orientações da aba. Os textos podem ser exportados em JSON, editados fora do site e importados de volta.

Conteúdo em uso: textos padrão. As alterações importadas ficam salvas neste navegador.

Tom institucional, direto, com o detalhe técnico no comentário.

Post principal

Publicamos as informações institucionais da Praia Films em um formato que agentes de IA conseguem ler. O projeto se chama Praia Films AI Gateway. Em vez de depender apenas de uma página que um modelo precisa interpretar visualmente, a empresa passou a manter uma fonte única de dados: o mesmo conteúdo que aparece no site também é entregue em JSON, documentado em OpenAPI e indexado em llms.txt. Como funciona, em quatro passos: 1. O conteúdo é mantido em um único registro no painel administrativo. 2. Um endpoint público, somente leitura, devolve esse conteúdo em JSON. 3. A documentação descreve o contrato, e o índice em texto simples orienta a descoberta. 4. Não existe escrita pública: nenhum agente altera informação institucional. O que isso resolve: quando alguém pergunta a um assistente o que a Praia Films faz, quais serviços oferece e quais são seus limites, a resposta pode partir de uma fonte declarada pela própria empresa, com versão e data. O que isso não resolve: publicar JSON não garante citação por modelos nem preferência em respostas. Não reivindicamos pioneirismo e não tratamos este projeto como posição de mercado. É um marco de projeto, com data, versão e evidências. Arquitetura, limitações declaradas e estado de homologação estão documentados em praiafilms.com.br/marco-zero-ai

Versão curta

As informações institucionais da Praia Films agora existem também em formato legível por agentes de IA: JSON, contrato OpenAPI e índice llms.txt, com fonte única no painel administrativo e leitura pública somente. O objetivo é simples: o que a empresa declara sobre si deve chegar ao modelo sem depender de interpretação visual da página. Sem promessa de citação, sem pioneirismo declarado. Documentação, limitações e evidências em praiafilms.com.br/marco-zero-ai

Comentário técnico (para publicar na sequência)

Detalhes de arquitetura, para quem quiser conferir: O endpoint JSON é /functions/aiGatewayPublic, com CORS liberado e cache de 5 minutos. O contrato está em /openapi.json e o índice em /llms.txt. O conteúdo tem versão própria e é validado por 9 testes automatizados. Um ponto que vale a transparência: o site é uma aplicação de página única, então a rota /api/public/ai-info entrega HTML, não JSON. A rota certa para leitura automática é o endpoint da função. Isso está declarado na página, junto com o efeito prático de cada escolha. Nenhuma rota pública escreve. A edição fica restrita ao painel administrativo.