Ir al contenido principal
Español— Elegir un idioma
Menú

Prompts de sistema para agentes de API

Lección 14 de 14 Actualizado el 29 de julio de 2026 Desarrollador
En esta página
  1. Creación de agentes con grok-build-0.1
  2. Anatomía de un buen prompt de sistema
  3. Estructuración con Markdown o XML
  4. Optimización de la caché
  5. Ejemplo completo: agente de generación de pruebas
  6. Puntos clave
  7. Pon a prueba tus conocimientos

Creación de agentes con grok-build-0.1

Si estás desarrollando tus propias herramientas de desarrollo —un agente de revisión de código, un asistente de despliegue, una herramienta de generación de documentación—, interactuarás directamente con la API de xAI. El prompt de sistema es tu principal palanca para controlar el comportamiento del modelo.

Anatomía de un buen prompt de sistema

Un prompt de sistema eficaz para un agente basado en grok-build-0.1 contiene cuatro secciones:

1. Descripción de la tarea

Comienza definiendo claramente qué hace el agente:

## Rol
Eres un asistente de revisión de código especializado en TypeScript.
Analizas diffs de código para identificar posibles errores,
problemas de rendimiento e incumplimientos de convenciones.

2. Expectativas y formato de salida

Describe qué esperas del modelo:

## Formato de salida
Para cada problema identificado, proporciona:
- El archivo y la línea implicados
- La gravedad (crítico, advertencia, info)
- Una descripción del problema
- Una sugerencia de corrección con un ejemplo de código

3. Casos límite

Anticipa situaciones ambiguas:

## Casos límite
- Si el diff está vacío, responde "No hay cambios que analizar"
- Si el código está en un lenguaje no compatible, indícalo
- No comentes cambios de formato (espacios, sangría)
- Ignora archivos de configuración generados (.lock, dist/)

4. Restricciones

Define los límites:

## Restricciones
- Máximo 10 comentarios por revisión
- Prioriza los errores críticos sobre las sugerencias de estilo
- No sugieras refactorizaciones importantes para correcciones menores

Estructuración con Markdown o XML

El modelo está acostumbrado a ver un contexto extenso y estructurado en el primer prompt. Dos formatos funcionan bien:

Markdown (recomendado para legibilidad)

## Rol
Descripción del rol...

## Herramientas disponibles
- read_file: leer un archivo del proyecto
- write_file: modificar un archivo
- run_command: ejecutar un comando de terminal

## Reglas
1. Lee siempre el archivo antes de modificarlo
2. Pide confirmación antes de eliminar código
3. Ejecuta las pruebas tras cada modificación

XML (recomendado para precisión)

<agent>
  <role>Asistente de revisión de código en TypeScript</role>
  <tools>
    <tool name="read_file">Leer un archivo del proyecto</tool>
    <tool name="write_file">Modificar un archivo</tool>
  </tools>
  <rules>
    <rule>Lee siempre el archivo antes de modificarlo</rule>
    <rule>Pide confirmación antes de eliminar código</rule>
  </rules>
</agent>

Ambos formatos son eficaces. Markdown es más fácil de mantener; XML es más estructurado para el análisis automático.

Optimización de la caché

Recuerda la lección sobre la caché: el prompt de sistema debe ser estable. Escríbelo una vez, de forma completa, y no lo modifiques durante la sesión. Si necesitas cambiar el comportamiento del agente, añade instrucciones en el mensaje de usuario en lugar de modificar el prompt de sistema.

Ejemplo completo: agente de generación de pruebas

## Rol
Eres un agente que genera pruebas unitarias para código TypeScript.
Utilizas Vitest como framework de pruebas.

## Proceso
1. Lee el archivo fuente con read_file
2. Identifica las funciones exportadas
3. Para cada función, genera pruebas que cubran:
   - El caso nominal
   - Casos límite (null, undefined, array vacío)
   - Casos de error
4. Escribe las pruebas con write_file en la carpeta __tests__/
5. Ejecuta las pruebas con run_command("npx vitest run")

## Convenciones
- Nomenclatura: {archivo}.test.ts
- Estructura: describe > it > expect
- Usa fixtures para datos complejos
- Simula dependencias externas (API, BD)

## Restricciones
- No modifiques el código fuente
- Si una prueba falla, corrige la prueba, no el código fuente
- Máximo 20 pruebas por archivo

Este prompt de sistema proporciona al agente toda la información necesaria para operar de forma autónoma, manteniéndose dentro de los límites definidos.

Puntos clave

  • El prompt de sistema estructura el comportamiento del agente en 4 partes: rol, expectativas, casos límite, restricciones
  • Usa Markdown o XML para estructurar las secciones
  • El prompt de sistema debe ser estable para optimizar la caché
  • Incluye procesos paso a paso para agentes secuenciales
  • Define siempre casos límite para evitar comportamientos inesperados

Pon a prueba tus conocimientos

grok-build en tus editores: tomando el control total.

1. ¿Qué es grok-build-0.1?

Respuesta: El modelo de código agente de xAI: llamada nativa a herramientas, razonamiento en streaming, contexto adaptado para tareas de desarrollo: el motor detrás de Grok Build y las integraciones con editores.

2. ¿Cómo se usa en tu editor?

Respuesta: Mediante integraciones: Cline en VS Code, Cursor, GitHub Copilot, Windsurf y otros; la API de xAI compatible con OpenAI hace posible la integración directa.

3. ¿Qué hábitos garantizan buenas tareas de código?

Respuesta: Especifica el contexto (archivos, restricciones), define objetivos claros y verificables, itera progresivamente y optimiza la caché manteniendo estables los prefijos.

4. ¿grok-build-0.1 o grok-4.5 para código?

Respuesta: grok-build para tareas agente de desarrollo cotidianas (rápido, especializado); grok-4.5 cuando la tarea exige el máximo razonamiento; la elección sigue la dificultad.

5. ¿Qué debe incluir el prompt de sistema de un agente de código por API?

Respuesta: El rol, las convenciones del proyecto, las reglas de edición (pruebas, estilo) y los límites: el encuadre que convierte un modelo de código en un compañero para tu base de código.

Modelo especializado, editor conectado, tareas limpias, prompts encuadrados: el desarrollo asistido por Grok se reduce a cuatro elecciones, todas tomadas intencionadamente.