Премини към основното съдържание
Български— Изберете език
Меню

Код и технически задачи

Урок 12 от 14 Обновен 28 юли 2026 г. Начинаещ
На тази страница
  1. Grok за разработчици
  2. Генериране на код
  3. Отстраняване на грешки (Debugging)

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:

  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

## Избор на модел за код

Документацията на xAI препоръчва:

- **grok-build-0.1**: Бърза работа, имплементация, търсене на код, рутинно рефакториране
- **Grok 4.5**: Сложно отстраняване на грешки, архитектура, дълбоки концептуални проблеми

За агенти за код, използващи извикване на инструменти (tool-calling), предпочитайте собственото извикване на инструменти на grok-build-0.1 пред XML изходите, които могат да влошат производителността.

## Оптимизация на кеша

За последователни взаимодействия (типични за двойното програмиране), кешът на Grok значително ускорява отговорите. Префиксът на разговора остава идентичен между заявките, което позволява извличане от кеша.

Важен съвет: Избягвайте промяна на историята на подканите между заявките. Всяка промяна нарушава кеша и забавя извеждането.

## Практическо упражнение

Вземете реална грешка от вашия код. Напишете структурирана подкана за отстраняване на грешки, включваща кода, грешката, техническия контекст и свързаните файлове. Сравнете качеството на отговора с минимална подкана („поправи тази грешка: [код]“).

## Ключови изводи

- Винаги посочвайте пълния технически контекст: език, рамка, версии, структура на проекта
- grok-build-0.1 е оптимизиран за код: по-бърз и по-евтин от моделите с общо предназначение
- За отстраняване на грешки предоставете кода, пълната грешка и контекста на изпълнение
- Използвайте собственото извикване на инструменти вместо XML изходи за агенти за код
- Избягвайте промяна на историята на подканите, за да запазите кеша и скоростта
- Grok 4.5 остава най-добрият избор за сложно отстраняване на грешки и архитектурни решения