caio-moliveira/agent-harness-prod/relatorios

Relatórios e entregáveis

Quando usar

Use quando o usuário pedir um relatório, documento, apresentação ou planilha — não para uma resposta curta no chat.

Antes de começar: proponha o plano

Se o entregável for grande ou tiver várias etapas (coletar dados de várias tabelas/documentos, várias seções), chame propor_plano(titulo, passos) e aguarde a aprovação antes de executar. Para um entregável simples, siga direto.

Reúna e fundamente os dados

1. Levante os números com as ferramentas certas (run_sql para banco; get_document_structure /

get_node_content / search_documents / read_document para documentos).

1. Para cada dado, guarde a fonte (a tabela + a consulta que o produziu, ou o documento e a

página). Itens sem fonte saem marcados como [SEM FONTE].

Gere o arquivo com a ferramenta certa

OBRIGATÓRIO: assim que os dados estiverem reunidos, **CHAME gerar_artefato (ou

gerar_planilha) NO MESMO TURNO. O entregável é o ARQUIVO** — nunca escreva o corpo do

relatório como mensagem no chat, e **não encerre o turno nem marque o passo de geração como

concluído/em andamento** enquanto a ferramenta não tiver rodado. Depois de coletar os números, sua

próxima ação é chamar a ferramenta de geração — não pare para "concluir" em texto. A mensagem de

chat deve ter no máximo UMA linha avisando que o arquivo foi gerado (ou ficou aguardando aprovação).

• Relatório / apresentação → gerar_artefato(titulo, formato, secoes, ...) com formato

"docx" ou "pptx". Monte secoes com títulos e itens; inclua fonte em cada item.

• Planilha → gerar_planilha(titulo, planilhas); cada aba tem colunas e linhas — inclusive

para exportar resultados de uma consulta SQL.

• NUNCA crie .docx/.pptx/.xlsx com write_file (o arquivo sairia corrompido). write_file

é só para texto (.md, .txt, .csv).

Não espere autorização para CHAMAR a ferramenta. Chame gerar_artefato/gerar_planilha

diretamente assim que tiver os dados — você NÃO precisa de permissão prévia para isso. A

confirmação do usuário acontece automaticamente DEPOIS que você chama a ferramenta (o sistema

deixa o arquivo pendente de aprovação). Se o plano já foi aprovado com propor_plano, essa

aprovação já cobre a geração — prossiga e chame a ferramenta. Nunca redija o relatório em

Markdown/texto no chat "aguardando autorização": isso deixa a tarefa inacabada. Depois de chamar,

avise em uma linha que o arquivo ficou aguardando aprovação.

Qualidade

• Estruture em seções com títulos claros; lidere com o resultado, detalhe depois.
• Toda afirmação relevante deve ter fonte.
• Seja conciso; não invente números que não vieram das ferramentas.