CapChat, o assistente de IA

O que faz

CAPCAD_CAPBOT abre a janela CapCad AI, não modal, única por sessão: rodar o comando de novo apenas a traz para a frente. A conversa é zerada quando a janela é criada.

Cada clique em Go (12) percorre este caminho:

1. A pergunta. Vazia, a resposta é Type a question first. e nada acontece.
2. O escopo. No modo Seleção (8) sem uma seleção fresca, a janela se esconde, o comando pede a seleção no desenho e a janela volta. Desistindo, a resposta é Selection cancelled. Try again.
3. O prompt. O CapCad monta o contrato de execução, acrescenta todas as habilidades instaladas, o bloco da seleção (quando houver) e, no modo de gravação, o protocolo de alteração.
4. A geração. A pergunta vai para a API com o modelo escolhido na aba Habilidades, dentro de uma janela de conversa de seis mensagens.
5. A rede de segurança, só no modo de gravação (ver Modo de gravação).
6. A execução. O arquivo .lsp gerado é carregado no desenho, com (load …).
7. A espera. O CapCad fica olhando o arquivo de resultado por até 30 segundos. Estourado o prazo, a resposta avisa que o comando pode ainda estar rodando e sugere uma pergunta mais focada.
8. A resposta aparece na caixa (14), entra na conversa (para que a próxima pergunta possa se apoiar nela) e o par pergunta/prompt/LISP/resultado é gravado no log.

A caixa Resposta da IA mostra, portanto, o que o LISP escreveu no arquivo de resultado — não o texto do modelo. Quando a IA responde em prosa, em vez de código, o CapCad embrulha essa prosa num LISP que apenas grava o texto no arquivo, de modo que o caminho é sempre o mesmo.

Fluxo de trabalho

Uma pergunta sobre o desenho

1. Rode CAPCAD_CAPBOT.
2. Escreva a pergunta em (1), ou escolha uma das Perguntas de exemplo (2) — escolher uma preenche a caixa, e você pode editar antes de enviar.
3. Deixe Somente leitura (4) e Todos (7).
4. Go (12). O botão vira Thinking... e a barra de progresso anda.
5. Leia a resposta em (14). Se ela for uma tabela, Para Excel (15); se for texto longo, Para texto (16).
6. Pergunte de novo: a conversa continua, e a IA lembra do que respondeu antes.

Uma pergunta sobre um trecho

1. Marque Seleção (8).
2. Go (12). A janela se esconde e o CAD pede a seleção — ou aproveita a que já estiver feita.
3. Selecione e confirme. A janela volta, mostrando "N entities selected" em (10).
4. A pergunta passa a valer só para aquelas entidades.
5. Limpar (11) descarta a seleção; a próxima pergunta volta a valer para o desenho inteiro.

Uma alteração no desenho

1. Marque Leitura-gravação (5). A linha de estado (17) fica vermelha.
2. Deixe Salvar o dwg antes de executar (6) marcada.
3. Escreva o que quer mudar, com números: "mover 10 unidades acima entidades com comprimento menor que 30".
4. Go (12). Antes de qualquer alteração, aparece a confirmação com o resumo do que vai mudar.
5. Confira o resumo. Sim aplica; Não cancela e a resposta é Changes cancelled by the user.
6. Não gostou do resultado: Ctrl+Z.

O formulário

Sem captura de tela. Os números abaixo seguem a ordem em que os controles aparecem: primeiro a aba CAD, de cima para baixo, depois a aba Habilidades.

Aba CAD — a pergunta

Aba CAD — modo e escopo

Aba CAD — executar e ler

Aba Habilidades

A aba Habilidades tem só esse quadro. Ela não lista nem edita as habilidades instaladas, apesar do nome — ver As habilidades.

As habilidades

O CapCad não manda a pergunta sozinha: ele manda junto um contrato de execução e, coladas a ele, todas as habilidades instaladas — cada pasta com um arquivo SKILL.md dentro de Support\ccai\skills\. Elas são o que faz a IA entender um projeto de sinalização em vez de um dwg qualquer.

O produto traz três:

Acrescentar uma habilidade é criar uma pasta com um SKILL.md dentro de skills\. Não há botão para isso: o CapCad simplesmente lê o que estiver na pasta, a cada pergunta. Uma habilidade específica nunca anula o contrato do capcad-core.

Modo de gravação

No modo Leitura-gravação, o prompt ganha um protocolo, e o CapCad ganha três travas:

1. O sentinela de confirmação. Toda alteração tem de começar por uma linha de comentário ; ccai-confirm: com um resumo específico e quantitativo do que vai mudar, em português — "Vou modificar PLACA_ACAO em 23 placas R-2 (de 'implantar' para 'manter')", e não "Modificando placas". O CapCad lê esse resumo e o mostra numa caixa de confirmação antes de executar. Sem confirmação, nada roda.
2. A trava da seleção. Se o código gerado tentar redefinir a lista de entidades selecionadas que o CapCad injetou, a execução é recusada com "Generated LISP tries to redefine ccai-input-handles. Execution blocked by safety."
3. A pré-condição. O protocolo exige que a alteração seja verificada antes de aplicada — que o nome de destino de uma renomeação não exista, que a exclusão conte o que vai apagar — e proíbe aplicação parcial: ou tudo, ou nada. Falhando a verificação, o LISP grava ccai-precondition-failed: e o CapCad transforma isso na mensagem "The operation could not be performed safely:" seguida do motivo.

Uma consulta de leitura não precisa do sentinela — e é justamente por isso que ela não passa por nenhuma dessas três travas. Ver Notas.

A seleção

Seleção (8) não guarda uma lista de entidades em memória: ela grava um arquivo, ccai_selection.txt, com o handle e o tipo de cada entidade escolhida, mais a data, a contagem e o nome do desenho.

• A seleção corrente é aproveitada se houver uma; senão, o comando pede uma nova.
• O arquivo vale por 60 minutos. Passado esse prazo, ele é ignorado como se não existisse — nem o estado (10) nem o prompt o enxergam.
• Enquanto vale, os handles entram no prompt e são injetados no LISP como uma lista pronta, e o prompt manda a IA operar só sobre elas, salvo se a pergunta pedir o desenho inteiro explicitamente.
• Limpar (11) apaga o arquivo.

Lembrado entre sessões

A conversa vive só na memória, cabe seis mensagens e é zerada por Limpar memória (3) e por qualquer reabertura da janela depois de fechada.

Em disco, dentro de Support\ccai\ na pasta de instalação do CapCad, ficam:

O log é o melhor lugar para entender uma resposta estranha: ele mostra exatamente o código que rodou no seu desenho.

Notas

• É um comando beta, e a própria janela diz isso. O aviso no topo pede que você salve o trabalho antes de executar e confira os resultados. Leve a sério: o LISP é escrito por uma IA e roda no seu desenho.
• "Somente leitura" é uma instrução, não uma tranca. O prompt manda a IA não alterar o desenho, mas nesse modo o código gerado é carregado sem as travas do modo de gravação — sentinela de confirmação, trava da seleção e pré-condição. Um LISP que altere o desenho apesar da instrução rodaria sem confirmação. Na prática o modelo obedece; ainda assim, salve antes.
• O que sai da sua máquina é a pergunta, não o desenho. Vão para a API a pergunta, o histórico da conversa, o contrato, o texto das habilidades e — quando há seleção — a quantidade de entidades e a idade da seleção. As entidades, as suas coordenadas e o conteúdo do dwg não são enviados: quem lê o desenho é o LISP, que roda localmente. Os handles das entidades selecionadas ficam no arquivo local e são injetados no LISP, não no prompt.
• O prazo de 30 segundos é do resultado, não do comando. Estourado o prazo, o CapCad desiste de esperar, mas o LISP pode continuar rodando no CAD. Olhe a linha de comando antes de perguntar de novo.
• O botão IDs (9) não está disponível nesta versão.
• A aba Habilidades não gerencia habilidades. Apesar do nome, ela contém apenas a escolha do modelo. As habilidades são pastas em disco.
• O texto de aviso no topo da janela fica em inglês mesmo no produto em português. O quadro Model e o botão Go também não são traduzidos, em idioma nenhum.
• As mensagens de estado e de erro estão todas em inglês — Read-only mode, Thinking..., Type a question first., Selection cancelled. Try again. —, ainda que a caixa de confirmação de alteração e o resumo dentro dela venham em português.
• A resposta em CSV depende do que a IA gravou. O Para Excel (15) só funciona quando a resposta é realmente separada por vírgulas; peça isso na pergunta ("responda em CSV") quando quiser a tabela.
• A conversa guarda só as seis mensagens mais recentes. Numa sequência longa, o começo é esquecido — e o resultado de cada execução também entra nessa contagem. Para uma pergunta nova e independente, Limpar memória (3) evita que o contexto antigo atrapalhe.