Ferramenta

Relatar um problema

Nome técnico: segnala_problema

Modelo › Ler

Lê

Quando algo no BIMit não funciona, a sua IA relata sozinha ao desenvolvedor, uma vez, sem que você escreva um e-mail.

O que faz

Envia ao desenvolvedor do BIMit um relato de um problema do BIMit. A sua IA a chama sozinha, uma vez por problema, quando:

  • uma ferramenta do BIMit falha de forma inesperada (um resultado claramente errado, o Revit que não responde sem motivo);
  • você diz a ela que algo não funciona.

Um erro interno de uma ferramenta o BIMit já relata sozinho: a sua IA lê isso na mensagem de erro e chama segnala_problema só se tiver passos ou contexto a mais (o relato dela se liga ao automático).

Não serve para os erros que já dizem o que corrigir (um argumento faltando, um nível de acesso baixo demais, um pacote desligado, nenhum modelo aberto) nem para os erros do código que a sua IA escreve (esegui_csharp, esegui_python, os scripts).

O relato contém um resumo, os passos para reproduzir o problema, o que se esperava e a gravidade. O BIMit acrescenta as últimas chamadas da IA nesta sessão (só o nome da ferramenta e se deu certo ou não; um script promovido aparece como «script_promosso») e as últimas linhas do seu log reduzidas a hora, nível, ponto do código e tipo de erro: nunca o texto das mensagens.

Nunca o conteúdo dos seus modelos. Antes que o relato saia do seu PC, o BIMit oculta as pastas do usuário (viram %USERPROFILE%), os nomes das pastas de projeto, dos modelos e dos arquivos (viram um código curto, como f-5dae2d30), os endereços de e-mail e os tokens ou chaves que a IA possa copiar. O servidor do BIMit aplica de novo as mesmas regras.

Como funciona

  1. A sua IA percebe que uma ferramenta falhou de forma inesperada, ou você diz que algo não vai bem, e chama segnala_problema com um resumo claro e os passos.
  2. O BIMit prepara o relato, retira os dados pessoais e o coloca na fila neste PC (pasta %LOCALAPPDATA%\BIMit\Segnalazioni). O mesmo relato não se repete na mesma sessão, e há no máximo 10 relatos da IA por dia.
  3. Se você disse sim aos relatos automáticos (o painel do BIMit pergunta uma vez; Configurações › Avançado os liga e desliga) e está conectado, o relato segue na hora e a sua IA recebe o código dele; se naquele momento o BIMit não está conectado, segue sozinho assim que estiver. Se você não disse sim, ele fica neste PC e não é enviado, e a sua IA avisa você: você pode enviá-lo em Configurações › Avançado › Relatos automáticos, com «Enviar agora».
  4. No painel do BIMit, a ação da IA que tinha falhado mostra «Relatado» quando o relato foi enviado.

Funciona também com o Revit fechado ou travado: nesse caso o relato fica na fila e segue na próxima abertura do Revit (com o seu sim). Com vários Revit abertos o relato vai para um só: a sua IA não precisa escolher.

Exemplos de pedido

  • «A exportação em PDF parou sem dizer nada: relate isso.»
  • «Isto não funciona: a WBS escreveu códigos errados nas portas.»
  • Nenhum pedido: se uma ferramenta do BIMit devolve um erro interno, o BIMit já o relatou e a sua IA continua o trabalho.

O que muda e como desfazer

O modelo não muda. No seu PC é escrito um pequeno arquivo na fila dos relatos; depois do envio fica só uma linha na lista dos últimos relatos (Configurações › Avançado). Você pode desligar os relatos automáticos quando quiser.

Limites

Sempre ativa (pacote Ler). No máximo 10 relatos da IA e 10 automáticos por dia deste PC; o servidor aceita no máximo 20 novos por dia por conta. Resumo até 500 caracteres, detalhes até 4000, até 20 passos.

Parâmetros

ParâmetroSignificado
riepilogoObrigatório. O problema em uma ou duas frases: o que aconteceu e o que se esperava (3–500 caracteres).
dettagliOutros detalhes úteis: a mensagem de erro, o contexto (até 4000 caracteres). Nada do conteúdo do modelo.
strumentoA ferramenta do BIMit que falhou, se houver (por exemplo tavole_esporta).
gravitabassa (um incômodo), media (o padrão: algo não funciona) ou alta (bloqueia o trabalho ou arrisca dados).
passiOs passos para reproduzir o problema, em ordem (até 20, 300 caracteres cada).

Ferramentas relacionadas

Todas as ferramentas