Kods un tehniskie uzdevumi
Šajā lapā
Grok izstrādātājiem
xAI piedāvā modeli, kas īpaši optimizēts kodam: grok-build-0.1 (Grok Build). Šis vieglais modelis ir paredzēts pāra programmēšanai koda redaktoros. Tas ir ievērojami ātrāks un lētāks nekā vispārējas nozīmes modeļi. Tomēr tāds modelis kā Grok 4.5 joprojām ir aktuāls sarežģītai atkļūdošanai un arhitektūrai.
Neatkarīgi no tā, vai izmanto Grok koda ģenerēšanai, atkļūdošanai, dokumentēšanai vai koda pārskatīšanai, šajā kursā apskatītie uzvedņu (prompt) principi ir spēkā ar dažām specifiskām niansēm.
Koda ģenerēšana
Minimālā uzvedne (izvairies no šīs)
Create a food tracker
Efektīvā uzvedne
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
xAI dokumentācija uzsver šo punktu: norādi failu ceļus, projekta struktūru un atkarības. Izslēdz nevajadzīgu informāciju.
Atkļūdošana
Atkļūdošana ir lietojuma gadījums, kur konteksts ir īpaši svarīgs. Nodrošini modelim visu informāciju, kas nepieciešama problēmas reproducēšanai.
Strukturēta atkļūdošanas uzvedne
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.
Kļūda ar steka izdruku (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.
Dokumentēšana
Funkcijas dokumentēšana
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)
API dokumentēšana
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
Koda pārskatīšana
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
Modeļa izvēle kodam
xAI dokumentācija iesaka:
- grok-build-0.1: Ātrs darbs, implementācija, koda meklēšana, rutīnas refaktorings
- Grok 4.5: Sarežģīta atkļūdošana, arhitektūra, dziļas konceptuālas problēmas
Koda aģentiem, kas izmanto rīku izsaukumus (tool-calling), dod priekšroku grok-build-0.1 natīvajai rīku izsaukumu funkcionalitātei, nevis XML izvadei, kas var pasliktināt veiktspēju.
Kešatmiņas optimizācija
Secīgām mijiedarbībām (kas raksturīgas pāra programmēšanai) Grok kešatmiņa ievērojami paātrina atbildes. Sarunas prefikss starp pieprasījumiem paliek nemainīgs, ļaujot to izgūt no kešatmiņas.
Svarīgs padoms: izvairies modificēt uzvedņu vēsturi starp pieprasījumiem. Jebkuras izmaiņas iznīcina kešatmiņu un palēnina secinājumus.
Praktiskais uzdevums
Paņem reālu kļūdu no sava koda. Uzraksti strukturētu atkļūdošanas uzvedni, iekļaujot kodu, kļūdas ziņojumu, tehnisko kontekstu un saistītos failus. Salīdzini atbildes kvalitāti ar minimālu uzvedni („salabo šo kļūdu: [kods]”).
Galvenās atziņas
- Vienmēr norādi pilnu tehnisko kontekstu: valodu, ietvaru, versijas, projekta struktūru
- grok-build-0.1 ir optimizēts kodam: ātrāks un lētāks nekā vispārējas nozīmes modeļi
- Atkļūdošanai nodrošini kodu, pilnu kļūdas ziņojumu un izpildes kontekstu
- Koda aģentiem izmanto natīvos rīku izsaukumus, nevis XML izvadi
- Izvairies modificēt uzvedņu vēsturi, lai saglabātu kešatmiņu un ātrdarbību
- Grok 4.5 joprojām ir labākā izvēle sarežģītai atkļūdošanai un arhitektūras lēmumiem