Modo CODE

CODE es el flujo de trabajo de la interfaz para generar y refactorizar salida de scripts de FileMaker con controles de revisión y aplicación integrados en el chat.

Para qué sirve CODE

• Crear scripts a partir de lenguaje natural.
• Refactorizar lógica existente a partir de contexto de script adjunto.
• Revisar la salida generada antes de aplicarla a Script Workspace.

Antes de enviar una solicitud CODE

1. En Script Workspace, asegúrate de que el script de destino sea visible.
2. Si quieres una edición enfocada, selecciona las líneas concretas del script.
3. Haz clic en Add Selection para el script o la selección actual, o en Add Scripts si la tarea depende de varias pestañas abiertas de Script Workspace.
4. Verifica que la insignia de contexto en vivo o las insignias de scripts adjuntos coincidan con el alcance previsto.
5. Escribe una petición clara para la generación o la refactorización.

Flujo completo de CODE

1. Envía una solicitud en modo CODE.
2. Espera a que terminen las tres fases de generación.
3. Usa los enlaces Preview Code y Apply Code dentro del mensaje cuando estén disponibles.
4. Observa el indicador de progreso Applying….
5. Valida los cambios generados en la vista previa antes de aplicar.
6. Valida el resultado en Script Workspace.

1) Estructurar la intención

CODE empieza estructurando tu solicitud antes de generar nada.

• Si los detalles no están claros, Genie puede hacer preguntas cortas de aclaración.
• Los límites de aclaración se controlan en Settings > Clarification Budget > Preflight Questions.

2) Planificar capacidades

Una vez estructurada la intención, Genie planifica qué capacidades necesita tu solicitud.

3) Generar XML

Luego Genie genera la salida XML para el trabajo pedido. Durante esta fase, el chat muestra la generación en curso.

4) Respuesta con enlaces Preview y Apply

Cuando Genie acepta un artefacto CODE seguro, muestra enlaces de acción directamente en el mensaje del asistente.

5) Comportamiento de Preview Code

Preview Code abre Viewer para que inspecciones la salida antes de aplicarla.

• Revisión XML en Viewer con búsqueda y resaltado.
• Vista de texto para una lectura compacta.
• Compatibilidad con copia para flujos de trabajo manuales de respaldo.

6) Comportamiento de Apply Code

Apply Code usa una operación nativa para escribir los cambios de forma segura en FileMaker. Genie determina automáticamente el mejor método de aplicación según la salida generada:

• Active Selection Edit: aplica el cambio en la ubicación correcta de la selección actual cuando es posible.
• Full Script Apply: escribe el cuerpo completo de un script cuando solicitas una salida de script completo.
• Selection Fallback: si falla la colocación precisa por selección, Genie pega el bloque completo generado con comentarios en la línea activa.
• Progress Indicator: muestra el estado Applying... en el chat mientras se ejecuta la operación.
• Safety: se detiene si cambia el estado de Script Workspace, por ejemplo al cambiar de script o al editar una línea antes de que termine la aplicación.
• Confirmation: muestra un mensaje de éxito una vez actualizado el script.

Cuando Preview y Apply permanecen deshabilitados

A veces Genie todavía puede mostrar un borrador en el chat, pero no puede exponer un artefacto seguro para aplicar.

• En ese caso, Genie muestra un display-only draft en línea.
• Preview Code y Apply Code permanecen deshabilitados.
• Toma ese estado como una señal de revisión: afina la petición, captura otra vez el contexto correcto con Add Selection o Add Scripts, o vuelve a intentarlo después de corregir el problema de fondo.

Project Rules en modo CODE

Project Rules puede dar forma al comportamiento de CODE para la base de datos activa.

• Las reglas pueden influir en el mismo resultado generado, incluidas las ediciones delta, siempre que el trabajo pedido se mantenga dentro del alcance permitido.
• Las reglas no crean una segunda pasada garantizada.
• Las reglas no amplían la autoridad de CODE, los límites de selección ni los permisos de aplicación.

Por ejemplo, una regla como When editing an existing script, update the top-of-script change log if one already exists. puede influir en la edición generada cuando ese encabezado ya forma parte de la tarea que Genie está autorizado a cambiar.

Seguridad y restricciones

• Si la petición solo plantea una pregunta, Genie puede sugerir que pases a ASK.
• Para scripts grandes, Genie puede usar Compact-Mode para un manejo más fiable del contexto.

Recuperación y respaldo

• Si la aplicación falla, enfoca Script Workspace y vuelve a intentarlo.
• Si hace falta, puedes copiar manualmente desde Preview y pegar a mano.
• Si la tarea abarca varios scripts relacionados, usa Add Scripts en lugar de intentar que una sola selección viva cargue todo el contexto.

Buenas prácticas

• Mantén el contexto capturado alineado con la tarea exacta usando Add Selection para ediciones en vivo y Add Scripts para trabajo con varios scripts.
• Vigila el estado Applying... para asegurarte de que la operación termina correctamente.

Páginas relacionadas

• Context Capture
• Modo ASK
• Project Rules
• Settings Guide
• Script Workspace Actions