Comece aqui
Por produto
Quando algo dá errado
Procurando o que uma ferramenta específica faz? A Toolbox lista todas elas.
Comece aqui
Ferramentas personalizadas
Guarde os scripts em que você confia em uma pasta, e seu assistente de IA recebe cada um como uma ferramenta própria. Em vez de escrever código novo toda vez, ele executa o seu script conferido pelo nome.
Como funciona
Salve um script
Coloque um script em Documents\AEC Pilot\Custom Tools. Cada arquivo é uma ferramenta.
O assistente o vê
O assistente o vê como custom_ mais o nome da ferramenta e o executa com os argumentos que você descreve no arquivo.
Você aprova
A janela de aprovação mostra o arquivo inteiro antes de rodar.
Ele roda no seu aplicativo
Seu script conferido roda no Revit, no AutoCAD, no Navisworks ou em qualquer aplicativo em que você estiver trabalhando.
- Funciona com Claude, ChatGPT / Codex, Cursor e outros clientes MCP, e no Pilot Chat.
- Mudanças na pasta são detectadas com o aplicativo aberto.
- Settings > Security > Custom tools lista o que foi carregado, diz por que um arquivo não foi e abre a pasta. Na primeira vez, ele cria a pasta com um pequeno arquivo de instruções.
Qual linguagem
C#
MAXScript
Python
O script é escrito do mesmo jeito que o código que o assistente executa naquele aplicativo, com os argumentos em args.
Um arquivo, uma ferramenta
As primeiras linhas do arquivo são comentários que descrevem a ferramenta. Este exemplo para o Revit lista as folhas cujo número não começa com um prefixo informado:
// tool: check_sheet_names
// description: Lists the sheets whose number does not start with the given prefix.
// products: revit
// readonly: true
// param: prefix string required - The sheet number prefix, for example A-
string prefix = (string)args["prefix"];
return new FilteredElementCollector(doc).OfClass(typeof(ViewSheet)).Cast()
.Where(s => !s.SheetNumber.StartsWith(prefix))
.Select(s => s.SheetNumber + " " + s.Name).ToList(); - tool: o nome, de 3 a 40 letras minúsculas, dígitos ou sublinhados, começando com uma letra.
- description: o que a ferramenta faz, em qualquer idioma, até 400 caracteres. O assistente lê isso para escolher a ferramenta.
- products: onde ela roda: revit, autocad, civil3d, advancesteel, navisworks, inventor, robot, 3dsmax, fusion. autocad também cobre o Civil 3D e o Advance Steel.
- readonly: true quando o script só lê o modelo.
- param: uma linha por argumento: nome, tipo (string, number, integer, boolean), obrigatório ou opcional, um valor padrão opcional e um texto curto.
O assistente a vê como custom_check_sheet_names, com um argumento prefix.
Deixe o assistente salvar
Quando um script funcionar, peça ao assistente que o salve como ferramenta personalizada. O AEC Pilot confere o arquivo, mostra tudo a você e só salva quando você escolhe Save. Ele pergunta toda vez e grava apenas na sua própria pasta.
Segurança: uma ferramenta personalizada é código
Settings > Security > Allow custom code precisa estar ativado. Quando está desativado, as ferramentas personalizadas não rodam.
Antes de uma ferramenta personalizada rodar, a janela de aprovação mostra os argumentos e o arquivo inteiro, a menos que você tenha escolhido Don't ask again.
Só roda o arquivo que foi mostrado a você. Se ele mudar com a janela aberta, a chamada é recusada e perguntada de novo.
Ela passa pelas mesmas verificações que qualquer código vindo de um assistente. Nos aplicativos que têm verificação de segurança, chamadas arriscadas, como excluir arquivos ou iniciar programas, são recusadas.
No modo somente leitura, as ferramentas personalizadas ficam desativadas.
Para TI: uma pasta compartilhada para o escritório
Defina o valor de política CustomToolsFolder (REG_SZ) em HKEY_LOCAL_MACHINE\SOFTWARE\Policies\7Dimensions\AEC Pilot, ou em HKEY_CURRENT_USER, apontando para uma pasta que todos possam ler, por exemplo um compartilhamento de rede. Variáveis de ambiente são expandidas.
Pasta do escritório
Definida pela TI, lida por todos, por exemplo um compartilhamento de rede.
Sua pasta
Documents\AEC Pilot\Custom Tools
Seu assistente
Vê as ferramentas das duas pastas.
Mesmo nome: vale a ferramenta do escritório
- As ferramentas da pasta compartilhada aparecem marcadas como compartilhadas para o assistente.
- Quando uma ferramenta compartilhada e uma ferramenta do próprio usuário têm o mesmo nome, vale a compartilhada.
- Salvar pelo assistente nunca sobrescreve uma ferramenta compartilhada.
Limites
40
ferramentas personalizadas por aplicativo
64 KB
por arquivo
12
argumentos por ferramenta
400
caracteres de descrição
- Cada ferramenta é enviada ao assistente a cada pedido, por isso a lista é mantida curta.
- Só o nível principal da pasta é lido; subpastas são ignoradas.
- Um arquivo que não se encaixa não é carregado, e as configurações dizem por quê.
Conecte seu cliente de IA · Como pedir · Para administradores de TI