Un desarrollador enseña a Claude Code y Codex a editar procesos de negocio de Bitrix24 mediante .bpt

Un proceso de negocio en Bitrix24 vive más tiempo del que lo recuerdan sus autores. Una solicitud sigue necesitando aprobación, un responsable asignado, una notificación enviada. Pero con los años el esquema se convierte en un árbol donde los bloques se llaman «Condición» y «Notificación», y para cambiar una ruta hay que recordar las intenciones de otros. Las redes neuronales llevan tiempo analizando repositorios, pero aquí todo se hace a mano. El autor del proyecto decidió remediarlo y dio a los agentes de IA herramientas adecuadas.

Qué recibe el agente

Una petición como «arregla el proceso de negocio» no le aporta nada al modelo: no sabe cómo almacena Bitrix una plantilla. Una captura del esquema tampoco ayuda, porque no muestra las propiedades de los bloques, las expresiones ni los vínculos entre acciones.

Por eso el repositorio contiene un único skill: un archivo con el orden de trabajo, cuatro guías de referencia (estructura de la plantilla, expresiones, tipos de acciones, pasarela) y scripts de Python. Descomprimen el archivo, muestran el árbol, buscan nodos y verifican enlaces. Un .bpt exportado es una serialización PHP sobre zlib, no XML ni JSON. No se puede sustituir directamente un nombre en ruso en el texto: la longitud de la cadena se guarda en bytes y el archivo se rompería. La edición se hace a través de la estructura: cargar, cambiar la propiedad, reensamblar.

Hay dos modos. En el modo de archivo, el agente trabaja con la exportación y la importación al portal queda como un paso aparte; sirve también para la nube si el portal permite exportar e importar. En el segundo modo, un módulo de pago para la edición on-premise ofrece una pasarela: mediante el cliente bpagent.py el agente lee el proceso, encuentra la rama y envía la modificación. No se usa MCP y el módulo no incluye ningún modelo integrado.

Cómo es el trabajo

Primero se ejecuta el validador sobre la plantilla original, para que los defectos antiguos no se atribuyan luego al agente. Después viene la búsqueda: por tipo de nodo, por subcadena, por ejemplo un dominio antiguo, y la lectura del subárbol. Por defecto el cliente no devuelve entero un árbol grande si tiene más de 150 nodos. Una buena práctica: separar la búsqueda y el reemplazo, porque un mismo dominio puede aparecer en el texto de un correo, en una condición o en código ejecutable.

En la práctica, el agente encontró URL incorrectas y problemas con los empleados asignados. El autor aclara con franqueza: no hay mediciones exactas del ahorro de tiempo y no ha creado un proceso desde cero de esta manera.

Seguridad de la escritura

La lectura devuelve el árbol y un hash de versión. La escritura exige ese hash en la cabecera If-Match; de lo contrario, el servidor la rechaza. Antes de guardar, la pasarela comprueba tipos, permisos y tamaños, ejecuta el validador y crea una instantánea. La escritura pasa por el estándar CBPWorkflowTemplateLoader::update(), sin SQL directo. La clave de acceso puede limitarse a permisos de lectura, escritura, creación y ejecución, así como a plantillas concretas. Modificar el PHP integrado (CodeActivity) requiere un permiso aparte, templates:write_code, porque es código ejecutable en el servidor del portal.

Limitaciones

El validador solo comprueba la estructura. Una referencia existente a una constante existente puede ser formalmente correcta y errónea en su significado. La escritura está cerrada para NodeWorkflowActivity. La versión 0.3.1 no tiene bloqueo atómico frente a guardados simultáneos desde el editor visual, así que conviene acordar quién edita el proceso en cada momento. Otro punto: incluso si Bitrix está instalado en tu propio servidor, el contenido de las plantillas llega a un agente externo y queda sujeto a las condiciones de tu herramienta de IA. El módulo aún está en moderación en el Marketplace de 1C-Bitrix.

Qué hacer

Si tienes decenas de procesos acumulados, empieza con el modo de archivo sobre una copia de la exportación: pide al agente solo buscar y explicar, sin cambiar nada. Tras la aprobación, revisa la modificación en el diseñador y pruébala en una entidad de prueba. El patrón general es útil más allá de Bitrix: da al agente un formato, herramientas y el orden «estudiar, cambiar, verificar», y no simplemente un JSON enorme.