Pular para o conteúdo principal

Casos de Uso

A superfície da Copera é intencionalmente genérica — boards para dados estruturados, docs para prosa, drive para arquivos, channels para mensagens. A skill da CLI ensina ao agente os comandos; o que fazer com eles é com você. Esta página reúne os padrões que vemos com mais frequência. Nenhum deles é uma funcionalidade embutida — cada um é um workflow que você descreve ao agente e (para os recorrentes) captura como uma skill de workflow para que qualquer sessão futura o rode de forma idêntica.


Boards: rastreie o trabalho onde seu time já vive

Triar tarefas que chegam

Você joga ali um link do Sentry, um e-mail de cliente ou um trecho colado do Slack. O agente o registra como uma linha no seu board rastreador com a severidade inferida, status definido como Triage e (para alta severidade) uma notificação postada no seu channel de alertas.

O que o agente faz

  • Lê o schema da sua tabela rastreadora uma vez (em cache).
  • Mapeia seu input em texto livre → os valores de coluna corretos.
  • Cria a linha e (condicionalmente) posta uma notificação.

Construa isto com uma skill de workflow como triage-bug ou triage-task. A entrevista do agente captura qual board + tabela você usa, quais opções de severidade existem e o channel de notificação do seu time.

Pipeline de engenharia de vendas

Um board com uma linha por solicitação técnica de entrada: qual cliente, qual área de produto, o que está bloqueando o negócio, quem é responsável pela resposta. O agente registra novas solicitações conforme você as descreve, atualiza responsabilidade/status conforme você avança e revela linhas paradas na sua revisão semanal.

O que o agente faz

  • Nova solicitação → rows create com a coluna LINK de cliente resolvida (busca a linha do cliente por nome).
  • Mudança de status → rows update para a coluna relevante.
  • Revisão semanal → rows list filtrado por linhas paradas, resumido em um post de channel ou doc gerado.

Dica: capture isto como duas skills de workflow separadas (sales-eng-intake e sales-eng-review) para que o resumo semanal recorrente não carregue o overhead de schema da entrada.

Onboarding de clientes

Quando um negócio fecha, o agente cria a linha de CRM do cliente, vincula contatos, gera um doc de kickoff a partir de um template, deixa-o sob o pai correto e posta uma mensagem de "kickoff agendado" no seu channel de sucesso do cliente.

O que o agente faz

  • rows create no CRM com colunas LINK para linhas de contato.
  • docs create sob o doc pai de onboarding de cliente, conteúdo a partir de um template.
  • channels message send com a URL do doc.

Relatório de status

Fim de semana: o agente consulta linhas no seu rastreador de engenharia que foram atualizadas nesta semana, agrupa por responsável ou por status e posta um resumo no channel do seu time. Ou gera um doc que fica em /Engineering/Weekly/.

O que o agente faz

  • rows list (paginado se necessário).
  • Agrupa + resume em texto puro.
  • channels message send ou docs create.

Docs: a Copera como base de conhecimento do seu agente

A Copera Docs é uma árvore markdown de todo o workspace. Isso a torna um ajuste natural para agentes de IA — prosa durável, pesquisável e versionada que qualquer agente pode ler para contexto.

Ler para contexto (recuperação de conhecimento)

Você pergunta: "Qual é nossa política de exclusão de dados de cliente?" O agente busca na árvore de docs, lê o(s) doc(s) correspondente(s) e responde a partir da prosa — citando a URL do doc para que você possa verificar.

O que o agente faz

  • docs search "customer data deletion" → encontra docs correspondentes.
  • docs content <doc-id> para o melhor hit (em cache) → lê o markdown.
  • Responde a partir do doc, citando a fonte.

Por que isso funciona: o cache de docs significa que perguntas de acompanhamento sobre o mesmo tema não buscam de novo. E como a prosa é sua, o agente para de adivinhar a partir de dados de treinamento.

Resumos semanais de reuniões

Você mantém notas de reunião em /Engineering/Meetings/ (ou onde for). O agente lê os docs de reunião da semana passada, extrai decisões e itens de ação e posta o resumo de volta como um novo doc em /Engineering/Weekly-Summaries/ com links para as reuniões de origem.

O que o agente faz

  • docs tree --parent <meetings-folder> → lista docs de reunião recentes.
  • docs content <doc-id> para cada um (leituras concorrentes se forem muitas).
  • Sintetiza resumo + itens de ação.
  • docs create --title "Week of …" sob a pasta de resumos.
  • Opcionalmente channels message send com a URL do resumo.

Criar e compartilhar novos docs a partir de uma conversa

No meio de uma call, você diz ao agente: "Documente este incidente — o que atingimos, a solução de contorno, o responsável." O agente redige o markdown a partir da sua conversa, cria o doc em /Engineering/Incidents/, posta o link no seu channel de incidentes e (se você tiver configurado) adiciona uma linha ao seu board de rastreamento de incidentes.

O que o agente faz

  • docs create --title "Incident: …" --content "<markdown>" sob a pasta de incidentes.
  • channels message send com o link.
  • (Opcional) rows create no board de incidentes com a URL do doc como uma coluna.

Revisão de doc e sugestões de edição

Você aponta o agente para um rascunho de doc. Ele lê o conteúdo, sugere edições inline (na sua conversa) e, com sua aprovação, as aplica com docs update.

O que o agente faz

  • docs content <doc-id> para ler.
  • Propõe mudanças na conversa.
  • Com aprovação, docs update <doc-id> --content "<edited markdown>" (replace), ou docs update <doc-id> --operation append para adicionar ao final.
dica

Docs como contexto do agente: se uma skill de workflow precisa de contexto de fundo (a terminologia do seu time, seu guia de estilo, as convenções do seu runbook), referencie os IDs de doc relevantes na prosa da skill e instrua o agente a lê-los no início do procedimento. O cache de docs torna isso barato em execuções subsequentes.


Drive: workflows de arquivos

Organize uploads por convenção

Você joga arquivos em uma conversa. O agente os envia ao drive sob uma estrutura de pastas que combina com a convenção do seu time (ex.: /<year>/<quarter>/<customer>/), criando pastas conforme necessário.

O que o agente faz

  • drive tree --parent <root> para encontrar a estrutura existente.
  • drive mkdir para qualquer pasta faltante.
  • drive upload <file> --parent <resolved-folderId>.

Distribua relatórios

O agente gera um relatório (markdown ou saída renderizada), envia-o para uma pasta compartilhada do drive e posta o link no(s) channel(s) relevante(s) — substituindo o típico loop de "tirar print do dashboard, colar no Slack".

O que o agente faz

  • Gera o relatório localmente (ou como um doc + export).
  • drive upload report.pdf --parent <reports-folderId>.
  • channels message send com a URL do arquivo da resposta de upload.

Workflows entre superfícies

As skills de workflow mais úteis abrangem múltiplas superfícies da Copera.

Resumo diário de standup

O agente consulta: linhas no board do sprint atualizadas desde ontem, atividade recente de docs na pasta de docs do time, uploads no drive em assets compartilhados. Sintetiza em um resumo de uma mensagem postado no channel de standup antes da reunião.

Resumo de ponto de contato com o cliente

Para um dado cliente (resolvido para sua linha de CRM + linhas vinculadas): puxa todos os tickets abertos dele, notas de reunião recentes e quaisquer assets do drive anexados a ele. Gera um briefing markdown de uma página que o agente pode compartilhar antes de uma call com o cliente.

Retrospectiva de incidente

Quando você fecha um incidente: o agente lê a linha do incidente no board de incidentes, o doc do incidente e quaisquer linhas relacionadas vinculadas a partir do doc. Gera um doc de retrospectiva em /Engineering/Retros/ e o vincula de volta à descrição da linha do incidente.


O que vai em uma skill de workflow vs ad-hoc

Nem todo caso de uso precisa virar uma skill de workflow. Regra geral:

  • Ad-hoc — descoberta pontual, leituras ocasionais, explorar um board desconhecido. Apenas converse com o agente; a skill da CLI dá conta.
  • Skill de workflow — qualquer coisa que você faz mais de duas vezes com o mesmo formato. Construa uma vez, rode de forma idêntica toda vez, compartilhe com seu time. Veja Skills de Workflow.