naia GEO

Cancela a descoberta de pessoas em andamento da marca e para a pesquisa na web. Não cobra nada. Se a descoberta era uma atualização paga, o crédito volta inteiro, porque a descoberta só entrega o resultado no fim. NUNCA prometa a devolução antes de chamar: o retorno traz refunded e refundedCredits com o que o servidor realmente gravou (descoberta gratuita cancelada devolve refunded=false, porque não havia nada a devolver). Sem descoberta ativa, responde que não há o que cancelar. Se ela terminar entre a leitura e o cancelamento, nada é alterado e nada é estornado. Depois do cancelamento, uma nova descoberta pode ser iniciada com autopilot_authority_discover_people.

autopilot_authority_discover_people_cancel

Exporta a lista de matérias de uma pessoa (personId) ou da empresa (sem personId) em Markdown ou JSON, pronta para colar ou importar no site do cliente. Gratuita e somente leitura. Usa o mesmo critério do site de autoridade: só matéria verificada e liberada para publicação, sem nota, sem material sinalizado e sem homônimo da empresa. Markdown sai agrupado por ano, com título, veículo, data e link. JSON traz subject, generatedAt, total e items (title, url, publisher, domain, publishedAt, type). Entregue o campo content ao usuário sem reescrever.

autopilot_authority_export

Lê a identidade pública de uma pessoa da Autoridade: identificadores (Wikidata e ORCID) com o status de cada um, perfis sociais, retrato, endereço do site pessoal e o que ainda falta, com prioridade calculada da evidência real dela e não de uma lista fixa. Não faz nenhuma chamada externa e não cobra créditos: tudo sai do material que a varredura já coletou. Os três status de identificador NUNCA podem ser trocados entre si: detected é candidato que a naia encontrou e ninguém confirmou, e não pode ser apresentado como a identidade da pessoa; confirmed passou por decisão humana e entra no sameAs da página de autoridade; rejected é o homônimo descartado. O mesmo vale para perfis: unverified_candidate é conta que apareceu na busca e ninguém confirmou. Use antes de propor qualquer trabalho de identidade e para responder o que falta para a pessoa ter item no Wikidata. Consolida no cadastro o que foi detectado agora, então exige chave com permissão de escrita.

autopilot_authority_identity

Confirma, rejeita ou devolve para candidato um identificador (Wikidata, ORCID) ou um perfil social de uma pessoa, e também remove o retrato dela. EFEITO PÚBLICO: identificador e perfil confirmados entram no sameAs da página de autoridade da pessoa, e o QID confirmado vira a referência canônica que o JSON-LD publica. Confirmar é sempre um gesto de quem chama, nunca da leitura: o que a varredura detectou fica como detected para sempre até alguém decidir, porque um ORCID ou um perfil de homônimo ligaria o histórico de outra pessoa a ela. Confirme com o usuário antes de chamar, e prefira mostrar o que está detectado com autopilot_authority_identity primeiro. GRATUITA. Em target='photo' a tool apenas REMOVE o retrato (e exige confirmed=true). Para ENVIAR ou trocar a foto, use autopilot_authority_update_person com photoUrl ou photoBase64: o arquivo vem da própria pessoa, nunca de coleta automática.

autopilot_authority_identity_decide

Lê a biblioteca de Autoridade da marca: as matérias que sustentam (ou não) a autoridade da empresa e de cada pessoa, com filtros por pessoa, nota, status de verificação, origem e domínio, mais os agregados da marca inteira. GRATUITA e somente leitura: não roda varredura nova. Use para responder "quais matérias temos", "qual é a autoridade desta pessoa hoje", "o que a varredura descartou" e para mostrar a evidência antes de propor qualquer trabalho. Cada linha carrega o veredito real e as dimensões SEPARADAS (natureza da fonte, independência editorial, profundidade nominal, nota), sem score único por fonte. Três status distintos e nunca intercambiáveis: verified (a naia leu a página e ela nomeia o alvo), pending (a URL não pôde ser lida por paywall, bloqueio anti-bot ou site fora do ar, ou a página não nomeia o alvo) e rejected (é de outra pessoa, tipicamente homônimo). Pendente NÃO é ausência de cobertura, é ausência de leitura. sourceOrigin distingue o que a varredura verificou do que o usuário colou à mão, e as duas coisas não podem ser apresentadas com a mesma força. POR PADRÃO A LISTA NÃO INCLUI O MATERIAL SINALIZADO: publishable=false marca material reputacional (processo, polêmica, crise, vida pessoal) que a naia mantém na biblioteca como evidência do que existe publicamente mas decidiu NÃO amplificar, e que fica fora do site de autoridade e do sameAs até liberação humana. Nunca use uma linha dessas como prova de autoridade nem como citação ao gerar conteúdo. Esconder o CONTEÚDO por padrão não esconde a EXISTÊNCIA: a resposta traz flaggedOmitted (quantas ficaram de fora deste recorte) e totalIncludingFlagged, então nunca diga que a pessoa tem N matérias quando flaggedOmitted for maior que zero. Para ver o material retido, chame de novo com includeFlagged=true, ou com publishable='flagged' para receber só ele. Em stats, byGrade conta somente as verificadas, porque rejeitada não é evidência, e stats.flagged sempre sai, porque contagem não é conteúdo.

autopilot_authority_library

Lista as pessoas de autoridade da marca (área Autoridade do dashboard): fundadores, sócios e diretores, com status (confirmed, candidate, excluded), vínculo com a marca, cargo, origem (descoberta ou cadastro manual) e quantas fontes cada um tem. Use antes de adicionar alguém, para não repetir uma pessoa que já está na lista.

autopilot_authority_list_people

Quem leu o site de autoridade de uma pessoa: crawlers de IA (quais motores, quais páginas, quando cada um leu pela primeira vez), pessoas que chegaram de uma conversa de IA, e pessoas que vieram de busca, acesso direto ou link de outro site, com a comparação contra o período anterior. O campo referralSources abre a origem das pessoas por categoria (ai, search, video, social, messaging, site, direct) e por plataforma (YouTube, LinkedIn, Instagram, WhatsApp, Google e o host de outros sites), com o período anterior de cada uma e a série diária; a origem vem do Referer, e aplicativos que não o enviam caem em direct, então o número de cada rede é um mínimo, nunca o total. Somente leitura, NÃO publica e não cobra créditos. A honestidade do painel está em dois campos que precisam ser lidos antes de qualquer número: unavailable significa que a contagem NÃO pôde ser lida (site ainda não publicado, credencial dessincronizada ou banco do tenant fora do ar) e a série vem VAZIA de propósito, porque zero inventado passa por resposta e é pior do que dizer que não deu; degraded significa que parte das consultas falhou e parts nomeia quais blocos faltam. Nos dois casos não relate os totais como se fossem a medição do período. Um motor com firstReadAt nulo nunca leu o site, o que é uma resposta e não um buraco.

autopilot_authority_site_analytics

Exclui de vez o site de autoridade de uma pessoa: tira do ar e apaga hospedagem, endereço próprio, textos editados, aparência, versões, imagens e estatísticas. Não tem volta. Não cobra créditos e não devolve os da criação. A pessoa e as matérias dela continuam na Autoridade, e um site novo pode ser criado depois pelo painel (cobra a criação de novo) no mesmo endereço da naia. Só chame depois de o usuário pedir a exclusão com todas as letras e confirmar o nome da pessoa: confirmName precisa ser o nome dela (acento e caixa não importam). Recusa com criação ou publicação em andamento.

autopilot_authority_site_delete

Estado do ENDEREÇO do site de autoridade: qual domínio está ligado, se já está no ar (live: DNS confirmado e certificado ativo), o que o DNS respondeu de fato, a lista ordenada do que o cliente precisa apagar e criar no DNS (plan.steps, com o estado de cada item), o provedor de DNS reconhecido e em que pé está o certificado. É a tool de 'meu domínio já entrou no ar?'. Somente leitura: NÃO publica, não compra domínio, não cria zona e não cobra créditos. dnsState distingue os casos que não podem ser confundidos: pointing é o domínio apontando para nós, pending é ainda não apontou, pointing_elsewhere é apontando para outro provedor (o cliente mexeu no DNS errado) e unknown é consulta que não respondeu, que NÃO é o mesmo que não apontar. certStatus null significa que não há certificado, e UNKNOWN significa um estado que não reconhecemos: são coisas diferentes, e PROVISIONING costuma ser o _acme-challenge que ainda não foi criado no DNS do cliente. autoChecks, maxAutoChecks e gaveUpAt mostram as conferências automáticas: a naia confere a cada 15 minutos, no máximo 4 vezes enquanto há algo a corrigir no DNS; depois ela para (gaveUpAt preenchido) e avisa o dono por e-mail, e o Validar agora do painel retoma. A espera do certificado em emissão, com o DNS já certo, não conta. A compra e a troca de endereço são feitas no painel, em Autoridade, aba Sites.

autopilot_authority_site_domain

Lista os 20 pedidos de edição feitos à naia mais recentes para o site de autoridade, vindos do painel ou do MCP: o pedido escrito, os marcadores com bloco, trecho e comentário, o status (proposed é proposta ainda sem decisão, applied foi aplicada, discarded foi descartada, failed é falha do modelo), o resumo, as mudanças propostas campo a campo e o que foi recusado. Serve para um agente externo ver o que a pessoa pediu e marcou no painel. Somente leitura: NÃO publica, não grava nada e não cobra créditos.

autopilot_authority_site_edit_requests

Estado do site de autoridade de uma pessoa: se está no ar, o endereço, o tema e a aparência aplicados, o layout (ordem e visibilidade dos blocos, números do painel, variante do hero), blockCatalog (cada bloco da home, se aparece hoje e por que não), placeholders (marcadores dos blocos próprios com o valor atual), uploadGuide (como preparar imagem antes de enviar), o conteúdo editável inteiro, a versão para escrita (contentVersion), o que os gates reprovaram na última publicação e quais seções estão ocultas por falta de dado e autoSync, a atualização automática (quando o site se republicou sozinho, com quantas matérias, e se há atualização na fila). Não cobra créditos. Fluxo: autopilot_authority_site_get para ler contentVersion e estado, depois a escrita, depois autopilot_authority_site_publish, e autopilot_authority_site_get de novo para acompanhar o build.

autopilot_authority_site_get

Retrato do hero do site de autoridade, em duas variantes. A principal (desktop) transforma a foto da pessoa numa faixa larga 21:9, estendendo apenas o cenário ao redor dela. A do celular reproduz a MESMA foto em resolução alta, no enquadramento original (1:1 ou 4:5, o mais próximo da foto), sem estender nem recortar. A pessoa nunca é alterada: mesmo rosto, mesma expressão, mesma pose, mesma roupa, sem rejuvenescer e sem retocar. status devolve o estado atual (aprovado, pronto para decisão, em geração ou com falha), com as variantes que existem e a observação usada. generate pede uma geração nova: target escolhe desktop (só a principal), mobile (só a do celular) ou both (as duas, padrão); a variante que fica de fora é copiada do candidato pronto mais recente ou do aprovado. note é uma observação opcional de até 400 caracteres, sem link (por exemplo "fundo mais claro"), que o gerador segue só quando não conflita com as regras de identidade. A primeira geração já vem incluída na publicação do site; pedir outra custa 2 créditos, qualquer que seja o target, com limite de 5 pedidos por hora. Gerar ou decidir aqui NÃO publica sozinho: nada muda no site no ar até approve, que leva o retrato pronto ao próximo build. approve exige a variante principal; sem a do celular, o site usa a foto da pessoa no celular. reject descarta o candidato sem mexer no que está publicado, e keep_original remove o retrato do hero e volta à foto original da pessoa. approve e reject exigem heroImageId, devolvido por generate ou por status. Fluxo: autopilot_authority_site_get para ler contentVersion e estado, depois a escrita, depois autopilot_authority_site_publish, e autopilot_authority_site_get de novo para acompanhar o build.

autopilot_authority_site_hero

Monta a prévia da página com o que está SALVO e ainda não foi publicado, pelo MESMO renderizador do publish, opcionalmente com um rascunho de layout e de blocos próprios por cima (nada é gravado). Serve para conferir o resultado de uma edição antes de gastar o build, e para saber quais blocos a página realmente mostra hoje: uma seção pode sumir por falta de dado mesmo com a chave ligada (contato sem e-mail, trajetória sem marcos), e suppressed diz o que foi omitido e por quê. Somente leitura: NÃO publica, não grava nada e não cobra créditos. Duas coisas que a prévia NÃO é: não é a página no ar (o que está publicado é o HTML do último build, e só autopilot_authority_site_publish troca isso) e não roda os gates de publicação, que valem sobre o HTML final, então uma prévia bonita não garante publicação aprovada. O HTML completo só volta com includeHtml=true, porque é uma página inteira; por padrão voltam os blocos, as seções e o que foi omitido.

autopilot_authority_site_preview

Publica o site de autoridade com o conteúdo e a aparência salvos. Devolve o id do build; acompanhe com autopilot_authority_site_get, que traz o estágio atual e, se algum gate reprovar, o que faltou. Publicar depois de editar texto ou aparência NÃO cobra créditos. Com outra publicação em andamento (inclusive uma atualização automática), a resposta traz alreadyRunning e, quando a sua publicação ficou na fila, queued=true: ela sai logo depois, sozinha. Criar o site pela primeira vez cobra 300 créditos e regerar todos os textos do zero cobra 100 créditos. Se um gate reprovar, nada é publicado e o site anterior continua no ar. Fluxo: autopilot_authority_site_get para ler contentVersion e estado, depois a escrita, depois autopilot_authority_site_publish, e autopilot_authority_site_get de novo para acompanhar o build.

autopilot_authority_site_publish

Republica o site de autoridade de uma pessoa com o que mudou na biblioteca desde a última publicação: matéria verificada nova entra, matéria rejeitada, sinalizada ou apagada sai. Não cobra créditos e não pede confirmação. O site já se atualiza sozinho quando a varredura termina e quando uma matéria é aprovada, liberada, adicionada ou apagada; esta tool é a rede de segurança e só publica o que ainda estiver pendente. Só atualiza site que já foi ao ar e nunca cria site. Sem nada pendente devolve refreshed=false com reason no_new_citations; com publicação em andamento, build_running. Reescreve os textos gerados (trigger citation_change) quando entraram 3 ou mais matérias novas desde a última geração ou quando alguma matéria saiu do site; fora disso recompila com o texto salvo (citation_sync). Resultado iniciado significa publicação em segundo plano: acompanhe com autopilot_authority_site_get, que traz autoSync.

autopilot_authority_site_refresh

Pede à naia uma edição de TEXTO do site de autoridade, como o modo Pedir à naia do painel. Escreva o pedido em instruction e, se quiser, marque trechos em annotations. A naia devolve a proposta campo a campo em changes (path, label, before, after), mais summary e refused. Ela só reescreve texto que já existe no conteúdo SALVO: fato novo (cargo, data, número, empresa, prêmio) que não esteja no conteúdo nem nas matérias confirmadas vai para refused, nunca para o texto, e links, fontes, retrato, hero e aparência ficam fora do alcance. Todo campo alterado passa a contar como escrito pela pessoa, e a próxima regeneração o preserva. apply=false (padrão) não grava nada no site: mostre a proposta ao usuário antes. apply=true grava a proposta no conteúdo com a mesma checagem de contentVersion de autopilot_authority_site_update_content; se o site mudou desde a leitura, nada é gravado e o pedido fica como proposta. NÃO publica na hora: depois de aplicar, chame autopilot_authority_site_publish (a atualização automática, quando uma matéria entra ou sai, também leva o texto salvo). Não cobra créditos, com limite de 30 pedidos por hora por usuário. Leva de 5 a 45 segundos. Fluxo: autopilot_authority_site_get para ler contentVersion e estado, depois a escrita, depois autopilot_authority_site_publish, e autopilot_authority_site_get de novo para acompanhar o build.

autopilot_authority_site_request_edit

Restaura o tema, a aparência (cores, tipografia, modo claro ou escuro e CSS) e a estrutura do site de autoridade de uma versão de autopilot_authority_site_revisions. Quando hasContent=true, também substitui o conteúdo editável pelo texto salvo naquela versão. Versões antigas sem conteúdo mantêm o texto atual. A restauração tenta registrar uma versão nova no histórico limitado às 50 mais recentes; falha nesse registro não desfaz a alteração salva. Para desfazer, restaure uma versão anterior disponível. NÃO publica na hora: chame autopilot_authority_site_publish depois; a próxima publicação manual ou automática leva o estado restaurado ao ar. Não cobra créditos. Fluxo: autopilot_authority_site_get para ler contentVersion e estado, depois a escrita, depois autopilot_authority_site_publish, e autopilot_authority_site_get de novo para acompanhar o build.

autopilot_authority_site_restore_revision

Lista até 50 versões salvas do site de autoridade, mais recentes primeiro: tema, aparência (cores, tipografia, modo claro ou escuro e CSS) e estrutura. hasContent=true identifica versões que também guardam conteúdo editável, substituído junto com o visual ao restaurar; versões antigas sem conteúdo preservam o texto atual. A lista informa hasContent, mas não devolve o texto completo das versões. Use antes de autopilot_authority_site_restore_revision para achar a versão certa. Somente leitura: NÃO publica, não grava nada e não cobra créditos.

autopilot_authority_site_revisions

Estado do Google Search Console e do Google Analytics do site de autoridade: se o código de verificação do Google está salvo (gsc.tokens, até 3, cada um com token e savedAt; o código não é segredo, vai no HTML público, e gsc.tokens[].token é o valor exato que remove_token aceita para tirar um código colado da conta errada), se a tag já aparece na home publicada, se a propriedade foi encontrada na conta Google conectada, se o mapa do site (gsc.sitemapUrl) foi enviado e está sem erro, se a home está indexada, e se o Analytics está ligado (analytics.on, analytics.measurementId) ou foi pulado. O estado é calculado a cada leitura: gsc.state diz onde a pessoa está (not_started, token_saved, tag_missing, tag_live, verified, verified_manual, sitemap_pending, sitemap_errors, sitemap_ok, indexed, not_indexed, skipped), gsc.skipped diz que o passo foi adiado, e gsc.overlays traz o que se soma ao estado (oauthBlocked: a conexão automática está indisponível; reauthRequired: reconectar o Google; accountMismatch: o site está em outra conta Google). gsc.unavailable indica o que não respondeu agora (sitemap e indexing no Google; home quando a home publicada não abriu para a conferência da tag), o que NÃO é o mesmo que erro no mapa, página fora do índice ou tag ausente. refresh controla o custo: none lê só o guardado (padrão), live confere a home publicada, google também lê o Search Console da marca, respeitando um intervalo mínimo entre leituras e a cota diária de inspeções. Com refresh, a leitura pode guardar o que conferiu, mas nunca muda o código, o ID do Analytics nem as decisões da pessoa. Somente leitura: NÃO publica e não altera o site. Não cobra créditos. O site precisa estar no ar (AUTHORITY_SITE_NOT_LIVE). Para salvar o código, ligar o Analytics, confirmar a verificação ou pular um passo, use autopilot_authority_site_set_search_presence.

autopilot_authority_site_search_presence

Muda o layout, as cores, a tipografia e o CSS personalizado do site de autoridade. Layouts disponíveis: editorial (padrão) e flat (recomendado, mais leve e mais fácil de ler). NÃO prometa ao usuário que um layout melhora citação em IA: os dois geram o mesmo HTML. O CSS é conferido no servidor e recusado inteiro quando tem problema, com o motivo de cada um. Imagens em url() só podem vir de cdn.naia.today, enviadas por autopilot_authority_site_upload_asset. reset=true volta ao layout padrão e apaga cores e CSS. NÃO publica. Não cobra créditos. Fluxo: autopilot_authority_site_get para ler contentVersion e estado, depois a escrita, depois autopilot_authority_site_publish, e autopilot_authority_site_get de novo para acompanhar o build.

autopilot_authority_site_set_appearance

Muda a estrutura da home do site de autoridade: ordem e visibilidade dos blocos, números do painel de prova, variante do hero, espaçamento e escala do texto. O layout só esconde e reordena: bloco sem dado suficiente continua fora da página mesmo se você pedir, e suppressedRequested diz quais e por quê. advice traz o que a mudança custa em sinal de autoridade (por exemplo, esconder o número de veículos); nunca bloqueia, mas mostre ao usuário. O hero é sempre o primeiro (não entra em blocks); rodapé, página de fontes e política editorial não podem ser alterados, e o link Fontes do menu continua sempre. Bloco do catálogo que você não listar entra na posição padrão, depois dos listados; id repetido ou desconhecido é recusado. Blocos próprios entram como custom:<id>, depois de criados por autopilot_authority_site_update_content. reset=true volta ao layout padrão. NÃO publica. Não cobra créditos. Fluxo: autopilot_authority_site_get para ler contentVersion e estado, depois a escrita, depois autopilot_authority_site_publish, e autopilot_authority_site_get de novo para acompanhar o build.

autopilot_authority_site_set_layout

Grava o Google Search Console e o Google Analytics do site de autoridade e, quando o HTML do site muda, republica o site sozinho. Não cobra créditos. action: add_token (exige token: o código da Tag HTML de verificação do Search Console, ou a tag inteira; até 3 por site), remove_token (exige token: o valor exato de gsc.tokens[].token devolvido por autopilot_authority_site_search_presence), confirm_manual (a pessoa já clicou em Verificar no Google e não há como ler a conta Google conectada), set_analytics (exige measurementId: o ID de medição do GA4, que começa com G-; tags UA-, GTM- e AW- são recusadas), clear_analytics (desliga o Analytics), skip e reopen (exigem step: gsc ou analytics; adiam o passo ou o retomam). Campo que não pertence à ação escolhida é recusado. remove_token apaga o código salvo; set_analytics substitui o ID anterior; clear_analytics apaga o ID salvo. Após a publicação, remover o código pode afetar a verificação do Search Console, e trocar ou desligar o Analytics interrompe a coleta para o ID anterior. Essas configurações não entram no histórico de versões do site; para repor, é preciso informar o código ou ID novamente. Só add_token, remove_token, set_analytics e clear_analytics mudam o HTML e republicam; as demais só gravam a decisão. O Analytics entra no site com a faixa de consentimento: os cookies de Analytics só são liberados com o aceite do visitante, o Google pode receber sinais sem cookies antes da escolha, e configurar o ID não confirma visitas no GA4. Em erro, nada foi salvo: SEARCH_PRESENCE_SAVE_FAILED pede para tentar de novo em instantes, e SEARCH_PRESENCE_INVALID_TOKEN, SEARCH_PRESENCE_TOO_MANY_TOKENS, SEARCH_PRESENCE_UNKNOWN_TOKEN, SEARCH_PRESENCE_WRONG_PRODUCT e SEARCH_PRESENCE_INVALID_MEASUREMENT_ID explicam o que corrigir. Em sucesso (saved=true) o dado está salvo, e rebuild diz o que aconteceu com a republicação gratuita: none (nada mudou no HTML), started (republicação aberta; acompanhe com autopilot_authority_site_get), queued (há publicação em andamento e o pedido ficou na fila), rate_limited, not_published ou failed; nesses três a republicação não foi aberta agora e a próxima publicação leva a mudança ao ar. O site precisa estar no ar (AUTHORITY_SITE_NOT_LIVE). Exige permissão de escrita na marca.

autopilot_authority_site_set_search_presence

Reescreve o conteúdo do site de autoridade: apresentação, manifesto, trajetória, trabalho atual, competências, presença pública, FAQ, contato, links de marca, logo do cabeçalho (header.logoAssetId com o id de uma imagem da biblioteca deste site; null tira o logo e o cabeçalho fica só com a navegação, sem o nome em texto; header.logoSize sm, md ou lg) blocos próprios (customBlocks, até 12: id em letras minúsculas, números e hífen; kind text (heading e body), imageText (heading, body, imageAssetId, imageAlt, imageSide left ou right), quote (quote, attribution), stats (heading e items de 2 a 4 com value e label), gallery (heading e items de 1 a 9 com assetId, alt e caption), video (heading, url do YouTube ou Vimeo, posterAssetId, caption, playback inline para tocar na própria página ou link para abrir no YouTube ou no Vimeo; vale link quando ausente), logos (heading e items de 1 a 12 com label e, opcional, assetId com o logo do veículo, imagem da biblioteca deste site; display text só o nome, both logo e nome ou logo só o logo, e o veículo sem logo segue pelo nome) ou cta (heading, body, buttonLabel e href https, mailto:, /caminho ou #âncora); sem kind vale text; align left ou center (text, quote, stats, video, logos e cta) e width narrow, medium, wide ou full (text, quote, video e cta; em imageText é o tamanho da imagem: narrow, medium ou wide) são opcionais e o padrão de cada formato é o campo ausente; heading até 120 caracteres, body até 2000, quebra dupla vira parágrafo, nenhum HTML; toda imagem é o id de uma imagem da biblioteca deste site), marca dos veículos da faixa Onde há publicações (pressBrands: display text só o nome, both logo e nome ou logo só o logo; byDomain com o domínio do veículo e o id de uma imagem da biblioteca deste site, até 24), fotos da página de imprensa (pressPhotos: portraitAssetId troca o retrato oficial por uma imagem da biblioteca, vazio usa o retrato do topo do site; items, até 12, com assetId, caption até 200 com quem aparece e o contexto, credit até 120 e alt até 200; a mesma lista alimenta a galeria de /imprensa, o JSON-LD, o sitemap de imagens e o llms.txt, e só vale foto real enviada à biblioteca, nunca gerada), páginas próprias (pages, até 10: id é o endereço /<id> em minúsculas, números e hífen, fora de imprensa, fontes, busca e outras rotas do site; title até 120 vira o H1; description até 160; intro até 2000; blocks com os mesmos formatos, até 12; showInNav coloca no menu, no máximo 3; showInFooter coloca um link no rodapé, sem limite além das 10 páginas) e rótulo e título das seções da home (sectionHeadings.<press|trajectory|currentWork|competencies|appearances|companyCoverage|faq|evidence|contact> com eyebrow até 60 e heading até 120; vazio volta ao texto padrão). Os textos dos blocos e das páginas aceitam os marcadores {{nome}}, {{cargo}}, {{fontes}}, {{veiculos}}, {{desde}}, {{marcos}}, {{revisado_em}} e {{site}}, trocados pelo valor atual a cada publicação; marcador fora da lista é recusado. A posição do bloco próprio na home é custom:<id> em autopilot_authority_site_set_layout; nas páginas próprias vale a ordem de blocks. As versões salvas com conteúdo podem ser restauradas por autopilot_authority_site_restore_revision; o histórico mantém até 50 versões. A edição permanece salva se o registro do histórico falhar, mas essa versão pode não estar disponível para restauração. NÃO publica na hora: o site no ar muda na próxima publicação, a sua por autopilot_authority_site_publish ou a atualização automática, que republica sozinha quando uma matéria entra ou sai e leva junto o texto salvo. Envie o objeto de conteúdo inteiro, como veio de autopilot_authority_site_get, com as suas alterações aplicadas. Enviar o objeto inteiro não muda automaticamente a origem dos textos. Para preservar os textos editados na geração, marque origin como user em manifesto, howToCite e nos itens de milestones, currentWork, competencies e faq; na apresentação, marque hero.origin.<intro|kickers|thesis|summary> como user para os campos editados. Alterações em FAQ, competências e trabalho atual também registram curadoria para a atualização automática; Regenerar pode refazer itens ainda marcados como generated. Marco de trajetória sem matéria confirmada não vai ao ar, mesmo que você o escreva. Não cobra créditos. Ao escrever, abra cada seção com UMA frase que responde ao próprio título, deixe cada texto autocontido e mantenha títulos entre 3 e 100 caracteres (alguns em forma de pergunta, quando natural), porque assistentes de IA citam trechos isolados. Número com unidade só quando a pessoa ou a fonte trouxe o dado. Fluxo: autopilot_authority_site_get para ler contentVersion e estado, depois a escrita, depois autopilot_authority_site_publish, e autopilot_authority_site_get de novo para acompanhar o build.

autopilot_authority_site_update_content

Envia uma imagem para a biblioteca do site de autoridade, por endereço https público (imageUrl) ou pelo próprio arquivo em base64 (imageBase64 com mimeType), e devolve o endereço final em cdn.naia.today com largura e altura. É a única origem de imagem aceita pelo CSS personalizado do site. A imagem é reprocessada para WebP. Limite de 60 imagens por site, 8 MB por endereço e 4 MB decodificados em base64. Endereço que redireciona é recusado: use o endereço final. Recusa por tamanho ou formato devolve code FILE_TOO_LARGE ou UNSUPPORTED_TYPE e howToFix com os comandos de conversão. Antes de enviar, comprima: WebP ou JPEG, lado maior até 2400 px (logo até 1200 px, fundo transparente em PNG ou WebP), idealmente abaixo de 1 MB, teto 4 MB. Prefira imageUrl quando o arquivo já estiver público. Logo no cabeçalho (sem logo, o cabeçalho mostra só a navegação): envie com purpose logo e setAsHeaderLogo true, de preferência PNG ou WebP horizontal com fundo transparente (ideal 800 x 200 px); a margem vazia em volta é cortada sozinha e o site passa a mostrar o logo depois de autopilot_authority_site_publish. Não cobra créditos.

autopilot_authority_site_upload_asset

Corrige os dados de uma pessoa da área de Autoridade (inclusive descoberta pela naia) ou muda o status dela. O caso mais comum é o nome: a descoberta traz o nome civil completo ("Maria Aparecida Mestriner Colli") e a imprensa cita a pessoa por outro ("Maria Colli"), e é o nome gravado que alimenta as buscas da varredura profunda, então vale corrigir ANTES de gastar os 20 créditos. Nome corrigido não é desfeito pela próxima atualização da descoberta. Também envia a foto da pessoa, por photoUrl (endereço https público, sem redirecionamento) ou photoBase64 com photoMimeType (PNG, JPEG ou WebP, até 4 MB decodificados), pelo mesmo caminho do painel: a foto vai para o CDN, o retrato do hero feito da foto anterior é invalidado e o site no ar só muda depois de publicar. Recusa por tamanho ou formato devolve code FILE_TOO_LARGE ou UNSUPPORTED_TYPE e howToFix com os comandos de conversão. Antes de enviar, comprima: WebP ou JPEG, lado maior até 2400 px (logo até 1200 px, fundo transparente em PNG ou WebP), idealmente abaixo de 1 MB, teto 4 MB. Prefira photoUrl quando o arquivo já estiver público. Para remover a foto, use autopilot_authority_identity_decide com target=photo. Não cobra créditos. Recusa alteração de nome, dados ou status enquanto existe varredura em andamento para a pessoa.

autopilot_authority_update_person

Monta o pacote QuickStatements de UMA pessoa da Autoridade: as declarações que as matérias já verificadas sustentam, o TSV pronto para colar, o que ficou de fora e por quê, e as fontes de apoio. GRATUITA e sem chamada externa nova: tudo sai do que a varredura profunda já verificou. Use quando o usuário quiser criar ou completar o item da pessoa no Wikidata, ou quiser mandar essa tarefa para o desenvolvedor ou a agência. deliver=return devolve o pacote e, por padrão, o conteúdo do arquivo .tsv na resposta. deliver=email envia o pacote com o .tsv em anexo para recipientEmail ou para uma rota de email salva (recipientMemoryId); o corpo do email é montado inteiro no servidor, nenhum texto do cliente entra nele. A NAIA NUNCA PUBLICA NO WIKIDATA: o arquivo é para colagem humana, em conta identificada e com o vínculo com a marca declarado no resumo da edição, e o aviso de conflito de interesse não é editável. blockedTokens lista placeholders que impediram alguma linha; quando não está vazio, o TSV executável está garantidamente livre deles, porque a linha saiu do arquivo e virou pendência nomeada. Propriedade sem fonte verificada não vira declaração.

autopilot_authority_wikidata_package

Confere a identidade da marca e das pessoas dela no Wikidata, e lê o JSON-LD do site do cliente para saber quais dessas identidades ele já declara em sameAs. GRATUITA: só a API pública da Wikimedia e um fetch do site, sem modelo de linguagem e sem provedor pago. Use quando o usuário perguntar se a empresa ou uma pessoa tem item no Wikidata, se o site declara o Q-id, ou antes de montar o pacote de submissão. mode=full consulta a Wikimedia e relê o site; mode=site_only só relê o site (é o "já publiquei o sameAs, confere de novo"), não toca na Wikimedia e tem teto próprio. LEIA O RETORNO COM CUIDADO: cada pessoa sai com um desfecho de CINCO valores, e dois deles dizem que a leitura NÃO aconteceu. has_item (achamos o item), needs_confirmation (achamos candidato plausível, falta decisão humana), not_found (procuramos e não existe), rate_limited (a cota da Wikimedia bloqueou, por IP e compartilhada entre todas as contas) e error (a coleta falhou). rate_limited e error NUNCA podem ser relatados como "não tem item": o bloco readingIntegrity nomeia quem ficou sem leitura e a frase que você deve usar. O mesmo vale para o site: checked=false quer dizer que não conseguimos ler a página, não que o sameAs está faltando. A empresa só é confirmada por P856 batendo o domínio da marca; homônimo descartado aparece nomeado em rejectedHomonyms. A naia nunca publica no Wikidata.

autopilot_authority_wikidata_scan

Cria ou atualiza um agente (automação por prompt) da marca: uma instrução salva que a naia executa na agenda escolhida, inclusive por um período (startsAt e endsAt; no fim o agente pausa sozinho). As execuções podem pesquisar na web, usar ferramentas autorizadas e enviar e-mails. Use dryRun=true primeiro e mostre ao usuário a prévia: agenda, próximas execuções, orçamento, para quem vai o e-mail de conclusão (ligado por padrão; notifyByEmail=false desliga) e vagas de agente ativo. Agente parecido já existente volta DUPLICATE_AGENT; crie mesmo assim só com allowDuplicate=true depois de o usuário confirmar. Uma origem existente pode ser reutilizada e ter nome, agenda e ativação substituídos; confira operation na resposta. Criar não cobra créditos; cada execução cobra o que usar, até o orçamento. Apresente o openUrl devolvido.

autopilot_automation_create

Apaga um agente (automação por prompt) e o histórico de execuções dele. Sem confirmed devolve a prévia (nome, agenda, total de execuções) e não apaga nada; mostre ao usuário e só então repita com confirmed=true. Para só parar o agente, use autopilot_automation_update com isActive=false.

autopilot_automation_delete

Lista os agentes (automações por prompt) da marca com agenda, período, estado, orçamento, e-mail, última execução e total de execuções reais, e o openUrl de cada um. automationId lê um agente só; includeRuns traz as últimas execuções resumidas (runsLimit, padrão 5, máximo 20). Leia o campo agents: automations é alias depreciado e sai na próxima versão.

autopilot_automation_list

Executa agora um agente (automação por prompt). Opcionalmente aplica um patch (save) antes de executar. A execução cobra créditos conforme a config do agente; acompanhe com autopilot_automation_list.

autopilot_automation_run_now

Edita um agente (automação por prompt): name, description, prompt (gera nova versão), changeNote, schedule (inclusive startsAt e endsAt), config, notifyByEmail e isActive (pausar ou retomar). Envie somente os campos que mudam; os valores enviados substituem os anteriores. A agenda e a ativação controlam execuções futuras que podem pesquisar na web, usar ferramentas autorizadas e enviar e-mails. Reativar agente com período vencido exige um endsAt novo.

autopilot_automation_update

Cria um monitor de Brand Safety com as mesmas exigências do dashboard. Fluxo em DUAS etapas: a primeira chamada (sem confirmed) devolve requiresConfirmation com a proposta completa e o custo por execução; mostre ao usuário e, com o aceite dele, repita EXATAMENTE a mesma chamada com confirmed=true. Modo compliance exige expectedResponse (a resposta correta contra a qual o índice de segurança 0 a 100 é medido; parada automática opcional no corte, padrão 80). Modo reputation não tem resposta esperada (mede sentimento, temas e alegações de risco). A criação em si não cobra; cada execução debita o custo estimado (runNow dispara a primeira agora).

autopilot_brand_safety_create

Lista os monitores de Brand Safety da marca (mesma área Monitoramento do dashboard): modo (compliance ou reputation), prompt, motores, última execução, índice de segurança médio (0 a 100, corte 80), sentimento médio, taxa de menção e estado da parada automática.

autopilot_brand_safety_list

Sugere dinamicamente monitores de Brand Safety para a marca a partir dos dados reais da conta (concorrentes curados da última análise e riscos/falhas possíveis da empresa). Cada sugestão sai pronta para autopilot_brand_safety_create: label, promptText, modo e, quando fizer sentido, resposta esperada. Nada é criado por esta tool; mostre as sugestões para o usuário selecionar.

autopilot_brand_safety_suggest

Gera e salva conteúdo na biblioteca da naia quando o usuário solicita esse fluxo com o contexto autorizado da marca. Aplica voz da marca, memórias, SuperMemória, prompts monitorados e pesquisa com fonte. Não usar para pedidos genéricos de redação sem intenção de gerar na naia. VÍDEO: pedido de vídeo, roteiro, pauta de gravação ou pacote de YouTube vem para esta tool com channelId=youtube, que entrega título, descrição, tags e roteiro falado; a naia não renderiza o arquivo de vídeo, a pessoa grava depois. Gera conteúdo NATIVO para um canal social/GEO (Instagram, LinkedIn, X, Reddit, YouTube, Facebook, Wikipedia, Wikidata, Reclame Aqui etc.), seguindo o formato e as normas de voz de cada rede (10 créditos por peça, cobrados do dono da marca; mais 5 quando pedir imagem). Use para conteúdo de uma rede específica quando o usuário solicitar geração na naia; autopilot_generate_content atende conteúdo tradicional de blog/site. QUATRO MODOS, escolhidos pelo campo mode: parent adapta um conteúdo concluído da marca (default); topic escreve para capturar uma consulta monitorada; free escreve sobre o assunto que o usuário deu; trend pesquisa na web o que está em alta no setor e escreve em cima disso. Em topic e free a pesquisa de assunto com fonte nomeada roda sozinha antes da escrita. Em trend, quando nenhuma publicação recente é encontrada, o pedido é recusado sem cobrar, em vez de escrever sobre tendência não verificada. liveResearch desliga a leitura viva da comunidade (hoje só o Reddit). imageRequest pede arte com direção opcional e entra no pacote da peça; sem ele nenhuma imagem é gerada. Se o usuário disser sobre o que o material deve falar, passe isso em note. A peça fica em geração assíncrona: acompanhe com autopilot_get_content. A publicação social acontece com autopilot_social, que publica ou agenda pela MESMA integração configurada no painel (contas conectadas e confirmação de duas etapas com token); no LinkedIn o artigo segue assistido no painel.

autopilot_channel_adapt

Atualiza configurações do Pages: ativa CNAME recomendado, domínio próprio, proxy, cadência de publicação, links superiores e CTA padrão dos posts, e liga o Google Search Console e o Google Analytics da Page (searchPresence). Aceita pageId ou businessId. Para ativar domínio próprio automaticamente, use activateRecommendedCname=true; o MCP sugerirá insights.<domínio> por padrão ou conteudo.<domínio> se preferredSubdomain=conteudo. Nunca use ia.<domínio> ou ai.<domínio>. Ao salvar customDomain com integrationType cname, a resposta traz dois registros CNAME obrigatórios (cnameRecord e, quando disponível, certValidationRecord): o primeiro aponta o site e o segundo autoriza a emissão do certificado SSL. Trocar integrationType ou customDomain reseta verificação de DNS e pode desprovisionar certificado: avise o usuário. searchPresence aplica uma ação por chamada, antes das demais configurações, e só com a Page ativa: add_token (token: o código da Tag HTML do Search Console, ou a tag inteira; até 3), remove_token (token exato de searchPresence.gsc.tokens em autopilot_get_artifact_config), confirm_manual (a pessoa já clicou em Verificar no Google), set_analytics (measurementId: ID de medição do GA4, começa com G-; UA-, GTM- e AW- são recusados), clear_analytics, skip e reopen (step: gsc ou analytics). A Page não tem build: código e Analytics vão ao ar na hora (renderChanged=true) e o cache público é renovado; o Analytics entra com a faixa de consentimento de cookies no idioma da marca. Em erro de searchPresence (SEARCH_PRESENCE_INVALID_TOKEN, SEARCH_PRESENCE_TOO_MANY_TOKENS, SEARCH_PRESENCE_UNKNOWN_TOKEN, SEARCH_PRESENCE_WRONG_PRODUCT, SEARCH_PRESENCE_INVALID_MEASUREMENT_ID, SEARCH_PRESENCE_SITE_NOT_LIVE, SEARCH_PRESENCE_SAVE_FAILED) nada da chamada foi salvo. Não consome créditos.

autopilot_configure_artifact

Gera ou refaz a capa (imagem) de conteúdos da marca, inclusive de posts já publicados no naia Pages, e atualiza o post publicado na mesma URL. Três passos: (1) sem contentIds, devolve a lista numerada dos posts publicados no Pages com título, se já têm capa e o formato atual (gratuito); mostre ao usuário e pergunte quais atualizar (números, todos ou nenhum). (2) Com contentIds e sem confirmed, devolve a prévia com títulos e custo (2 créditos por capa). (3) Com confirmed=true depois do aceite, gera em segundo plano em paisagem 16:9 por padrão; cada capa é cobrada ao começar e estornada se não sair. Acompanhe com batchId até finished=true e mostre cada capa pela previewUrl.

autopilot_content_covers

Cria o Pages (site de conteúdo naia Pages) da marca, já ativo: 10 créditos, cobrados só quando a criação conclui (falha não cobra). Avise o custo antes. Retorna id, slug, nextSteps e dashboardUrl; a criação continua em background. Depois, salve o subdomínio com autopilot_configure_artifact e acompanhe o domínio com autopilot_get_artifact_config. Criação que falhou: chame de novo com retryFailed=true (gratuito).

autopilot_create_artifact

Gera plano de execução GEO a partir do relatório Autopilot concluído. Custa 10 créditos, o mesmo do plano sem pesquisa web e sem PDF no painel e no chat, e retorna planId para polling.

autopilot_create_execution_plan