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 de IA, 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 RowTether siguiendo Instalación. La integración de IA y sus cuatro flujos vienen incluidos en el mismo plugin. No tienes que descargar ni instalar otro plugin RowTetherTools.

Para usar IA, activa Unreal MCP y Toolset Registry de Epic, reinicia Unreal y configura un cliente compatible siguiendo Conectar RowTether con IA. Toolset Registry utiliza el plugin Python incluido en Unreal; no necesitas instalar Python en el sistema. El panel de revisión funciona aunque esos plugins del motor no estén instalados o estén desactivados.

La integración se registra automáticamente cuando Toolset Registry está disponible. Descubre rowtether_ai.tools.RowTetherTools y llama a get_connection. RowTether no activa plugins del motor, inicia servidores MCP ni modifica la configuración del cliente por ti. All Toolsets no es necesario para las herramientas propias de RowTether.

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 rowtether_ai.tools.RowTetherTools y llama a get_connection 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 get_connection 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 list_tables e inspect_table, 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 get_configuration y conserva su configurationFingerprint. Una petición propose_profile 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 incluidos 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 de IA

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
get_connection	Confirma proyecto, sesión, versión de API y capacidades.
list_tables	Descubre tablas de /Game sin cargar assets; filtra y pagina.
inspect_table	Lee campos, tipos, operadores compatibles y revisión.
query_rows	Lee campos explícitos de datos actuales con filtros y paginación por revisión.
get_configuration	Lee configuración guardada y su fingerprint de concurrencia.
validate_profile	Comprueba sintaxis y compatibilidad con esquema; no demuestra que los datos cumplan.
start_review	Inicia revisión asíncrona o simulación CSV con perfil e ID de petición.
list_reviews	Recupera trabajos de automatización retenidos tras un timeout.
get_review_status	Lee estado, contadores, identidad y cobertura antes de interpretar resultados.
cancel_review	Cancela ese trabajo de automatización; el panel es independiente.
get_results	Pagina incidencias, resultados de reglas o relaciones con filtros.
get_relationships	Consulta relaciones capturadas o muestras actuales para proponer destinos de texto.
explain_finding	Lee evidencia y trazas registradas de una incidencia.
analyze_impact	Localiza consumidores capturados de una tabla o fila destino.
compare_reviews	Compara dos revisiones retenidas indicando cambios de cobertura y perfil.
propose_profile	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 de herramientas de IA y sus argumentos de primer nivel usan snake_case; 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.

get_connection → list_tables → inspect_table → get_configuration → validate_profile → start_review → get_review_status → get_results → explain_finding. 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 get_results/analyze_impact y luego compare_reviews. 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.

inspect_table → query_rows → get_relationships 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 get_configuration y conserva su fingerprint original. Construye perfil completo, valida, revisa base y propuesta secuencialmente, compara y llama a propose_profile. 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 start_review	Recupera con list_reviews 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.