Código y tareas técnicas
En esta página
Grok para desarrolladores
xAI ofrece un modelo optimizado específicamente para código: grok-build-0.1 (Grok Build). Este modelo ligero está diseñado para la programación en pareja dentro de editores de código. Es significativamente más rápido y menos costoso que los modelos de propósito general. No obstante, un modelo como Grok 4.5 sigue siendo relevante para la depuración compleja y la arquitectura.
Tanto si utilizas Grok para generar código, depurar, documentar o revisar código, los principios de creación de indicaciones (prompts) tratados en este curso se aplican con algunas particularidades.
Generación de código
La indicación mínima (evítala)
Create a food tracker
La indicación eficaz
Create a food tracker in Python with Flask.
Features:
- Log a food item with quantity
- Automatic calculation of calories and macronutrients
- Display daily calorie breakdown by nutrient
- High-level overview and trends
Technical constraints:
- SQLite database
- REST API with documented endpoints
- No frontend (API only)
- Unit tests with pytest
- Error handling with appropriate HTTP codes
La documentación de xAI hace hincapié en este punto: especifica las rutas de los archivos, la estructura del proyecto y las dependencias. Excluye la información irrelevante.
Depuración
La depuración es un caso de uso donde el contexto resulta especialmente importante. Proporciona al modelo toda la información necesaria para reproducir el problema.
Indicación de depuración estructurada
I have an error in my Node.js/Express application.
Relevant code:
```javascript
app.get('/api/users/:id', async (req, res) => {
const user = await db.query('SELECT * FROM users WHERE id = $1', [req.params.id]);
res.json(user.rows[0]);
});
```
Error:
TypeError: Cannot read properties of undefined (reading 'rows')
Context:
- Node.js 20, Express 4.18, pg 8.11
- PostgreSQL 15 locally
- The 'users' table exists and contains data
- The error occurs only for certain IDs
My error codes are defined in src/errors.ts.
The DB connection file is src/db.ts.
Identify the probable cause and propose a fix.
Error con traza de pila (stack trace)
Fix this error. Here is the full stack trace:
[paste the stack trace]
Relevant source file:
[paste the code]
Configuration:
- Python 3.12, Django 5.0
- PostgreSQL database
- Environment: Docker production
Explain the root cause and propose the fix.
Documentación
Documentación de funciones
Document this Python function using Google docstring conventions:
def calculate_weighted_score(items, weights=None, normalize=True):
if weights is None:
weights = [1.0] * len(items)
if len(items) != len(weights):
raise ValueError("Mismatch")
total = sum(i * w for i, w in zip(items, weights))
if normalize:
total /= sum(weights)
return round(total, 4)
Include:
- Function description
- Args with types and descriptions
- Returns with type and description
- Raises with conditions
- A usage example (doctest)
Documentación de API
Generate OpenAPI (Swagger) documentation for this endpoint:
Endpoint: POST /api/v2/invoices
Authentication: Bearer token
Body: JSON with client_id (int, required), items (array of objects with description, quantity, unit_price), due_date (ISO 8601, optional)
Responses: 201 (created), 400 (validation), 401 (unauthenticated), 500 (server error)
Format: YAML OpenAPI 3.0
Revisión de código
Review the code in this pull request.
Code:
[paste the code]
Evaluation criteria:
1. Potential bugs or unhandled edge cases
2. Performance (algorithmic complexity, N+1 queries)
3. Security (injections, data leaks)
4. Readability and maintainability
5. Adherence to PEP 8 conventions
For each issue found:
- Line(s) concerned
- Severity: critical / high / low / suggestion
- Explanation of the problem
- Proposed corrected code
Selección del modelo para código
La documentación de xAI recomienda:
- grok-build-0.1: Trabajo rápido, implementación, búsqueda de código, refactorización rutinaria
- Grok 4.5: Depuración compleja, arquitectura, problemas conceptuales profundos
Para agentes de código que utilicen llamadas a herramientas (tool-calling), prefiere la llamada nativa a herramientas de grok-build-0.1 frente a las salidas en XML, que pueden degradar el rendimiento.
Optimización de la caché
Para interacciones secuenciales (típicas de la programación en pareja), la caché de Grok acelera significativamente las respuestas. El prefijo de la conversación permanece idéntico entre solicitudes, lo que permite su recuperación desde la caché.
Consejo importante: evita modificar el historial de la indicación entre solicitudes. Cualquier modificación rompe la caché y ralentiza la inferencia.
Práctica guiada
Toma un error real de tu código. Escribe una indicación de depuración estructurada que incluya el código, el error, el contexto técnico y los archivos relacionados. Compara la calidad de la respuesta con una indicación mínima («fix this bug: [código]»).
Puntos clave
- Especifica siempre el contexto técnico completo: lenguaje, framework, versiones y estructura del proyecto
- grok-build-0.1 está optimizado para código: es más rápido y barato que los modelos de propósito general
- Para la depuración, proporciona el código, el error completo y el contexto de ejecución
- Utiliza la llamada nativa a herramientas en lugar de salidas XML para agentes de código
- Evita modificar el historial de la indicación para mantener la caché y la velocidad
- Grok 4.5 sigue siendo la mejor opción para la depuración compleja y las decisiones de arquitectura