Trabalho diário

Usar o bot do espaço de trabalho

Inicie o Archibot dentro do code-server e coloque-o para trabalhar: o que ele sabe sobre seu ambiente Archibus, o que ele pode e não pode fazer, prompts prontos para usar e como ele difere do chat do Console.

Membros do clienteAdministradores do clienteOperadores da plataforma

Última atualização 19 de junho de 2026

Todo espaço de trabalho Archibus já vem com o Archibot, um assistente de IA gerenciado que roda dentro do espaço de trabalho e já entende o seu ambiente Archibus. Ele pode ler seu código, validar visualizações AXVW, executar consultas somente leitura no banco de dados do espaço de trabalho, procurar informações na referência do Archibus e operar o aplicativo em execução — tudo isso sem que você precise configurar chaves ou contexto. Este guia é para qualquer pessoa que trabalhe no code-server, qualquer que seja o seu papel.

Para conhecer o restante do ambiente ao seu redor — o editor, o aplicativo, o banco de dados — consulte Trabalhar dentro do seu espaço de trabalho.

Iniciar o bot

Você tem duas formas de começar:

• Terminal. Abra um terminal no code-server (Terminal → Novo Terminal) e execute archibot start. Isso inicia uma sessão gerenciada — por baixo dos panos, é um Codex CLI gerenciado e ajustado para o Archibus.
• Painel do editor. Abra o painel Archibot na barra lateral do editor e digite na caixa de mensagem — sem precisar de terminal. Iniciar Archibot no painel inicia uma sessão.

Você não faz login. O espaço de trabalho já mantém uma chave gerenciada, então o bot está pronto no momento em que o espaço de trabalho está. Se o archibot não for encontrado, talvez o modelo do seu espaço de trabalho não inclua o Archibot gerenciado — verifique com o administrador da sua conta.

Conversar pelo painel do editor

Prefere ficar no editor em vez de usar um terminal? Abra o painel Archibot na barra lateral e use a caixa de mensagem na parte inferior. O painel tem os modos Chat, Agent e Full Access: use Chat para perguntas sobre o arquivo ou projeto em que você está, Agent para deixar o Archibot fazer alterações no seu espaço de trabalho e Full Access para dar a ele um acesso mais amplo ao espaço de trabalho. Ele conversa com o mesmo bot gerenciado, com as mesmas habilidades de Archibus, que o terminal — escolha o que se encaixar no momento.

O que ele sabe e pode fazer

O Archibot é configurado como o assistente de um desenvolvedor de Archibus e WebCentral. Sem nenhuma configuração extra, ele consegue:

• Trabalhar com visualizações AXVW — montar uma nova visualização, explicar uma existente e validá-la em relação às regras do Archibus, relatando os problemas específicos a corrigir.
• Ler o banco de dados, com segurança — executar consultas no estilo SELECT no banco de dados do espaço de trabalho para verificar o schema, examinar linhas de exemplo ou confirmar um datasource. Os resultados têm limite de linhas e respeitam as restrições da visualização.
• Criar datasources, regras de workflow e formulários — e verificá-los em relação às convenções do Archibus antes de você conectá-los.
• Procurar informações — pesquisar na referência do Archibus e na ajuda do produto que já vêm incluídas, em vez de adivinhar.
• Ver o aplicativo em execução — abrir o aplicativo ao vivo em um navegador headless para confirmar se uma visualização é renderizada ou para reproduzir um problema.
• Cuidar de tarefas de compilação e execução — ler registros, reiniciar o Tomcat e percorrer etapas de implantação ou migração.

Ele direciona o trabalho por meio de uma grande biblioteca de habilidades de Archibus (espaço, ativos, contratos, mudanças, projetos, relatórios, segurança e muito mais), então tende a seguir os mesmos padrões que sua equipe já usa.

O que ele não faz

• Ele não altera o banco de dados. Sua ferramenta de consulta é somente leitura — nada de UPDATE, INSERT ou DELETE. Alterações de schema e de dados continuam passando por migrações e pela sua revisão normal.
• Ele não vaza segredos. As chaves de provedor são ocultadas e a leitura de credenciais em texto puro fica desativada, e ele é instruído a manter tokens, chaves e dados brutos de clientes fora de arquivos, notas e de qualquer coisa que ele salve. Mantenha você mesmo o mesmo padrão.
• Ele atua sobre os arquivos do seu espaço de trabalho — revise as edições dele da mesma forma que você revisaria as de um colega antes de fazer commit.

Receitas

Prompts concretos para experimentar. Seja específico e aponte para o arquivo ou tabela que você quer dizer; quanto mais exato você for, melhor o resultado.

Construir uma visualização AXVW

“Crie uma visualização AXVW que liste as salas de um edifício selecionado, com um filtro por edifício e colunas para nome da sala, área e categoria. Valide-a e corrija quaisquer problemas antes de terminar.”

Validar e reparar uma visualização existente

“Valide schema/ab-products/.../my-view.axvw e me oriente na correção de cada erro que você encontrar.”

Inspecionar os dados antes de construir

“Mostre-me as colunas da tabela rm e depois retorne 20 salas de exemplo com seu edifício e andar.”

Adicionar uma regra de workflow

“Adicione uma regra de workflow que envie um e-mail ao gerente de espaço quando a categoria de uma sala mudar, e me mostre onde ela está registrada.”

Trabalhar em um formulário

“Neste formulário, adicione um campo de documento para plantas baixas e valide os controles do formulário.”

Rastrear um datasource

“Encontre o datasource por trás deste painel e adicione uma restrição para que ele mostre apenas registros ativos.”

Descobrir por que uma alteração não aparece

“Minha alteração na visualização não está aparecendo no aplicativo. Verifique os registros do Tomcat, me diga o que está errado e reinicie o Tomcat se essa for a solução.”

Confirmar que ela é renderizada

“Abra a nova lista de salas no navegador e confirme se ela carrega sem erros.”

Procurar uma informação

“Como o Archibus lida com múltiplas moedas em registros de contratos de locação? Cite a referência.”

Enviar para revisão

“Resuma as alterações que fiz e depois envie-as para revisão de CI.”

Essa última usa o archibot-submit-review, que empacota suas alterações para o fluxo de CI Review do Console — consulte Ambientes persistentes e CI Review.

A validação e as consultas ao banco de dados passam pelas ferramentas de Archibus integradas ao Archibot — aqui ele está validando uma visualização AXVW:

Quando você pede para ele alterar algo, o Archibot edita os arquivos no lugar e a alteração aparece no Controle de Origem, pronta para você revisar como qualquer outra edição.

Manter sua sessão

Uma conversa está vinculada ao runtime do espaço de trabalho. Liste sessões anteriores com archibot sessions list e reabra uma com archibot start --session <name>; archibot start sozinho inicia uma conversa nova. Uma sessão não sobrevive a um parar/iniciar nem a uma recriação do espaço de trabalho, então quando o bot produzir algo que você valoriza — um resumo, um plano, um arquivo gerado — salve: faça commit no git ou copie para o Shared Drive. Não conte com rolar de volta um terminal que uma reinicialização vai limpar.

Bot do espaço de trabalho vs. chat do Console

O Archibot também existe como um chat no navegador dentro do Console (Usando o ArchibotChat). Eles compartilham as mesmas habilidades e o mesmo conhecimento de Archibus, mas atuam em lugares diferentes:

• O bot do espaço de trabalho tem as mãos no seu espaço de trabalho — ele lê seus arquivos, executa consultas no seu banco de dados, reinicia seu aplicativo e edita o código no lugar.
• O chat do Console é baseado no navegador e é bom para perguntas, planejamento e referência quando você não está em um espaço de trabalho.

Use um ou outro para uma determinada tarefa. Rodar os dois no mesmo trabalho apenas gasta créditos em dobro.

Outros comandos

• archibot status e archibot doctor — verifique se a sessão gerenciada e suas ferramentas estão saudáveis.
• archibot capabilities — liste o que o bot gerenciado pode fazer neste espaço de trabalho.
• archibot skills list — veja as habilidades de Archibus disponíveis para ele.
• archibot versions — mostre as versões da ferramenta e da imagem gerenciadas em uso.
• archibot feedback — envie feedback higienizado para a equipe da plataforma.
• archibot-v2, archibot-cc e cursor-agent — assistentes gerenciados no estilo Cursor e no estilo Claude, caso você prefira essas interfaces. Eles usam o mesmo acesso gerenciado.

Guias relacionados

• Trabalhar dentro do seu espaço de trabalho — o editor, o aplicativo, o banco de dados e os registros sobre os quais o bot atua.
• Usando o ArchibotChat — a versão de chat no navegador e suas fontes de contexto.
• Workspace Archibot e Shared Drive — onde salvar o que o bot produz.
• Ambientes persistentes e CI Review — o que acontece depois que você envia alterações para revisão.
• Solução de problemas — primeiros passos quando o bot ou o aplicativo se comporta mal.