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

Системни подкани за API агенти

Урок 14 от 14 Обновен 29 юли 2026 г. Програмист
На тази страница
  1. Изграждане на агенти с grok-build-0.1
  2. Анатомия на една добра системна подкана
  3. Структуриране с Markdown или XML
  4. Оптимизация на кеша
  5. Пълен пример: Агент за генериране на тестове
  6. Ключови изводи
  7. Проверете знанията си

Изграждане на агенти с grok-build-0.1

Ако разработвате собствени инструменти за разработка – агент за преглед на код, асистент за внедряване или инструмент за генериране на документация – ще взаимодействате директно с xAI API. Системната подкана е Вашият основен лост за контрол на поведението на модела.

Анатомия на една добра системна подкана

Ефективната системна подкана за агент, базиран на grok-build-0.1, съдържа четири раздела:

1. Описание на задачата

Започнете с ясно дефиниране на това какво прави агентът:

## Роля
Вие сте асистент за преглед на код, специализиран в TypeScript.
Вие анализирате разлики в кода, за да идентифицирате потенциални грешки,
проблеми с производителността и нарушения на конвенциите.

2. Очаквания и формат на изхода

Опишете какво очаквате от модела:

## Формат на изхода
За всеки идентифициран проблем предоставете:
- Файлът и редът, които са засегнати
- Сериозност (критично, предупреждение, информация)
- Описание на проблема
- Предложение за корекция с пример за код

3. Специфични случаи

Предвидете двусмислени ситуации:

## Специфични случаи
- Ако разликата в кода е празна, отговорете "Няма промени за анализ"
- Ако кодът е на неподдържан език, посочете го
- Не коментирайте промени във форматирането (интервали, отстъпи)
- Игнорирайте генерирани конфигурационни файлове (.lock, dist/)

4. Ограничения

Дефинирайте лимитите:

## Ограничения
- Максимум 10 коментара на преглед
- Приоритизирайте критичните грешки пред предложенията за стил
- Не предлагайте мащабно рефакториране за малки поправки

Структуриране с Markdown или XML

Моделът е свикнал да вижда значителен, структуриран контекст в първата подкана. Два формата работят добре:

Markdown (Препоръчително за четимост)

## Роля
Описание на ролята...

## Налични инструменти
- read_file: прочитане на проектен файл
- write_file: модифициране на файл
- run_command: изпълнение на терминална команда

## Правила
1. Винаги четете файла, преди да го модифицирате
2. Искайте потвърждение преди изтриване на код
3. Стартирайте тестовете след всяка модификация

XML (Препоръчително за прецизност)

<agent>
  <role>Асистент за преглед на TypeScript код</role>
  <tools>
    <tool name="read_file">Прочитане на проектен файл</tool>
    <tool name="write_file">Модифициране на файл</tool>
  </tools>
  <rules>
    <rule>Винаги четете файла, преди да го модифицирате</rule>
    <rule>Искайте потвърждение преди изтриване на код</rule>
  </rules>
</agent>

И двата формата са ефективни. Markdown е по-лесен за поддръжка; XML е по-структуриран за автоматично анализиране.

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

Спомнете си урока за кеширането: системната подкана трябва да бъде стабилна. Напишете я веднъж, изцяло, и не я променяйте по време на сесията. Ако трябва да промените поведението на агента, добавете инструкции в потребителското съобщение, вместо да модифицирате системната подкана.

Пълен пример: Агент за генериране на тестове

## Роля
Вие сте агент, който генерира модулни тестове за TypeScript код.
Използвате Vitest като тестова рамка.

## Процес
1. Прочетете изходния файл с read_file
2. Идентифицирайте експортираните функции
3. За всяка функция генерирайте тестове, обхващащи:
   - Номиналния случай
   - Специфични случаи (null, undefined, празен масив)
   - Случаи с грешки
4. Запишете тестовете с write_file в папката __tests__/
5. Стартирайте тестовете с run_command("npx vitest run")

## Конвенции
- Именуване: {file}.test.ts
- Структура: describe > it > expect
- Използвайте фикстури за сложни данни
- Мокирайте външни зависимости (API, DB)

## Ограничения
- Не модифицирайте изходния код
- Ако тест се провали, поправете теста, а не изходния код
- Максимум 20 теста на файл

Тази системна подкана предоставя на агента цялата необходима информация за автономна работа, като същевременно остава в рамките на дефинираните ограничения.

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

  • Системната подкана структурира поведението на агента в 4 части: роля, очаквания, специфични случаи, ограничения
  • Използвайте Markdown или XML за структуриране на разделите
  • Системната подкана трябва да бъде стабилна, за да се оптимизира кеширането
  • Включете процеси стъпка по стъпка за последователни агенти
  • Винаги дефинирайте специфични случаи, за да избегнете неочаквани поведения

Проверете знанията си

grok-build във Вашите редактори: поемане на пълен контрол.

1. Какво е grok-build-0.1?

Отговор: Агентският код модел на xAI: нативно извикване на инструменти, потоково разсъждение, контекст, адаптиран за задачи по разработка – двигателят зад Grok Build и интеграциите с редактори.

2. Как да го използвате във Вашия редактор?

Отговор: Чрез интеграции: Cline във VS Code, Cursor, GitHub Copilot, Windsurf и други – съвместимото с OpenAI xAI API прави директната интеграция възможна.

3. Кои навици осигуряват добри задачи за код?

Отговор: Посочете контекста (файлове, ограничения), дефинирайте ясни и проверими цели, итерирайте прогресивно – и оптимизирайте кеширането, като поддържате префиксите стабилни.

4. grok-build-0.1 или grok-4.5 за код?

Отговор: grok-build за ежедневни агентски задачи по разработка (бърз, специализиран); grok-4.5, когато задачата изисква максимално разсъждение – изборът следва трудността.

5. Какво влиза в системната подкана на API код агент?

Отговор: Ролята, конвенциите на проекта, правилата за редактиране (тестове, стил) и лимитите – рамкирането, което превръща кодовия модел в съотборник за Вашата кодова база.

Специализиран модел, свързан редактор, чисти задачи, рамкирани подкани: разработването с помощта на Grok се свежда до четири избора – всички направени умишлено.