Ir al contenido

Empiece aquí

Herramientas personalizadas

Guarde en una carpeta los scripts en los que confía y su asistente AI verá cada uno como una herramienta propia. En lugar de escribir código nuevo cada vez, ejecuta por su nombre el script que usted ha comprobado.

Cómo funciona

1

Guarde un script

Coloque un script en Documents\AEC Pilot\Custom Tools. Cada archivo es una herramienta.

2

El asistente lo ve

El asistente lo ve como custom_ más el nombre de la herramienta y lo ejecuta con los argumentos que describe en el archivo.

3

Usted lo aprueba

La ventana de aprobación muestra el archivo completo antes de ejecutarlo.

4

Se ejecuta en su aplicación

Su script comprobado se ejecuta en Revit, AutoCAD, Navisworks o la aplicación en la que trabaje.

  • Funciona con Claude, ChatGPT / Codex, Cursor y otros clientes MCP, y en Pilot Chat.
  • Los cambios en la carpeta se detectan mientras la aplicación está abierta.
  • Settings > Security > Custom tools muestra lo que está cargado, indica por qué un archivo no se cargó y abre la carpeta. La primera vez crea la carpeta con un breve archivo de instrucciones.

Qué idioma

C#

RevitAutoCADCivil 3DAdvance SteelNavisworksInventorRobot

MAXScript

3ds Max

Python

Fusion

El script se escribe de la misma manera que el código que el asistente ejecuta en esa aplicación, con los argumentos en args.

Un archivo, una herramienta

Las primeras líneas del archivo son comentarios que describen la herramienta. Este ejemplo de Revit enumera las hojas cuyo número no comienza con un prefijo dado:

// 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: el nombre, de 3 a 40 letras minúsculas, dígitos o guiones bajos, comenzando con una letra.
  • description: lo que hace la herramienta, en cualquier idioma, hasta 400 caracteres. El asistente lo lee para elegir la herramienta.
  • products: donde se ejecuta: revit, autocad, civil3d, advancesteel, navisworks, inventor, robot, 3dsmax, fusion. autocad también cubre Civil 3D y Advance Steel.
  • readonly: true cuando el script solo lee el modelo.
  • param: una línea por argumento: nombre, tipo (string, number, integer, boolean), obligatorio u opcional, un valor predeterminado opcional y un texto breve.

El asistente lo ve como custom_check_sheet_names, con un argumento de prefijo.

Deje que el asistente lo guarde

Cuando un script funcione, pida al asistente que lo guarde como herramienta personalizada. AEC Pilot comprueba el archivo, se lo muestra completo y solo lo guarda si usted elige Save. Pregunta cada vez y solo escribe en su propia carpeta.

En Fusion

El archivo que se va a guardar debe caber en el cuadro de pregunta de Fusion (40 líneas). Una herramienta más larga se puede colocar en la carpeta a mano.

Seguridad: una herramienta personalizada es código

Settings > Security > Allow custom code debe estar activado. Cuando está desactivado, las herramientas personalizadas no se ejecutan.

Antes de que se ejecute una herramienta personalizada, la ventana de aprobación muestra sus argumentos y el archivo completo, a menos que haya elegido Don't ask again.

Solo se ejecuta el archivo que se le mostró. Si cambia mientras la ventana está abierta, la llamada se rechaza y se solicita nuevamente.

Pasa por las mismas verificaciones que cualquier código de un asistente. En las aplicaciones que tienen una verificación de seguridad, se rechazan llamadas arriesgadas como eliminar archivos o iniciar programas.

En modo de solo lectura, las herramientas personalizadas están desactivadas.

Para TI: una carpeta compartida para la oficina

Establezca el valor de la política CustomToolsFolder (REG_SZ) bajo HKEY_LOCAL_MACHINE\SOFTWARE\Policies\7Dimensions\AEC Pilot, o bajo HKEY_CURRENT_USER, a una carpeta que todos puedan leer, por ejemplo, un recurso compartido de red. Las variables de entorno se expanden.

Carpeta de la oficina

La define TI y todos pueden leerla, por ejemplo un recurso compartido de red.

Su carpeta

Documents\AEC Pilot\Custom Tools

Su asistente

Ve las herramientas de ambas carpetas.

Mismo nombre: gana la herramienta de la oficina

  • Las herramientas en la carpeta compartida están marcadas como compartidas para el asistente.
  • Cuando una herramienta compartida y una herramienta propia del usuario tienen el mismo nombre, se utiliza la compartida.
  • Guardar desde el asistente nunca sobrescribe una herramienta compartida.

Límites

40

herramientas personalizadas por aplicación

64 KB

por archivo

12

argumentos por herramienta

400

caracteres de descripción

  • Cada herramienta se envía al asistente con cada solicitud, por eso la lista se mantiene corta.
  • Solo se lee el nivel superior de la carpeta; se ignoran las subcarpetas.
  • Un archivo que no cumple estos límites no se carga; Settings indica el motivo.

Nuevas herramientas y su asistente

Pilot Chat ve una herramienta nueva o cambiada desde su siguiente mensaje. Un asistente externo mantiene la lista de herramientas que se le dio: reconéctelo a AEC Pilot para ver nuevas herramientas.

Conecte su cliente de AI · Cómo pedirlo · Para administradores de TI