Metodología
La pestaña Metodología es donde un administrador define cómo trabaja el agente en un proyecto: los estándares que sigue siempre, la metodología de cada rol y los archivos de referencia que lee en cada ejecución. Así es como haces que Makion siga la forma de trabajar exacta de tu equipo, con tus palabras, en lugar de los valores predeterminados genéricos de ABAP.
Todo lo que hay en esta pestaña es editable únicamente por un administrador del proyecto o un superadmin. Todos los demás ven la pestaña en modo de solo lectura con la nota «Solo lectura — un administrador edita esto.» para que puedan ver los estándares a los que se somete el agente sin poder cambiarlos.
La metodología es por proyecto. Si dos equipos trabajan en sistemas SAP distintos con estándares distintos, dales proyectos separados —consulta Configurar proyectos— y ajusta la metodología de cada proyecto de forma independiente.
Cómo se combinan las capas#
Makion guía al agente desde tres capas a la vez. En cada ejecución se combinan en el contexto a partir del cual trabaja el agente:
- Reglas base — se aplican siempre, para cada tarea del proyecto.
- La metodología del rol elegido — el system prompt del rol que el desarrollador seleccionó en el Chat (por ejemplo, un rol de construcción frente a un rol de revisión de solo lectura).
- Archivos de la base de conocimiento — estándares y ejemplos que se materializan en el contexto del agente en cada ejecución.
Así que una sola solicitud se modela mediante reglas base + el rol que elegiste + la base de conocimiento, en conjunto. Las reglas base fijan la verdad de fondo para todo el proyecto; el rol la acota al tipo de tarea; la base de conocimiento aporta los patrones y ejemplos concretos.
Los tres bloques#
| Bloque | Qué contiene | Quién puede editar |
|---|---|---|
| Reglas base | El método y los estándares que el agente sigue siempre en este proyecto | Administrador del proyecto / superadmin |
| Roles | La metodología de cada rol que el desarrollador puede elegir en el Chat | Administrador del proyecto / superadmin |
| Base de conocimiento | Los archivos que el agente lee al trabajar | Administrador del proyecto / superadmin |
Reglas base#
Las Reglas base son el método y los estándares que el agente sigue siempre en este proyecto, sin importar qué rol se elija. Una línea de estado te indica de dónde provienen las reglas actuales:
- «Personalizadas para este proyecto.» — el proyecto tiene sus propias reglas base.
- «Usando los valores predeterminados de ABAP integrados — edítalas para personalizar.» — el proyecto sigue usando los valores predeterminados de ABAP integrados de Makion; edítalos para hacerlos tuyos.
| Control | Qué hace |
|---|---|
| Área de texto de reglas base | Un editor grande que contiene el texto completo de las reglas base que el agente aplica siempre. |
| Guardar reglas base | Guarda tus cambios y cambia el estado a «Personalizadas para este proyecto.» |
Escribe las reglas base en lenguaje sencillo: convenciones de nomenclatura, expectativas de clean-core, disciplina de transportes, hábitos de revisión — lo que el agente deba respetar en cada tarea.
Roles#
El bloque Roles define la metodología de cada rol que el desarrollador puede elegir en el Chat. Un rol es a la vez un límite de permisos y una forma de trabajar: los roles de solo lectura no pueden cambiar SAP, y ese límite se impone en las herramientas que se le entregan al agente, no solo se describe en texto. Para el panorama completo de cómo los roles acotan al agente, consulta Cómo funcionan los roles y Roles de desarrollador.
Los roles aparecen como pestañas, una por rol. Un rol personalizado muestra una etiqueta «custom» para que puedas ver de un vistazo qué roles has adaptado y cuáles siguen con los valores predeterminados.
Para el rol seleccionado puedes editar:
| Control | Qué hace |
|---|---|
| Etiqueta | El nombre visible del rol, tal como aparece en el selector de Rol del Chat. |
| Descripción | Una línea breve que describe cuándo usar este rol. |
| Puede cambiar SAP (escritura) | Si este rol puede escribir en SAP. Sin marcar = solo lectura: al agente solo se le entregan herramientas de lectura y físicamente no puede cambiar SAP. |
| Área de texto de contenido | La metodología / system prompt del rol — cómo debe abordar el agente este tipo de tarea. |
| Guardar rol | Guarda la etiqueta, la descripción, el indicador de escritura y el contenido de este rol. |
| Restablecer valores predeterminados | Para un rol integrado personalizado, restaura el valor predeterminado de fábrica de Makion. Elimina la etiqueta «custom». |
Puede cambiar SAP (escritura) decide si el agente puede modificar tu sistema en este rol. Déjalo sin marcar para cualquier cosa que solo deba investigar o revisar. Solo lectura significa solo lectura: las herramientas de escritura nunca se le pasan al agente.
Ajustar los roles es la parte de mayor apalancamiento de la pestaña Metodología: es como un administrador codifica «así es exactamente como nosotros construimos, revisamos y damos soporte a ABAP» en cada conversación. Empieza por Configurar proyectos cuando pongas en marcha la metodología de un proyecto nuevo.
Base de conocimiento#
La Base de conocimiento contiene los archivos que el agente lee al trabajar: tus estándares, patrones y ejemplos resueltos. Estos archivos se materializan en el contexto del agente en cada ejecución, de modo que todo lo que pongas aquí es material de referencia en el que el agente puede apoyarse directamente.
| Control | Qué hace |
|---|---|
| Lista de archivos | Todos los archivos de conocimiento del proyecto, por ruta. |
| Añadir | Crea un archivo nuevo. Dale una ruta como knowledge/patterns/my-rule.md. |
| Editor | El contenido del archivo seleccionado. |
| Editar | Abre el archivo seleccionado para hacer cambios. |
| Guardar | Guarda el contenido del archivo actual. |
| Eliminar | Quita el archivo seleccionado de la base de conocimiento. |
Usa carpetas en la ruta (por ejemplo knowledge/patterns/… o knowledge/examples/…) para mantener la base organizada a medida que crece. Buenos candidatos: un ejemplo canónico de «cómo estructuramos un informe», un patrón preferido de manejo de errores, una chuleta de nomenclatura, una lista de comprobación que el agente deba repasar antes de terminar.
Las reglas base son ideales para principios breves y siempre ciertos. La base de conocimiento es ideal para material de referencia más extenso y ejemplos concretos que el agente deba imitar. Juntas te permiten «hacer crecer el estándar» con el tiempo sin sobrecargar las reglas base.
A dónde ir después#
- Cómo funcionan los roles — cómo un rol acota lo que el agente puede y no puede hacer.
- Roles de desarrollador — los roles integrados y para qué sirve cada uno.
- Configurar proyectos — poner en marcha un proyecto y su metodología.
- Especificaciones — especificaciones de desarrollo versionadas a partir de las cuales trabaja el agente.