Cod și sarcini tehnice
Pe această pagină
Grok pentru dezvoltatori
xAI oferă un model optimizat special pentru cod: grok-build-0.1 (Grok Build). Acest model ușor este conceput pentru programarea în pereche direct în editorii de cod. Este semnificativ mai rapid și mai puțin costisitor decât modelele cu scop general. Cu toate acestea, un model precum Grok 4.5 rămâne relevant pentru depanarea complexă și arhitectură.
Fie că utilizați Grok pentru a genera cod, a depana, a documenta sau a revizui codul, principiile de formulare a prompturilor abordate în acest curs se aplică, cu câteva specificități.
Generarea de cod
Promptul minimal (de evitat)
Create a food tracker
Promptul eficient
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
Documentația xAI subliniază acest aspect: specificați căile fișierelor, structura proiectului și dependențele. Excludeți informațiile irelevante.
Depanare (Debugging)
Depanarea este un caz de utilizare în care contextul este deosebit de important. Furnizați modelului toate informațiile necesare pentru a reproduce problema.
Prompt structurat pentru depanare
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.
### Eroare cu urmă de stivă (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.
## Documentare
### Documentarea funcțiilor
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)
### Documentarea API-ului
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
## Revizuirea codului (Code Review)
Review the code in this pull request.
Code: [paste the code]
Evaluation criteria:
- Potential bugs or unhandled edge cases
- Performance (algorithmic complexity, N+1 queries)
- Security (injections, data leaks)
- Readability and maintainability
- Adherence to PEP 8 conventions
For each issue found:
- Line(s) concerned
- Severity: critical / high / low / suggestion
- Explanation of the problem
- Proposed corrected code
## Selectarea modelului pentru cod
Documentația xAI recomandă:
- **grok-build-0.1**: Lucru rapid, implementare, căutare în cod, refactorizare de rutină
- **Grok 4.5**: Depanare complexă, arhitectură, probleme conceptuale profunde
Pentru agenții de cod care utilizează apeluri de instrumente (tool-calling), preferați apelurile native de instrumente ale grok-build-0.1 în detrimentul ieșirilor XML, care pot degrada performanța.
## Optimizarea cache-ului
Pentru interacțiunile secvențiale (tipice programării în pereche), cache-ul Grok accelerează semnificativ răspunsurile. Prefixul conversației rămâne identic între cereri, permițând recuperarea din cache.
Sfat important: Evitați modificarea istoricului prompturilor între cereri. Orice modificare întrerupe cache-ul și încetinește inferența.
## Exercițiu practic
Luați o eroare reală din codul dumneavoastră. Scrieți un prompt structurat pentru depanare care să includă codul, eroarea, contextul tehnic și fișierele conexe. Comparați calitatea răspunsului cu cea obținută printr-un prompt minimal („repară acest bug: [cod]“).
## Puncte cheie
- Specificați întotdeauna contextul tehnic complet: limbaj, framework, versiuni, structura proiectului
- grok-build-0.1 este optimizat pentru cod: mai rapid și mai ieftin decât modelele cu scop general
- Pentru depanare, furnizați codul, eroarea completă și contextul de execuție
- Utilizați apelurile native de instrumente în locul ieșirilor XML pentru agenții de cod
- Evitați modificarea istoricului prompturilor pentru a menține cache-ul și viteza
- Grok 4.5 rămâne cea mai bună alegere pentru depanarea complexă și deciziile de arhitectură