Koda in tehnične naloge
Na tej strani
Grok za razvijalce
xAI ponuja model, posebej optimiziran za kodo: grok-build-0.1 (Grok Build). Ta lahek model je zasnovan za parno programiranje v urejevalnikih kode. Je bistveno hitrejši in cenejši od splošnih modelov. Vendar pa model, kot je Grok 4.5, ostaja relevanten za kompleksno odpravljanje napak in arhitekturo.
Ne glede na to, ali uporabljaš Grok za generiranje kode, odpravljanje napak, dokumentacijo ali pregled kode, se načela oblikovanja pozivov, obravnavana v tem tečaju, uporabljajo z nekaj specifikami.
Generiranje kode
Minimalni poziv (izogibaj se temu)
Create a food tracker
Učinkovit poziv
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
Dokumentacija xAI poudarja naslednje: navedi poti do datotek, strukturo projekta in odvisnosti. Izključi nepomembne informacije.
Odpravljanje napak
Odpravljanje napak je primer uporabe, kjer je kontekst še posebej pomemben. Modelu zagotovi vse informacije, potrebne za reprodukcijo težave.
Strukturiran poziv za odpravljanje napak
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.
Napaka s sledjo sklada (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.
Dokumentacija
Dokumentacija funkcije
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)
Dokumentacija API-ja
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
Pregled kode
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
Izbira modela za kodo
Dokumentacija xAI priporoča:
- grok-build-0.1: Hitro delo, implementacija, iskanje kode, rutinsko refaktoriranje
- Grok 4.5: Kompleksno odpravljanje napak, arhitektura, globoki konceptualni problemi
Za agente za kodo, ki uporabljajo klicanje orodij (tool-calling), raje uporabi nativno klicanje orodij modela grok-build-0.1 namesto izhodov XML, ki lahko poslabšajo zmogljivost.
Optimizacija predpomnilnika
Zaporedne interakcije (značilne za parno programiranje) močno pospeši predpomnilnik Groka. Predpona pogovora ostane med zahtevami enaka, kar omogoča priklic iz predpomnilnika.
Pomemben nasvet: Izogibaj se spreminjanju zgodovine pozivov med zahtevami. Vsakršna sprememba prekine predpomnilnik in upočasni sklepanje.
Praktična vaja
Vzemi stvarno napako iz svoje kode. Napiši strukturiran poziv za odpravljanje napak, ki vključuje kodo, napako, tehnični kontekst in povezane datoteke. Primerjaj kakovost odgovora z minimalnim pozivom („popravi to napako: [koda]”).
Ključne ugotovitve
- Vedno navedi popoln tehnični kontekst: jezik, ogrodje, različice, strukturo projekta.
- grok-build-0.1 je optimiziran za kodo: hitrejši in cenejši od splošnih modelov.
- Za odpravljanje napak zagotovi kodo, celotno sporočilo o napaki in izvajalni kontekst.
- Za agente za kodo uporabi nativno klicanje orodij namesto izhodov XML.
- Izogibaj se spreminjanju zgodovine pozivov, da ohraniš predpomnilnik in hitrost.
- Grok 4.5 ostaja najboljša izbira za kompleksno odpravljanje napak in arhitekturne odločitve.