Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Qué puede hacer tu asistente con Aggrega

Una vez que tu asistente está conectado al servidor MCP de Aggrega, trabaja con el mismo binario aggrega que ejecutarías en un terminal: lee los esquemas y la documentación, redacta y comprueba tus archivos, construye una Release y, cuando se lo permites, publica. Esta página explica lo que eso abarca, por grupos. La lista completa es la respuesta del propio servidor, y es la que merece confianza: llama a describe-capabilities sin argumentos, o pídele a tu asistente que lo haga, y el servidor enumera cada herramienta que te ofrece, cada una con su propósito en una línea, los tipos de entidad a los que sirve y si escribe. Compatibilidad indica qué puede cambiar una release en las herramientas.

Leer los esquemas y la documentación

El servidor ofrece material de referencia que un asistente lee antes de escribir YAML: el JSON Schema de una entidad (schema://<kind>), cualquier página de la referencia del lenguaje (langref://<path>), la guía de redacción (authoring://<topic>), el YAML redactado de una entidad del catálogo (catalog://<kind>/<name>) y la ayuda de cualquier comando (cli://<command>). Los esquemas están integrados en el binario, y las páginas proceden de una copia de la documentación que el servidor guarda en la caché de tu máquina. Qué hace enumera cada familia.

Asumir un rol o seguir un flujo de trabajo

Los prompts de redacción sitúan al asistente como desarrollador, arquitecto o autor de operaciones, o lo centran en un solo tipo de entidad, de modo que sus sugerencias se mantengan dentro de lo que ese rol redacta. Los prompts de flujo de trabajo establecen el orden de las llamadas para un objetivo que requiere varias: componer un nuevo Aggregate y su Release, llevar a Aggrega un chart, un módulo de infraestructura o un archivo Compose existente, o averiguar por qué falla un build. Tu cliente los enumera como los prompts del servidor.

Averiguar qué contiene un espacio de trabajo

list-entities y list-releases dicen qué contiene tu espacio de trabajo y en qué cantidad, y luego entregan los registros de página en página; describe muestra una entidad o todo lo que alcanza una Release; config-show informa de la configuración vigente y de dónde procede cada ajuste. El servidor también informa de las cachés, los registros configurados y los plugins que resuelve. Consulta Averiguar qué contiene un espacio de trabajo.

Redactar y comprobar tus archivos

scaffold redacta un documento inicial para un tipo de entidad, con los campos que ese tipo exige, o escribe uno de los ejemplos ejecutables de la documentación en un directorio nuevo. get-schema devuelve el JSON Schema de un tipo, validate comprueba un borrador y nombra cada marcador de posición que aún contiene, lint comprueba las convenciones de publicación del catálogo, y explain-error amplía un diagnóstico con la corrección que requiere. Otras herramientas responden a las preguntas que surgen al editar: qué Features pueden adjuntarse a un componente y con qué puede conectarse este, dónde va una entrada nueva en un archivo, y una única edición acotada aplicada a un documento, que deja tal como estaba cada byte que no toca. Consulta Preguntar qué puede adjuntarse y qué puede conectarse con qué y Aplicar una única edición acotada a un documento.

Resolver y construir una Release

pull resuelve las dependencias de una Release en la caché y escribe su lockfile, y build renderiza la Release en sus artefactos, en memoria de forma predeterminada o en dist/ en la raíz del espacio de trabajo cuando el asistente le pide que los escriba. Un build rechazado devuelve los diagnósticos que dicen qué corregir. Consulta Resolver de qué depende una Release y Construir con el contenido que una Release ya fija.

Traer un proyecto desde otra herramienta

import lee una descripción que produjo otra herramienta y escribe borradores de archivos de Aggrega en el espacio de trabajo para que los revises. Consulta Convertir una descripción ajena en borradores de entidades y aggrega import para ver los formatos que lee.

Publicar, firmar y retirar

Cuatro herramientas colocan una entidad o un artefacto en un registro, firman lo que está publicado allí o lo retiran con un marcador firmado. Lo que cambian llega a todos los que resuelven desde ese registro, y nada de ello puede retirarse de quien ya lo tiene, así que estas son las herramientas sobre las que conviene pensar antes de permitirlas. Consulta Publicar, firmar y retirar.

Ejecutar cualquier comando

Para un cliente que inició el servidor en tu propia máquina, a través de la entrada y la salida estándar, el servidor también ofrece una herramienta por cada comando que podrías escribir, con su nombre: cli-build ejecuta aggrega build, cli-validate ejecuta aggrega validate, y así sucesivamente. Un servidor al que se accede por HTTPS no ofrece ninguna de ellas.

Qué puede hacer sin preguntarte

Un asistente conectado a través de la entrada y la salida estándar puede llamar a cualquier herramienta que ofrezca el servidor sin preguntarte, a menos que tu cliente esté configurado para denegarla. Es en tu cliente donde permites y deniegas herramientas por su nombre. Qué puede hacer un asistente sin preguntarte primero nombra las operaciones que van más allá de tu espacio de trabajo, y Restringir lo que anuncia el servidor acorta la lista de herramientas cuando tu cliente no la acepta entera.