Salt la conținutul principal
Română— Alege o limbă
Meniu

Cod și sarcini tehnice

Lecția 12 din 14 Actualizată 28 iulie 2026 Începător
Pe această pagină
  1. Grok pentru dezvoltatori
  2. Generarea de cod
  3. Depanare (Debugging)

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:

  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

## 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ă