Logo

Assistente de IA

O assistente conversa em linguagem natural sobre suas métricas: explica números, compara times, encontra PRs parados e gera relatórios. As respostas são sempre baseadas nos seus dados (nunca inventadas): ele consulta as mesmas métricas das telas.

Ele também ajuda com como usar a plataforma: onde encontrar uma tela ou métrica, como conectar e sincronizar integrações, criar times, metas e alertas, etc. Nessas respostas ele inclui links que levam direto à tela certa.

O assistente enxerga exatamente o que você enxerga: a visibilidade por equipe e as permissões do seu papel valem também para as respostas da IA. Se a sua visão está restrita a uma equipe, ele responde apenas com os dados dela; recursos que o seu plano ou papel não incluem ficam fora do alcance dele.

O que ele pode FAZER (ações com confirmação)#

Além de responder, o assistente executa ações quando você pede: criar/renomear/excluir times, adicionar ou remover pessoas de um time, criar/editar/remover metas, criar/pausar/reativar/remover alertas, re-sincronizar um repositório, convidar membros, ajustar alias e custo-hora de contribuidores e gerar o link do relatório semanal em PDF.

Duas regras valem sempre:

  • Nada executa sem a sua confirmação: a IA prepara a ação e mostra um cartão com o resumo do que será feito; só o clique em Confirmar executa. Ações destrutivas aparecem destacadas.
  • As suas permissões valem para a IA: ela só propõe o que o seu papel permite, e toda ação executada entra na trilha de auditoria em seu nome (não existe "a IA fez": você fez, via IA).

Por segurança, o assistente nunca aceita segredos (URLs de webhook, tokens) no chat: configure canais sensíveis pela tela de Alertas.

O que ele faz#

Dois grandes tipos de ajuda:

  • Perguntas sobre dados: responde com base nas suas métricas reais (cycle time, DORA, throughput, rework, PRs parados, uso de IA, insights de planejamento etc.). Ele não inventa números: o que não está nos dados, ele não afirma.
  • Como usar a plataforma: explica onde fica cada coisa e como fazer (conectar integrações, criar times, definir metas/alertas), com links que abrem a tela certa.

Como usar#

  1. Clique no robô no canto inferior direito (disponível em qualquer tela).
  2. Pergunte em português ou inglês.
  3. A resposta é digitada ao vivo. Você pode copiar o texto, baixar como .md, e dar 👍 / 👎 para nos ajudar a melhorar.

Exemplos de perguntas#

Sobre métricas#

  • "Como está o cycle time nos últimos 30 dias?"
  • "Qual estágio está segurando o nosso cycle time?"
  • "Compare os times por throughput."
  • "Quais PRs abertos estão parados há mais tempo?"
  • "Gere um relatório DORA do mês."
  • "Como está a nossa adoção de IA e o custo?"

Sobre planejamento (com Jira / Azure Boards)#

  • "Qual a cobertura de tickets?" / "Quais PRs estão sem ticket?"
  • "Como está o backlog por prioridade? Há SLAs estourados?"
  • "Qual a velocity em pontos?" / "Como vão os épicos?"

Veja mais em Insights do Jira.

Sobre como usar a plataforma (how-to)#

  • "Onde vejo o DORA?"
  • "Como crio um time?"
  • "Como conecto o GitHub?"
  • "Como configuro um alerta de quota de IA?"

Nessas respostas, o assistente costuma incluir um link que leva direto à tela certa.

Janelas de tempo#

Use janelas relativas naturais: "últimos 7 dias", "últimos 3 meses". O assistente entende essas expressões. Para PRs recentes, peça explicitamente (ex.: "PRs abertos dos últimos 3 dias") e ele filtra pela data de criação.

Contexto da tela (filtros)#

O assistente usa os filtros globais atuais (período, repositório e time) como padrão quando você não especifica. Assim, "como está o throughput?" considera o que está selecionado na tela. Se quiser sair desse padrão, basta dizer na pergunta (ex.: "...no time Backend, nos últimos 90 dias").

Recursos da resposta#

  • Copiar: copia o texto da resposta.
  • Baixar .md: salva a resposta como arquivo Markdown (útil para colar em um relatório).
  • Feedback 👍 / 👎: ajuda a melhorar a qualidade das respostas.

Boas práticas de perguntas#

  • Seja específico sobre tempo, time e repositório quando importar, ou confie nos filtros da tela.
  • Uma pergunta por vez rende respostas mais precisas do que várias perguntas juntas.
  • Para relatórios, peça o recorte desejado (ex.: "relatório DORA do último mês para o time Plataforma") e use o baixar .md.
  • Lembre que ele responde sobre dados existentes: se uma integração não está conectada ou não há dados, ele dirá, em vez de inventar.

Disponibilidade e limites#

  • O assistente requer uma chave de IA configurada no servidor (GEMINI_API_KEY). Sem ela, o widget informa que está indisponível, sem afetar o resto da plataforma.
  • Há uma cota mensal de tokens por plano. O uso do assistente consome essa cota; ao se aproximar do limite, considere fazer perguntas mais objetivas.

Próximos passos#

AnteriorGlossário de métricasPróximoCota de tokens de IA