Pular para o conteúdo

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

1

Salve um script

Coloque um script em Documents\AEC Pilot\Custom Tools. Cada arquivo é uma ferramenta.

2

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.

3

Você aprova

A janela de aprovação mostra o arquivo inteiro antes de rodar.

4

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#

RevitAutoCADCivil 3DAdvance SteelNavisworksInventorRobot

MAXScript

3ds Max

Python

Fusion

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.

No Fusion

O arquivo a ser salvo precisa caber na caixa de pergunta do Fusion, 40 linhas. Uma ferramenta maior pode ser colocada na pasta à mão.

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ê.

Ferramentas novas e o seu assistente

O Pilot Chat vê uma ferramenta nova ou alterada a partir da próxima mensagem. Um assistente externo mantém a lista de ferramentas que recebeu: reconecte-o ao AEC Pilot para ver as novas.

Conecte seu cliente de IA · Como pedir · Para administradores de TI