Код и технически задачи
Grok за разработчици
xAI предлага модел, оптимизиран специално за код: grok-build-0.1 (Grok Build). Този лек модел е проектиран за двойно програмиране в редактори за код. Той е значително по-бърз и по-евтин от моделите с общо предназначение. Въпреки това, модел като Grok 4.5 остава актуален за сложно отстраняване на грешки и архитектура.
Независимо дали използвате Grok за генериране на код, отстраняване на грешки, документиране или преглед на код, принципите за създаване на подкани, разгледани в този курс, важат с няколко специфични особености.
Генериране на код
Минималната подкана (Избягвайте това)
Create a food tracker
Ефективната подкана
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 подчертава този момент: посочете пътищата до файловете, структурата на проекта и зависимостите. Изключете информацията, която не е от значение.
Отстраняване на грешки (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.
### Грешка със стек трейс (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.
## Документиране
### Документиране на функция
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
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
## Преглед на код (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
## Избор на модел за код
Документацията на xAI препоръчва:
- **grok-build-0.1**: Бърза работа, имплементация, търсене на код, рутинно рефакториране
- **Grok 4.5**: Сложно отстраняване на грешки, архитектура, дълбоки концептуални проблеми
За агенти за код, използващи извикване на инструменти (tool-calling), предпочитайте собственото извикване на инструменти на grok-build-0.1 пред XML изходите, които могат да влошат производителността.
## Оптимизация на кеша
За последователни взаимодействия (типични за двойното програмиране), кешът на Grok значително ускорява отговорите. Префиксът на разговора остава идентичен между заявките, което позволява извличане от кеша.
Важен съвет: Избягвайте промяна на историята на подканите между заявките. Всяка промяна нарушава кеша и забавя извеждането.
## Практическо упражнение
Вземете реална грешка от вашия код. Напишете структурирана подкана за отстраняване на грешки, включваща кода, грешката, техническия контекст и свързаните файлове. Сравнете качеството на отговора с минимална подкана („поправи тази грешка: [код]“).
## Ключови изводи
- Винаги посочвайте пълния технически контекст: език, рамка, версии, структура на проекта
- grok-build-0.1 е оптимизиран за код: по-бърз и по-евтин от моделите с общо предназначение
- За отстраняване на грешки предоставете кода, пълната грешка и контекста на изпълнение
- Използвайте собственото извикване на инструменти вместо XML изходи за агенти за код
- Избягвайте промяна на историята на подканите, за да запазите кеша и скоростта
- Grok 4.5 остава най-добрият избор за сложно отстраняване на грешки и архитектурни решения