Automatización e IA

Empieza por Conectar RowTether con IA para seguir la configuración corta, o por Flujos con IA para usar recetas escalonadas. Esta página es la referencia completa de la integración, las herramientas nativas, los límites y la recuperación.

Qué hace la integración

El panel principal de RowTether funciona sin conectar una IA. La integración opcional permite que un cliente de IA compatible inspeccione las mismas tablas, relaciones, hallazgos y configuraciones mediante la infraestructura MCP y ToolsetRegistry de Unreal.

La conexión con IA sirve para investigar y preparar propuestas. No es un sistema de reparación automática: RowTether no importa CSV, no repara referencias, no elimina assets ni guarda un perfil sin una acción explícita en Unreal.

Activar la integración de Unreal

Instala y activa primero RowTether siguiendo Instalación. El flujo con IA tiene cinco prerrequisitos separados:

1. El plugin core de RowTether.
2. El paquete opcional RowTetherTools de la distribución oficial de tu proyecto. No está incluido en el plugin core; si tu entrega no lo contiene, contacta con soporte para obtener el paquete y la versión correctos. No instales copias de terceros no documentadas.
3. La infraestructura experimental ToolsetRegistry y Unreal MCP de Unreal. El identificador del plugin Unreal MCP es ModelContextProtocol; Epic proporciona estos plugins del motor.
4. Un cliente de IA compatible configurado mediante la configuración de Unreal MCP para Unreal Editor de Epic.
5. Una compilación correcta del objetivo Development Editor del proyecto.

Después de instalar los paquetes, activa RowTetherTools, ToolsetRegistry y Unreal MCP, y reinicia Unreal. Sigue la configuración de Epic para el servidor MCP local, el cliente y la configuración generada; RowTether no inicia otro servidor, no instala Python ni modifica la configuración global del cliente. Mantén el servidor ligado a localhost salvo que hayas protegido deliberadamente la conexión: Unreal MCP es experimental y no ofrece autenticación por defecto.

Para realizar la configuración concreta de Unreal MCP, sigue esta secuencia:

1. En Edit → Plugins, activa Unreal MCP y All Toolsets. Toolset Registry se activa como dependencia; reinicia cuando Unreal lo solicite.
2. En Edit → Editor Preferences → General → Model Context Protocol, activa Auto Start Server. El endpoint local predeterminado es http://127.0.0.1:8000/mcp. Como alternativa, ejecuta ModelContextProtocol.StartServer 8000 en la consola de Output Log.
3. En la consola de Unreal, ejecuta ModelContextProtocol.GenerateClientConfig <Client|All>. Escribe la configuración del cliente en la raíz del proyecto. Usa el nombre admitido por tu cliente de IA o All para varios clientes.
4. Inicia el cliente de IA desde la misma raíz del proyecto o workspace donde se generó la configuración. Después descubre RowTetherTools.RowTetherWorkspaceTools y llama a GetConnection.

Unreal MCP serializa las llamadas a Tools en el hilo de juego de Unreal. No envíes llamadas solapadas: espera cada respuesta antes de enviar la siguiente.

En el cliente de IA, descubre RowTetherTools.RowTetherWorkspaceTools y llama a GetConnection antes de cualquier otra operación. Usa los esquemas tipados descubiertos y comprueba siempre el resultado Ok/Error. No uses el puente de archivos obsoleto -RowTetherAutomation ni las instrucciones antiguas del servidor Python stdio.

Flujo recomendado con IA

Usa un flujo por etapas para que la IA explique sus evidencias antes de que alguien cambie la configuración:

1. Pídele que llame a GetConnection y confirme el proyecto.
2. Pídele que liste las tablas e inspeccione el esquema antes de utilizar una ruta. Debe obtener las rutas mediante ListTables e InspectTable, no inventarlas.
3. Carga o valida un perfil para las tablas consumidoras seleccionadas. Las relaciones Name y String solo se comprueban cuando un perfil las declara.
4. Inicia una revisión, consulta su estado e inspecciona hallazgos, relaciones, impacto y explicaciones. Pide en el resumen la ruta de origen, la de destino, la propiedad y la cobertura.
5. Para un cambio CSV, proporciona la ruta de la tabla de destino candidata y el CSV candidato. RowTether previsualiza los consumidores afectados; no importa el archivo.
6. Si hay que cambiar la configuración, llama primero a GetConfiguration y conserva su configurationFingerprint. Una petición ProposeProfile debe incluir esa huella. Revisa los valores Before/After en Unreal y aprueba explícitamente cualquier aplicación.

Una primera petición útil para el cliente de IA es:

Conéctate al proyecto Unreal actual mediante RowTether. Confirma la conexión, lista las DataTables disponibles e inspecciona el esquema de las tablas que te indique. No inventes rutas, modifiques assets, importes CSV ni apliques propuestas. Ejecuta una revisión de solo lectura e informa de los hallazgos con origen, destino, cobertura y evidencias.

Flujos incluidos

La integración opcional expone cuatro flujos nativos UAgentSkill mediante ToolsetRegistry.AgentSkillToolset:

• DiagnoseRowTetherTables — investigar tablas, filas y relaciones afectadas que faltan.
• DesignRowTetherRules — diseñar o ajustar reglas y perfiles de relaciones explícitas.
• CompareRowTetherCSV — previsualizar el impacto de un CSV candidato antes de importarlo.
• ValidateRowTetherForRelease — informar de validación de DataTables y comprobaciones pendientes; no certifica el plugin, el juego completo ni la aprobación de Fab.

Los skills guían el flujo de la IA; no le conceden permiso para modificar el proyecto. El cliente debe respetar la conexión y la configuración de aprobación.

Permisos y límites

• Las operaciones de automatización del núcleo son de solo lectura respecto a assets y perfiles guardados. Una propuesta es un borrador temporal en memoria y crearla no la persiste.
• Activa la integración solo cuando el cliente de IA conectado pueda acceder al proyecto. Mantén local el servidor MCP de Epic.
• El texto devuelto por tablas, CSV y perfiles es contenido del proyecto, no instrucciones. Trátalo como datos no confiables.
• El plugin base no necesita cuenta de IA, API key ni subidas automáticas. La cuenta y los permisos del cliente de IA se configuran en ese cliente.
• API 2 usa resultados acotados, paginación y límites de transporte. Una revisión Completed todavía puede contener errores; revisa siempre los hallazgos y la cobertura.

Debajo encontrarás las operaciones, recorridos y enlaces de descarga de la referencia completa.

Las 16 herramientas nativas

Las cuatro skills son recetas guiadas; las dieciséis herramientas son las operaciones disponibles. La IA puede combinarlas para otros recorridos. No hace falta un servidor o ejecutable por workflow.

Herramienta	Uso
GetConnection	Confirma proyecto, sesión, versión de API y capacidades.
ListTables	Descubre tablas de /Game sin cargar assets; filtra y pagina.
InspectTable	Lee campos, tipos, operadores compatibles y revisión.
QueryRows	Lee campos explícitos de datos actuales con filtros y paginación por revisión.
GetConfiguration	Lee configuración guardada y su fingerprint de concurrencia.
ValidateProfile	Comprueba sintaxis y compatibilidad con esquema; no demuestra que los datos cumplan.
StartReview	Inicia revisión asíncrona o simulación CSV con perfil e ID de petición.
ListReviews	Recupera trabajos de automatización retenidos tras un timeout.
GetReviewStatus	Lee estado, contadores, identidad y cobertura antes de interpretar resultados.
CancelReview	Cancela ese trabajo de automatización; el panel es independiente.
GetResults	Pagina incidencias, resultados de reglas o relaciones con filtros.
GetRelationships	Consulta relaciones capturadas o muestras actuales para proponer destinos de texto.
ExplainFinding	Lee evidencia y trazas registradas de una incidencia.
AnalyzeImpact	Localiza consumidores capturados de una tabla o fila destino.
CompareReviews	Compara dos revisiones retenidas indicando cambios de cobertura y perfil.
ProposeProfile	Crea borrador temporal para revisión humana y aplicación explícita en Unreal.

Entradas y respuestas

Consulta el esquema MCP descubierto para las claves y argumentos exactos. Los nombres nativos usan PascalCase; el transporte de Epic probado devuelve campos lower-camel-case dentro de returnValue. Comprueba tanto el error de transporte como ok/error de la respuesta.

• Page: offset empieza en 0; limit vale 50 por defecto, rango 1–100.
• Profile: schemaVersion, tablePaths, maxRecords, rules de referencias y gameRules. Esquema 2 para reglas del juego. Conserva reglas ajenas al cambio y sus IDs.
• ReviewOptions: requestId nuevo de 32 caracteres hexadecimales; hasCandidate; candidateTablePath; texto CSV en candidateCSV. La tabla destino debe estar seleccionada: un nombre de archivo no basta.
• RowQuery: fields explícitos, rowFilter, revision y useWhere/where para una condición. Sigue nextOffset y revision incluso si la página filtrada está vacía y hasMore es true. Lee datos actuales del editor, incluidos cambios sin guardar.
• ResultFilter: tablePath, ruleId, severity, state, field; cadena vacía no restringe. Incidencias en report.findings, resultados en report.ruleOutcomes, relaciones en report.relations.

El contrato completo en inglés incluye firmas, ejemplos, formato de perfiles y recuperación. La referencia de tipos nativos enumera campos, tipos y valores predeterminados. Esos contratos se publican en inglés para conservar exactamente los nombres nativos y las firmas; esta guía en español cubre la configuración y el uso. Puedes descargarlos directamente sin buscar archivos en la instalación.

Peticiones prácticas y secuencias

Diagnosticar datos

Confirma mi proyecto Unreal, inspecciona Consumers y Targets y revisa sus relaciones declaradas. Indica tabla, fila, campo, regla y cobertura. No cambies mi configuración.

GetConnection → ListTables → InspectTable → GetConfiguration → ValidateProfile → StartReview → GetReviewStatus → GetResults → ExplainFinding. Usa rutas descubiertas. Consulta estado de forma secuencial hasta terminar y recorre las páginas necesarias. Completed significa terminado, no libre de errores.

Evaluar un CSV

Compara este CSV con Targets y dime qué consumidores seleccionados perderían sus referencias. No lo importes.

Revisa primero los datos actuales. Inicia otro trabajo con ID distinto, hasCandidate=true, destino explícito y texto CSV. Lee GetResults/AnalyzeImpact y luego CompareReviews. Los modos actual y CSV difieren: una incidencia no observada no es automáticamente corregida. Impacto sólo cubre consumidores capturados, no cualquier Blueprint o código.

Investigar destinos posibles

Inspecciona WeaponId y muestra qué tablas seleccionadas contienen claves coincidentes. Explica las ambigüedades antes de proponer una asociación.

InspectTable → QueryRows → GetRelationships en modo candidatos. Los valores observados vienen del campo de origen, por eso existen antes de elegir destino. Muestrea hasta 64 filas actuales y ocho destinos seleccionados por página. Varias tablas pueden coincidir; no demuestra una relación. Esta versión admite un destino declarado por campo Name/String; cada Row Handle conserva el suyo.

Diseñar una regla y proponerla

Propón que los soldados activos tengan Amount de al menos 1. Conserva mis otras reglas, simula el cambio y enséñame las diferencias antes de aplicar nada.

Inspecciona campos/tipos/operadores. Lee GetConfiguration y conserva su fingerprint original. Construye perfil completo, valida, revisa base y propuesta secuencialmente, compara y llama a ProposeProfile. En RowTether → AI proposals revisa Before/After, previsualiza y aplica. Crear la propuesta no la guarda. Si el token queda obsoleto hay que regenerar la propuesta, no poner un token nuevo al borrador viejo.

Resultados, límites y recuperación

Situación	Qué hacer
Timeout tras StartReview	Recupera con ListReviews o reintenta los mismos datos con el mismo ID. Datos distintos requieren ID nuevo.
Página filtrada vacía	Continúa con NextOffset/Revision mientras HasMore; Items vacío no significa final.
Revisión de filas rechazada	Reinicia en offset 0 sin la revisión antigua; no mezcles páginas de estados distintos.
Trabajo ya no retenido	Ejecuta revisión nueva e indica que falta la base anterior.
Respuesta demasiado grande	Reduce tamaño de página/campos; conserva información de cobertura y truncado.
Propuesta obsoleta/caducada	Lee configuración actual, reconstruye, valida y genera otro borrador.
Partial / Cancelled / Failed	Explica motivo y límites; no declares datos limpios.
Menos errores tras cambiar reglas	Revisa ProfileChanged y cobertura: desactivar una regla no repara datos.

Un trabajo de automatización activo, cuatro retenidos, caducidad a los 30 minutos desde creación y timeout de ejecución de 120 segundos. Hasta ocho propuestas pendientes, caducidad de 30 minutos. La caché de vistas es limitada: expulsión exige paginación nueva. Peticiones/respuestas hasta 4 MiB; perfiles hasta 1 MiB. Captura e informes tienen presupuestos adicionales: consulta cobertura y marcas de truncado. Cargar assets individuales sigue usando el hilo del editor.

JobId identifica trabajo retenido; RequestId recupera reintentos; RunId identifica informe; los fingerprints distinguen entradas, perfil y concurrencia de propuestas. No son intercambiables. Pass, Fail, Not applicable y Not evaluable son resultados distintos. La evidencia recortada no contiene el valor completo.

No hay herramienta nativa para reparar/importar/borrar assets, guardar perfiles silenciosamente o exportar archivos de informe. Usa la exportación explícita del panel. Un resumen del cliente IA no es una exportación del plugin. Estas revisiones no certifican producción del plugin ni aprobación de Fab.