Markdown para agentes

Visão geral

O Markdown para agentes cria versões em markdown compatíveis com IA do conteúdo publicado. Foi pensado para equipas que querem uma saída em markdown mais limpa para rastreadores de IA, fluxos de agentes ou exportações de conhecimento.

Caminho no painel de administração: Airygen SEO -> Definições -> Markdown para agentes

O módulo permite-lhe controlar a saída em markdown, escolher quais os tipos de conteúdo incluídos, reconstruir snapshots, pré-visualizar exportações por ID de artigo e adicionar prompts por artigo para agentes no editor.

Configurações

A página está dividida em Definições, Snapshots e Pré-visualização.

Separador Definições

• A opção Ativar saída de markdown ativa ou desativa a exportação em markdown.
• A opção Prompts para agentes ativa um painel no editor onde pode adicionar descrições, instruções ou prompts para agentes LLM.
• A opção Incluir front matter YAML adiciona metadados como título, autor, data de publicação, URL canónico e frase-chave no topo do markdown.
• O campo Tipos de artigo a incluir define quais os tipos de conteúdo exportados para markdown.

Separador Snapshots

• A ação Reconstruir regenera snapshots de markdown em segundo plano.
• O campo Filtro de tipo de conteúdo limita a tabela de snapshots ao tipo de conteúdo selecionado dentro do âmbito.
• A tabela de snapshots mostra ID do Artigo, Título, Tipo de conteúdo e Última sincronização.
• A ação Ver abre a versão em markdown desse artigo.
• Os controlos de paginação permitem avançar entre páginas de snapshots.

Separador Pré-visualização

• O campo ID do Artigo permite carregar uma pré-visualização em markdown para um artigo publicado específico.
• A ação Pré-visualização executa o pedido de pré-visualização com base nas definições atuais do módulo.
• A área Saída mostra o markdown gerado numa caixa de texto apenas de leitura.

Painel do editor

Quando Prompts para agentes está ativado, o editor mostra uma área de texto Prompts para agentes em cada artigo.

• Use-a para adicionar descrições, instruções ou prompts ao nível da página para agentes LLM.
• O painel é útil quando uma página precisa de contexto adicional para além do conteúdo normal.

Como usar

1. Abra Airygen SEO -> Definições -> Markdown para agentes.
2. Ative Ativar saída de markdown.
3. Decida se Prompts para agentes deve ficar disponível no editor.
4. Decida se quer ativar Incluir front matter YAML.
5. Em Tipos de artigo a incluir, escolha quais os tipos de conteúdo que devem ter exportações em markdown.
6. Abra o separador Snapshots e clique em Reconstruir se quiser regenerar imediatamente o conteúdo já existente.
7. Use Filtro de tipo de conteúdo e a tabela de snapshots para rever o que já foi gerado.
8. Abra o separador Pré-visualização, introduza um ID do Artigo publicado e clique em Pré-visualização para inspecionar a saída exata em markdown.
9. Se tiver ativado Prompts para agentes, abra um artigo no editor e adicione instruções específicas da página para agentes no painel Prompts para agentes.
10. Abra um snapshot com Ver ou acrescente ?format=md ao URL de um artigo suportado para confirmar a saída pública em markdown.

Verifique estes pontos depois de guardar:

• A saída em markdown está ativada apenas para os tipos de conteúdo que quer expor.
• O front matter aparece apenas quando Incluir front matter YAML está ativado.
• Os snapshots mostram tempos de sincronização recentes após uma reconstrução.
• A saída em markdown inclui qualquer conteúdo de prompt para agentes que tenha adicionado intencionalmente.

Benefícios de SEO

Este módulo não altera diretamente as classificações, mas fornece uma versão do conteúdo mais limpa e legível por máquina. Isso pode tornar os fluxos orientados para IA e baseados em markdown mais consistentes e mais fáceis de manter.

Casos de uso

Equipas que publicam conteúdo de conhecimento legível por IA

Antes: Uma empresa quer que a sua documentação seja mais fácil de consumir por ferramentas de IA, mas a saída HTML normal inclui estrutura de página extra que não é ideal para fluxos baseados em markdown.

Depois: O Markdown para agentes fornece uma versão em markdown mais limpa, mais fácil de pré-visualizar, exportar e reutilizar.

Agências que adicionam instruções por página para uso de IA

Antes: Algumas páginas precisam de contexto adicional para agentes de IA, mas não existe um local estruturado para guardar essa orientação.

Depois: O painel do editor Prompts para agentes permite à agência adicionar instruções específicas da página sem reescrever o artigo visível.

Perguntas frequentes

Isto altera a página HTML normal que os visitantes veem?

Não. O módulo adiciona uma saída em markdown para fluxos compatíveis, mas não substitui a visualização normal da página.

O que adiciona Incluir front matter YAML?

Adiciona metadados no topo do ficheiro, como título, autor, data de publicação, URL canónico e informação de frase-chave.

Posso pré-visualizar um artigo antes de ativar isto para tudo?

Sim. Use o separador Pré-visualização, introduza um ID do Artigo publicado e inspeccione o markdown gerado antes de expandir este fluxo.