Kehotekehotteet API-agentteja varten
Tällä sivulla
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.