Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Kehotekehotteet API-agentteja varten

Oppitunti 14 / 14 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Agenttien rakentaminen grok-build-0.1:llä
  2. Hyvän kehotekehotteen anatomia
  3. Rakenne Markdownilla tai XML:llä
  4. Välimuistin optimointi
  5. Täydellinen esimerkki: testigenerointiagentti
  6. Keskeiset asiat
  7. Testaa tietämyksesi

Agenttien rakentaminen grok-build-0.1:llä

Jos kehität omia kehitystyökalujasi – kuten koodinkatsausagenttia, käyttöönottoavustajaa tai dokumentaatiogeneraattoria – olet suorassa vuorovaikutuksessa xAI:n API:n kanssa. Kehotekehoite on ensisijainen vipuvarsi mallin käyttäytymisen ohjaamiseen.

Hyvän kehotekehotteen anatomia

Tehokas kehotekehoite grok-build-0.1:een perustuvalle agentille sisältää neljä osiota:

1. Tehtävänkuvaus

Aloita määrittelemällä selkeästi, mitä agentti tekee:

## Role
You are a code review assistant specialized in TypeScript.
You analyze code diffs to identify potential bugs,
performance issues, and convention violations.

2. Odotukset ja tulosteen muotoilu

Kuvaile, mitä odotat mallilta:

## Output Format
For each identified issue, provide:
- The file and line involved
- Severity (critical, warning, info)
- A description of the issue
- A correction suggestion with a code example

3. Reunatapaukset

Ennakoi epäselvät tilanteet:

## Edge Cases
- If the diff is empty, respond "No changes to analyze"
- If the code is in an unsupported language, indicate it
- Do not comment on formatting changes (spaces, indentation)
- Ignore generated config files (.lock, dist/)

4. Rajoitteet

Määrittele rajat:

## Constraints
- Maximum 10 comments per review
- Prioritize critical bugs over style suggestions
- Do not suggest major refactoring for minor fixes

Rakenne Markdownilla tai XML:llä

Malli on tottunut näkemään laajaa, jäsenneltyä kontekstia ensimmäisessä kehotteessa. Kaksi muotoilua toimii hyvin:

Markdown (suositeltu luettavuuden vuoksi)

## Role
Role description...

## Available Tools
- read_file: read a project file
- write_file: modify a file
- run_command: execute a terminal command

## Rules
1. Always read the file before modifying it
2. Ask for confirmation before deleting code
3. Run tests after each modification

XML (suositeltu tarkkuuden vuoksi)

<agent>
  <role>TypeScript code review assistant</role>
  <tools>
    <tool name="read_file">Read a project file</tool>
    <tool name="write_file">Modify a file</tool>
  </tools>
  <rules>
    <rule>Always read the file before modifying it</rule>
    <rule>Ask for confirmation before deleting code</rule>
  </rules>
</agent>

Molemmat muodot ovat tehokkaita. Markdownia on helpompi ylläpitää; XML on jäsennellympi automaattista jäsentämistä varten.

Välimuistin optimointi

Muista välimuistitunti: kehotekehoitteen on oltava vakaa. Kirjoita se kerran kokonaisuudessaan äläkä muuta sitä istunnon aikana. Jos tarvitset agentin käyttäytymisen muutosta, lisää ohjeet käyttäjäviestiin kehotekehotteen muuttamisen sijaan.

Täydellinen esimerkki: testigenerointiagentti

## Role
You are an agent that generates unit tests for TypeScript code.
You use Vitest as the testing framework.

## Process
1. Read the source file with read_file
2. Identify exported functions
3. For each function, generate tests covering:
   - The nominal case
   - Edge cases (null, undefined, empty array)
   - Error cases
4. Write tests with write_file in the __tests__/ folder
5. Run tests with run_command("npx vitest run")

## Conventions
- Naming: {file}.test.ts
- Structure: describe > it > expect
- Use fixtures for complex data
- Mock external dependencies (API, DB)

## Constraints
- Do not modify source code
- If a test fails, fix the test, not the source code
- Maximum 20 tests per file

Tämä kehotekehoite antaa agentille kaikki tarvittavat tiedot toimia itsenäisesti pysyen samalla määriteltyjen rajojen sisällä.

Keskeiset asiat

  • Kehotekehoite jäsentelee agentin käyttäytymisen neljään osaan: rooli, odotukset, reunatapaukset, rajoitteet
  • Käytä Markdownia tai XML:ää osioiden jäsentelemiseen
  • Kehotekehoitteen on oltava vakaa välimuistin optimoimiseksi
  • Sisällytä vaiheittaiset prosessit sekventiaalisille agenteille
  • Määrittele aina reunatapaukset odottamattomien käyttäytymisten välttämiseksi

Testaa tietämyksesi

grok-build editoreissasi: lopullinen hallinta.

1. Mikä on grok-build-0.1?

Vastaus: xAI:n agenttinen koodimalli: natiivi työkalukutsu, virtaava päättely, kehitystehtäviin sovitettu konteksti – moottori Grok Buildin ja editori-integraatioiden takana.

2. Miten sitä käytetään editorissa?

Vastaus: Integraatioiden kautta: Cline VS Codessa, Cursor, GitHub Copilot, Windsurf ja muut – OpenAI-yhteensopiva xAI API mahdollistaa suoran integraation.

3. Mitkä tavat varmistavat hyvät kooditehtävät?

Vastaus: Määrittele konteksti (tiedostot, rajoitteet), aseta selkeät ja varmennettavat tavoitteet, iteroiden etenevästi – ja optimoi välimuisti pitämällä etuliitteet vakaina.

4. grok-build-0.1 vai grok-4.5 koodiin?

Vastaus: grok-build jokapäiväisiin kehitysagenttitehtäviin (nopea, erikoistunut); grok-4.5, kun tehtävä vaatii maksimaalista päättelyä – valinta seuraa vaikeusastetta.

5. Mitä API-koodiagentin kehotekehotteeseen kuuluu?

Vastaus: Rooli, projektikäytännöt, muokkaussäännöt (testit, tyyli) ja rajat – kehys, joka muuttaa koodimallin koodikantasi tiimikaveriksi.

Erikoistunut malli, yhdistetty editori, siistit tehtävät, kehystetyt kehotteet: Grok-avusteinen kehitys tiivistyy neljään valintaan – kaikki tehtynä tarkoituksellisesti.