analisar_pacing_pre_venda
ChatGPTAnalisa evolução histórica da pré-venda pela sale_date. Use para histórico, curva, pacing, vendas em data passada e acumulado até uma data passada. Para todo o histórico, use date_scope=full_history com um único movie_id; o Gateway descobre a primeira sale_date, sem janela arbitrária, e cutoff_date é inclusiva quando informada. O modo consolidated usa a série diária por filme com cobertura Ingresso.com; o modo detailed usa cobertura Ingresso.com por exibição. tickets_sold_preview significa ingressos vendidos antecipadamente para sessões classificadas como pré-estreia; pertence ao histórico de pré-venda, não representa público realizado e não substitui Resultado de Mercado. A resposta usa value_nature=historical_sales.
analisar_pre_venda_atual
ChatGPTAnalisa a fotografia atual da pré-venda. A base temporal é session_date e somente sessões de hoje ou futuras são válidas. Para 'pré-venda de hoje', filtre exatamente session_date=hoje; não use um intervalo aberto para o futuro. Para 'pré-venda atual' sem data específica, um intervalo aberto session_date>=hoje só é permitido quando a análise estiver seletivamente restrita por movie_id ou theater_id. Consultas amplas sem movie_id/theater_id exigem início e fim de session_date e no máximo 31 dias. Retorna value_nature=current_snapshot, não historical_sales. Não expõe granularidade de sala/sessão, não aceita paginação enumerável e não deve ser usada para reconstrução da base.
analisar_resultado_mercado
ChatGPTAnalisa Resultado de Mercado realizado em quatro modos controlados dentro da mesma ferramenta. weekly analisa por CineSemana com filtros, agrupamentos, ranking, totais e participação; daily_market consulta série ou agregado diário do mercado; movie_daily consulta série diária ou acumulado de um único movie_id canônico; cine_week_comparison compara uma CineSemana fechada com posições anuais equivalentes, sem deslocar datas civis e sem usar CineSemana.ANO isoladamente. Público usa admissions e renda usa gross. Resultado de pré-estreia deve usar fatos realizados e nunca tickets_sold_preview. Períodos futuros não são substituídos por pré-venda. movie_daily nunca é usado como total automático de mercado. A resposta usa value_nature=realized e preserva a fonte do modo selecionado. Esta ferramenta é exclusivamente analítica, não expõe granularidade de sala/sessão e não permite reconstrução ou exportação da base. No modo weekly, a CineSemana corrente é válida e deve retornar o resultado parcial realizado já consolidado pela fonte. Não exija o fechamento da semana para responder 'resultado desta semana'. Em uma sexta-feira, por exemplo, quinta-feira já pode compor o resultado; nos dias seguintes, use todo o acumulado realizado disponível. Não infira dias ainda não consolidados como zero. A exigência de CineSemana fechada é exclusiva de cine_week_comparison. No modo weekly, público deve ser lido exclusivamente pelas métricas públicas corretas para o recorte solicitado: admissions para o acumulado da CineSemana até o último dia consolidado, weekend_admissions para o fim de semana e thursday_admissions, friday_admissions, saturday_admissions, sunday_admissions, monday_admissions, tuesday_admissions ou wednesday_admissions para cada dia específico. Na fonte semanal, essas métricas correspondem respectivamente a Ocupados, FDS e aos campos Quinta, Sexta, Sabado, Domingo, Segunda, Terca e Quarta. QTD Tot nunca representa público e nunca deve ser usado como admissions, fallback, aproximação ou inferência. Nenhum outro campo ou métrica pode substituir essas referências de público no modo weekly. Para a CineSemana corrente no modo weekly, use exatamente um filtro temporal no formato {dimension: week_start, operator: between, from: YYYY-MM-DD, to: YYYY-MM-DD}, usando a quinta-feira inicial da CineSemana em from e to quando consultar uma única semana.
auditar_ocupacao_historica
ChatGPTAudita ocupação histórica a partir da última posição persistida de occupied para sessões de D-1 ou anteriores. Exige session_date fechado com eq ou between e aceita no máximo 31 dias por chamada. Permite análise agregada por filme, cinema, rede, cidade, UF, faixa horária e outras dimensões públicas; room_id, room e session_hour são somente filtros seletivos. Para uma sessão pontual, combine filme/cinema/sala/data/horário. Não expõe IDs crus de ticketeira, registros brutos, URLs, mapas de assentos ou paginação enumerável. occupied não é bilheteria oficial nem admissions de Resultado de Mercado.
buscar_cinemas
ChatGPTLocaliza cinemas no cadastro canônico da Vibezz. Filtros suportados exclusivamente: q para nome ou alias, corporation, city, uf e status. Não aceita outros filtros e não deve originar sugestão de SQL ou schema. Exige ao menos um filtro de identificação e retorna no máximo 50 resultados por chamada. Use esta ferramenta sempre que o usuário pedir localização, identificação, cidade, UF, rede ou cadastro de um cinema coberto pela AIDA; não responda por conhecimento próprio quando esta ferramenta puder resolver a pergunta.
buscar_filmes
ChatGPTLocaliza filmes no cadastro canônico da Vibezz. Filtros suportados exclusivamente: q para título ou nome, ancine_id, distributor, release_date_from e release_date_to para data de estreia. Use para resolver o filme canônico antes de análises temporais; a data oficial de estreia é necessária para separar pré-estreia, pré-venda e resultado. Não consulta data de cadastro, não aceita outros filtros e não deve originar sugestão de SQL ou schema. Retorna no máximo 50 resultados por chamada.
consultar_capacidades_disponiveis
ChatGPTConsulta no Vibezz Console os módulos de negócio efetivamente autorizados para o principal autenticado. Use obrigatoriamente quando o usuário perguntar o que ele pode fazer, quais módulos possui, quais recursos estão disponíveis para ele ou pedir orientação geral sobre o AIDA. Não anuncie como disponível um módulo que não conste nesta resposta.
consultar_pre_venda
ChatGPTConsulta a fotografia acumulada atual da pré-venda de um filme pelo ID canônico. A base temporal é session_date e a cobertura reúne todas as ticketeiras disponíveis. 'Pré-venda de hoje' exige session_date_from=session_date_to=hoje; 'pré-venda atual' sem data usa hoje em diante. O valor não representa quantos ingressos foram vendidos na data da consulta e não substitui pacing histórico. Filtros adicionais: theater_id, city, uf e corporation. Destina-se a consulta analítica e não à exportação da fonte.
consultar_showtimes
ChatGPTConsulta programação de sessões em duas modalidades controladas. mode=sessions retorna até 100 sessões com filme, cinema, sala, data, horário, formato e status, sem offset; mode=cine_week_comparison compara contagens resumidas de sessões, filmes, cinemas e salas entre duas CineSemanas canônicas aplicando os mesmos filtros. Sessões canceladas são excluídas por padrão. Não publica URLs, assentos, ocupação, SQL ou schema e não deve ser usada em janelas sucessivas para reconstruir a fonte.
descrever_capacidades_analiticas
ChatGPTDescreve dinamicamente dimensões, métricas, operadores, fontes, coberturas, limites, política de exposição e regras temporais das análises de fotografia atual e pacing. Use antes de uma análise quando o campo ou domínio correto não estiver claro.
descrever_capacidades_auditoria_ocupacao
ChatGPTDescreve o módulo AUDIT de ocupação histórica. AUDIT consulta a última posição de ocupação persistida em sessões de D-1 ou anteriores, usando dimensões canônicas e política analytics-only. Use antes da auditoria quando houver dúvida sobre filtros, métricas, faixa horária, sala seletiva, limites ou semântica temporal. Não representa Resultado de Mercado nem público oficial realizado.
descrever_capacidades_resultado_mercado
ChatGPTDescreve dinamicamente Resultado de Mercado no modo solicitado. weekly preserva o catálogo histórico por CineSemana; daily_market descreve mercado diário agregado; movie_daily descreve resultado diário/acumulado de um filme; cine_week_comparison descreve comparação controlada entre CineSemanas equivalentes. Todos os modos representam fatos realizados, preservam fonte/cobertura/maturidade e não publicam granularidade de registro. No modo weekly, a CineSemana corrente é válida e deve retornar o resultado parcial realizado já consolidado pela fonte. Não exija o fechamento da semana para responder 'resultado desta semana'. Em uma sexta-feira, por exemplo, quinta-feira já pode compor o resultado; nos dias seguintes, use todo o acumulado realizado disponível. Não infira dias ainda não consolidados como zero. A exigência de CineSemana fechada é exclusiva de cine_week_comparison. No modo weekly, público deve ser lido exclusivamente pelas métricas públicas corretas para o recorte solicitado: admissions para o acumulado da CineSemana até o último dia consolidado, weekend_admissions para o fim de semana e thursday_admissions, friday_admissions, saturday_admissions, sunday_admissions, monday_admissions, tuesday_admissions ou wednesday_admissions para cada dia específico. Na fonte semanal, essas métricas correspondem respectivamente a Ocupados, FDS e aos campos Quinta, Sexta, Sabado, Domingo, Segunda, Terca e Quarta. QTD Tot nunca representa público e nunca deve ser usado como admissions, fallback, aproximação ou inferência. Nenhum outro campo ou métrica pode substituir essas referências de público no modo weekly. Para a CineSemana corrente no modo weekly, use exatamente um filtro temporal no formato {dimension: week_start, operator: between, from: YYYY-MM-DD, to: YYYY-MM-DD}, usando a quinta-feira inicial da CineSemana em from e to quando consultar uma única semana.
descrever_capacidades_showtimes
ChatGPTDescreve o contrato controlado de SHOWTIMES: filtros canônicos de filme, cinema e sala, regras temporais, status, limites, campos retornáveis e comparação de CineSemanas. SHOWTIMES representa programação observada e não métricas de ocupação ou resultado.
detalhar_cinema
ChatGPTRetorna um cinema somente pelo ID canônico e pode incluir suas salas. Use include_rooms=true quando o usuário perguntar quantidade, nomes ou detalhes das salas do cinema; não responda esses dados por conhecimento próprio quando a AIDA puder consultá-los.
detalhar_filme
ChatGPTRetorna um filme específico somente pelo ID canônico.
fancast_buscar_filmes
ChatGPTLocaliza filmes disponíveis para forecast e retorna o ID interno do Fancast. Não assume equivalência com o movie_id canônico da AIDA.
fancast_buscar_filmes_engajamento
ChatGPTLocaliza filmes futuros, em release ou históricos com métricas de engajamento e retorna o movie_id de vibezz_movie.
fancast_buscar_filmes_historico
ChatGPTLocaliza filmes com histórico diário, backtest ou ambos e informa a disponibilidade de cada fonte. Use este catálogo antes das consultas históricas.
fancast_consultar_backtest
ChatGPTConsulta o backtest oficial recalculado pelo motor do Fancast, com previsão, caminhos, pesos, realizado e erro. Não reimplementa o motor na AIDA.
fancast_consultar_engajamento
ChatGPTConsulta e interpreta métricas gerais e por exibidor. A regra temporal oficial permanece no AIDA Fancast e é independente do forecast.
fancast_consultar_historico
ChatGPTConsulta snapshots oficiais materializados do forecast. Sem data retorna a série; com data retorna o snapshot e os comparáveis gravados naquele dia.
fancast_consultar_previsao
ChatGPTConsulta a previsão oficial atual produzida pelo AIDA Fancast, preservando o resultado estruturado do motor oficial.
