Il-Kodiċi u l-Kompiti Tekniċi
Grok għall-Iżviluppaturi
xAI toffri mudell ottimizzat speċifikament għall-kodiċi: grok-build-0.1 (Grok Build). Dan il-mudell ħafif huwa ddisinjat għall-programmazzjoni f’par (pair programming) fl-edituri tal-kodiċi. Huwa ferm aktar mgħaġġel u inqas għali mill-mudelli għal skopijiet ġenerali. Madankollu, mudell bħal Grok 4.5 jibqa’ rilevanti għad-debugging kumpless u l-arkitettura.
Sew jekk tuża Grok biex tiġġenera l-kodiċi, issib l-iżbalji (debug), tiddokumenta, jew tirrevedi l-kodiċi, il-prinċipji tal-prompting koperti f’dan il-kors japplikaw b’xi speċifiċitajiet.
Il-Ġenerazzjoni tal-Kodiċi
Il-Prompt Minimali (Evita Dan)
Create a food tracker
Il-Prompt Effettiv
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
Id-dokumentazzjoni ta’ xAI tenfasizza dan il-punt: speċifika l-mogħdijiet tal-fajls, l-istruttura tal-proġett, u d-dipendenzi. Eskludi informazzjoni mhux rilevanti.
Id-Debugging
Id-debugging huwa każ ta’ użu fejn il-kuntest huwa partikolarment importanti. Ipprovdi lill-mudell bl-informazzjoni kollha meħtieġa biex tirriproduċi l-problema.
Prompt Strutturat għad-Debugging
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.
### Żball bit-Trace tal-Istakk (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.
## Id-Dokumentazzjoni
### Dokumentazzjoni tal-Funzjoni
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)
### Dokumentazzjoni tal-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
## Ir-Reviżjoni tal-Kodiċi
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
## L-Għażla tal-Mudell għall-Kodiċi
Id-dokumentazzjoni ta' xAI tirrakkomanda:
- **grok-build-0.1**: Xogħol mgħaġġel, implimentazzjoni, tfittxija tal-kodiċi, refactoring ta' rutina
- **Grok 4.5**: Debugging kumpless, arkitettura, problemi kunċettwali fondi
Għall-aġenti tal-kodiċi li jużaw is-sejħa tal-għodod (tool-calling), ippreferi s-sejħa nativa tal-għodod ta' grok-build-0.1 fuq l-outputs XML, li jistgħu jnaqqsu l-prestazzjoni.
## L-Ottimizzazzjoni tal-Cache
Għal interazzjonijiet sekwenzjali (tipiċi tal-programmazzjoni f'par), il-cache ta' Grok iħaffef b'mod sinifikanti r-risposti. Il-prefiss tal-konversazzjoni jibqa' identiku bejn it-talbiet, u jippermetti l-irkupru mill-cache.
Parir importanti: Evita li timmodifika l-istorja tal-prompt bejn it-talbiet. Kwalunkwe modifikazzjoni tkisser il-cache u tbaxxi l-veloċità tal-inferenza.
## Prattika Manwali
Ħu żball reali mill-kodiċi tiegħek. Ikteb prompt strutturat għad-debugging li jinkludi l-kodiċi, l-iżball, il-kuntest tekniku, u l-fajls relatati. Qabbel il-kwalità tar-risposta ma' prompt minimali ("fix this bug: [code]").
## Punti Ewlenin
- Dejjem speċifika l-kuntest tekniku sħiħ: lingwa, framework, verżjonijiet, struttura tal-proġett
- grok-build-0.1 huwa ottimizzat għall-kodiċi: aktar mgħaġġel u orħos mill-mudelli għal skopijiet ġenerali
- Għad-debugging, ipprovdi l-kodiċi, l-iżball sħiħ, u l-kuntest ta' eżekuzzjoni
- Uża s-sejħa nativa tal-għodod minflok l-outputs XML għall-aġenti tal-kodiċi
- Evita li timmodifika l-istorja tal-prompt biex iżżomm il-cache u l-veloċità
- Grok 4.5 jibqa' l-aħjar għażla għad-debugging kumpless u d-deċiżjonijiet tal-arkitettura