Relatórios governados com Amazon Quick Desktop e Amazon FSx for NetApp ONTAP

O problema que essa solução resolve

Preparar relatórios semanais de negócio ainda é uma tarefa manual e repetitiva na maioria das empresas. Times releem os mesmos documentos, reformatam métricas, copiam resumos para o Slack e, ao final, líderes precisam confiar que cada número e recomendação vem de uma fonte confiável. A AWS apresentou uma abordagem que conecta o Amazon Quick Desktop ao Amazon FSx for NetApp ONTAP para automatizar esse ciclo sem abrir mão da governança sobre os arquivos.

A proposta é direta: os documentos permanecem no sistema de armazenamento gerenciado que a equipe já utiliza, o acesso é controlado por permissões existentes, e o assistente de IA só enxerga o conteúdo que foi explicitamente aprovado para o fluxo de relatórios.

Visão geral da arquitetura

O fluxo de trabalho é composto por cinco elementos principais: o Amazon Quick Desktop, uma skill (habilidade personalizada) chamada Weekly Business Reporting Assistant, o Amazon FSx for NetApp ONTAP armazenando os documentos-fonte, um ponto de acesso do Serviço de Armazenamento Simples da Amazon (Amazon S3) controlando o acesso à pasta aprovada, e a integração com o Slack para distribuição revisada dos resumos.

Os arquivos de negócio ficam no FSx for ONTAP — revisões semanais, planos operacionais, resumos de forecast, registros de riscos e templates executivos. O ponto de acesso S3 expõe apenas a pasta aprovada para o Amazon Quick, que indexa esse conteúdo em uma base de conhecimento chamada Business Reporting Archive. A partir daí, usuários trabalham no Quick Desktop com a skill de relatórios para gerar artefatos citados e resumos para o Slack — todos sujeitos a revisão humana antes de serem compartilhados.

O Amazon Quick Desktop também constrói um grafo de conhecimento pessoal na visão “My context”, conectando pessoas, projetos, eventos, itens de ação e documentos de fontes conectadas. A Business Reporting Archive permanece como fonte governada para fatos e citações dos relatórios.

Pré-requisitos

Para implementar esse fluxo, a AWS lista os seguintes requisitos de infraestrutura e acesso:

Conta AWS com acesso a uma região onde Amazon Quick, FSx for ONTAP e pontos de acesso S3 para FSx for ONTAP sejam suportados.
Assinatura Amazon Quick Enterprise com permissões para criar integrações S3, bases de conhecimento e espaços.
Aplicação Amazon Quick Desktop instalada para os usuários do fluxo de relatórios.
Sistema de arquivos FSx for ONTAP rodando NetApp ONTAP 9.17.1 ou superior, com volume montado e junction path configurado (por exemplo, /business-reporting).
Ponto de acesso S3 vinculado ao volume FSx for ONTAP, na mesma região e conta AWS.
Permissões de Gerenciamento de Identidade e Acesso da AWS (IAM) para conceder ao Amazon Quick acesso de leitura com privilégio mínimo.
Workspace do Slack com canal aprovado e permissões para configurar o conector de ação do Slack.

Implementação passo a passo

Passo 1: Preparar o conteúdo-fonte

A recomendação é começar com um escopo de pasta restrito para que os usuários possam verificar as citações contra um conjunto conhecido de arquivos. No volume FSx for ONTAP montado, cria-se ou escolhe-se uma pasta aprovada como /business-reporting, organizada em subpastas:

/business-reporting/
  weekly-reviews/
  operating-plans/
  forecasts/
  risk-registers/
  executive-templates/

Devem ser incluídas as últimas 8 a 12 revisões semanais, o plano operacional atual, o resumo de forecast vigente, o registro de riscos e o template padrão de relatório. Rascunhos, arquivos obsoletos e documentos restritos ficam fora dessa pasta antes da indexação.

Passo 2: Criar o ponto de acesso S3

Um ponto de acesso S3 é vinculado ao volume FSx for ONTAP para que o Amazon Quick possa ler o conteúdo aprovado por um caminho compatível com S3. No console do Amazon FSx, seleciona-se o volume montado, acessa-se a opção “Create S3 access point” e configura-se nome, usuário e configurações de rede conforme o modelo de governança da organização. O alias e o Nome de Recurso da Amazon (ARN) do ponto de acesso devem ser registrados — o alias é usado no URI S3 e o ARN nas políticas IAM.

Passo 3: Conceder acesso de leitura ao Amazon Quick

A política IAM deve conceder apenas as permissões necessárias para listar e ler o prefixo aprovado. A AWS disponibiliza o seguinte modelo como ponto de partida:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "ListApprovedReportingPrefix",
      "Effect": "Allow",
      "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
      "Resource": "<access-point-arn>"
    },
    {
      "Sid": "ReadApprovedReportingObjects",
      "Effect": "Allow",
      "Action": "s3:GetObject",
      "Resource": "<approved-prefix-object-arn>"
    }
  ]
}

Os placeholders devem ser substituídos pelos valores reais da região, ID de conta, nome do ponto de acesso e prefixo aprovado. A política é então vinculada à função de serviço que o Amazon Quick usa para a integração S3, garantindo que o acesso fique restrito ao prefixo de relatórios.

Passo 4: Criar a integração S3 e a base de conhecimento

No console do Amazon Quick, cria-se uma integração S3 apontando para o alias do ponto de acesso (por exemplo, s3:///amzn-s3-demo-business-reporting/). A base de conhecimento recebe o nome “FSx ONTAP Business Reports” e seleciona apenas o prefixo aprovado. Após a sincronização, cria-se um espaço chamado “Business Reporting Archive” e adiciona-se essa base de conhecimento ao espaço. Se os arquivos exigirem permissões por usuário ou grupo, as configurações de Lista de Controle de Acesso (ACL) em nível de documento devem ser definidas antes da criação da base de conhecimento.

Passo 5: Configurar o Slack

A integração com o Slack no Amazon Quick é configurada pelo console, usando os escopos mínimos necessários de OAuth (por exemplo, chat:write restrito ao canal aprovado). O canal aprovado — como #finance-weekly — deve ser documentado junto com a definição de quem pode aprovar mensagens antes do envio. A recomendação é testar com uma mensagem de rascunho em canal não produtivo antes de usar o Slack no fluxo real de relatórios.

Passo 6: Criar a skill de relatórios

Uma skill personalizada é criada no Amazon Quick Desktop para carregar o espaço Business Reporting Archive e aplicar as regras do fluxo de relatórios. A skill é ativada por uma frase de gatilho e fornece um assistente reutilizável. Para mais detalhes sobre criação de skills, a AWS disponibiliza a documentação de criação de skills do Amazon Quick.

A especificação da skill define o gatilho, as dependências, e um fluxo de trabalho em quatro etapas: carregar o contexto do espaço, apresentar uma saudação com exemplos de perguntas, responder perguntas com citações estruturadas, e gerar artefatos como relatórios, apresentações e resumos para o Slack. As regras de segurança da skill determinam que o assistente só pode referenciar conteúdo do arquivo aprovado, nunca fabricar métricas, e sempre citar documento, seção e data.

O fluxo de trabalho completo da skill inclui as seguintes instruções condensadas:

Save this as a skill
Skill: "Weekly Business Reporting Assistant"
Trigger: weekly business reviews, operating plans, financial reports, WBR summaries, trend analysis, business reporting deliverables from the Business Reporting Archive
Depends on: quick_suite__spaces
Workflow:
1. [Deterministic] Load Space Context --- search_spaces("Business Reporting Archive") -> list_space_documents(space_id) to get full document list. On failure: "I couldn't load the Business Reporting Archive. Please check that the space is connected and accessible."
2. [Agentic] Greet and Suggest --- Show greeting with 4 example questions: - Top 5 changes since last week's operating review - Risks repeating across last 4 WBRs - One-page weekly report (highlights, risks, action items, asks, key metrics, decisions needed) - Six-slide PowerPoint deck for leadership from latest review + operating plan
3. [Agentic] Answer Questions --- Use query_topic or search_relevant_content to find relevant content. Respond using structured format: Executive Summary -> Key Highlights -> Risks/Issues -> Action Items/Asks -> Sources (with doc names + dates cited).
4. [Agentic] Generate Deliverables (if requested) --- Reports structured as: business unit, period covered, key metrics/highlights, risks/blockers, mitigation plans, requests/escalations. Response tone: Professional business. Always cite specific document name, section, and date. Safety: Only reference content from the archive. Never fabricate metrics. State gaps clearly.
Lessons Learned:
- Always load space context before greeting
- Always cite doc name + date
- Don't extrapolate metrics not in source docs
- Ask user when period is ambiguous, business unit unclear, or audience/format not specified
- If a metric isn't tracked, name what IS available
Name the skill Weekly Business Reporting Assistant and set a trigger phrase, such as weekly business report.

Passo 7: Usar o Amazon Quick Desktop como ambiente de trabalho

Com a skill criada, o usuário inicia uma conversa no Quick Desktop com a frase de gatilho — por exemplo, “I need help with business reporting”. A skill carrega o espaço Business Reporting Archive e apresenta exemplos de perguntas. A partir daí, o usuário pode solicitar análises de mudanças semana a semana, identificação de riscos recorrentes, criação de relatórios de uma página, geração de apresentações em PowerPoint e rascunhos de resumos para o Slack. Cada resposta inclui citações de documentos específicos com datas, e o envio ao Slack exige aprovação explícita do usuário antes do envio.

Testes recomendados do fluxo

A AWS sugere validar o fluxo completo com prompts que representem o trabalho real de relatórios semanais. A tabela a seguir resume os cenários de teste e o que observar em cada resposta:

Pesquisa: “What are the top five changes since the prior operating review?” — Espera-se um resumo citado com documentos-fonte e datas.
Análise de riscos: “What risks repeat across the last four weekly business reviews?” — Riscos agrupados com citações e sugestão de responsáveis quando disponíveis na fonte.
Criação de relatório: “Create a one-page weekly report with highlights, risks, action items, asks, key metrics, and decisions needed.” — Relatório estruturado com afirmações citadas e lista de fontes.
Criação de apresentação: “Create a six-slide PowerPoint deck for leadership from the latest review and operating plan.” — Deck ou esboço com título, resumo, destaques, riscos, decisões e fontes.
Distribuição no Slack: “Create a six-bullet Slack summary and ask me before posting.” — Mensagem preparada para aprovação antes do envio.

Boas práticas de segurança e governança

A AWS recomenda uma abordagem gradual ao migrar do fluxo de exemplo para um fluxo compartilhado de relatórios. Começar com uma pasta aprovada e expandir somente após os usuários validarem a qualidade das citações. As permissões dos arquivos-fonte devem estar alinhadas com o modelo de governança existente no FSx for ONTAP, e as permissões IAM devem seguir o princípio de privilégio mínimo para a função que o Amazon Quick usa para ler o ponto de acesso S3.

ACLs em nível de documento devem ser usadas na integração S3 quando a base de conhecimento exigir controles de acesso por usuário ou grupo. Um canal dedicado no Slack deve ser usado para resumos de relatórios, com definição clara de quem pode aprovar postagens — especialmente para materiais de conselho, conteúdo regulatório, comunicações com investidores ou relatórios financeiros sensíveis. Os arquivos indexados devem ser revisados periodicamente e conteúdo obsoleto removido da pasta aprovada.

Resolução de problemas comuns

Amazon Quick não consegue ler o caminho-fonte: Verificar o alias do ponto de acesso S3, o requisito de mesma região, o escopo de recursos da política IAM e as permissões da função de serviço do Amazon Quick.
Sincronização da base de conhecimento falha: Confirmar que o prefixo aprovado existe, o ponto de acesso está vinculado a um volume FSx for ONTAP montado e o sistema de arquivos roda NetApp ONTAP 9.17.1 ou superior.
Respostas sem citações: Confirmar que o espaço Business Reporting Archive está conectado no Amazon Quick Desktop e que os arquivos da base de conhecimento sincronizaram com sucesso.
Respostas referenciando arquivos antigos: Verificar o status de sincronização da base de conhecimento e remover arquivos obsoletos da pasta aprovada.
Falha no envio ao Slack: Confirmar autorização do conector Slack, acesso ao canal, escopos necessários e se o conector foi publicado para o usuário ou grupo.

Limpeza de recursos

Para evitar cobranças futuras ou caminhos de acesso desnecessários, a AWS orienta remover apenas os recursos criados ou modificados durante a implementação: excluir a skill Weekly Business Reporting Assistant, deletar a base de conhecimento Business Reporting Archive se criada apenas para esse fluxo, remover a integração S3 do Amazon Quick se nenhuma outra base de conhecimento a utilizar, excluir o ponto de acesso S3 se criado exclusivamente para esse fluxo, remover as declarações de política IAM adicionadas e excluir arquivos de exemplo da pasta aprovada se usados apenas para testes.

Conclusão

Essa solução da AWS entrega um fluxo de relatórios semanais governado, onde artefatos de negócio citados são gerados a partir de arquivos armazenados no Amazon FSx for NetApp ONTAP. O ponto de acesso S3 expõe apenas a pasta aprovada, e o Amazon Quick indexa esse conteúdo pela integração S3. Times de negócio podem pesquisar questões de relatórios, gerar documentos e visuais, e preparar resumos para o Slack em um único ambiente — sem mover os arquivos-fonte para fora do fluxo de armazenamento gerenciado.

Para executivos e partes interessadas, o padrão aumenta a confiança nas atualizações recorrentes. Para quem implementa, mantém o escopo inicial estreito o suficiente para validar governança, acesso e qualidade dos relatórios. A recomendação é começar com uma pasta aprovada, um caso de uso de relatório e um canal de distribuição revisado — e expandir após os usuários confiarem nas citações e na qualidade dos resultados.

Recursos adicionais

Fonte

Governed reports with Amazon Quick Desktop and Amazon FSx for NetApp ONTAP (https://aws.amazon.com/blogs/machine-learning/governed-reports-with-amazon-quick-desktop-and-amazon-fsx-for-netapp-ontap/)