Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Tavoji pirmoji „Codex“ užduotis

Paskaita 4 iš 20 Atnaujinta 2026 m. lapkričio 3 d. Kūrėjas
Šiame puslapyje
  1. Paleiskite savo pirmąją užduotį
  2. Iš „Codex Cloud“
  3. Iš IDE
  4. Iš CLI
  5. „Codex“ rezultato sandara
  6. Gerų instrukcijų rašymas
  7. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 3 d. pagal „Codex“ komandų nuorodą (CLI 0.166.0): parinktys --show-diff ir --apply neegzistuoja. Vietinėje aplinkoje „Codex“ failus keičia tiesiogiai savo smėlio dėžėje; peržiūrėkite pakeitimus naudodami /diff arba git diff. Plėtinio komanda „Codex: New Task“ pakeista į „Codex: Open Codex Sidebar“. Šaltiniai: Kūrėjo komandos · „Codex“ IDE plėtinys.

Paleiskite savo pirmąją užduotį

Jūsų paskyra sukonfigūruota, „GitHub“ prijungtas, o failas AGENTS.md jau yra: metas pamatyti agentą veikiant. Štai taisyklė visiems lygiams – pradėkite nuo užduoties, kurios teisingą atsakymą jau žinote. Nedaug ko išmoksite stebėdami, kaip „Codex“ sprendžia problemą, kurios negalite įvertinti, tačiau sužinosite nepaprastai daug stebėdami, kaip jis dirba jums pažįstamoje srityje.

Iš „Codex Cloud“

Žiniatinklyje arba darbalaukio programėlėje pasirinkite Work in › Cloud, pasirinkite paskelbtą aplinką savo saugyklai (2 pamoka) ir įveskite savo užduotį į įvesties lauką. Sąmoningai kuklus prašymas puikiai tiks.

Task: "Add a .gitignore file suitable for a Node.js/TypeScript 
       project if one doesn't already exist."

Ši formuluotė apima sąlygą – „jei tokio dar nėra“ – ir būtent tai daro stebėjimą įdomiu. „Codex Cloud“ aplinkoje užduotis vykdoma jūsų paskelbtoje šios saugyklos aplinkoje: „Codex“ patikrina, ar .gitignore egzistuoja, jei taip – įsitikina, kad jame numatyta „Node.js“ ir „TypeScript“, prireikus sukuria arba atnaujina failą, o tada parodo rezultatą kaip skirtumą (diff). Vykdymo žurnalas transliuojamas realiuoju laiku: čia pamatysite, ar agentas laikėsi sąlygos, ar perrašė esamą failą.

Iš IDE

Atidarykite savo projektą „VS Code“ (arba „Cursor“, „Windsurf“) ir paleiskite „Codex“ per jo piktogramą arba komandų paletę:

Ctrl+Shift+P → "Codex: Open Codex Sidebar"

Tada suformuluokite prašymą, kuris išnaudoja vietinį kontekstą nurodydamas konkretų failą:

"Add email validation to the contact form 
 in src/components/ContactForm.tsx"

Plėtinys rodo santrauką ir pakeistas eilutes greta kodo; paliekate norimus pakeitimus ir tame pačiame pokalbyje prašote tolesnių veiksmų. Dokumentacijoje rekomenduojama prieš užduotį ir po jos sukurti „Git“ kontrolinį tašką, kad prireikus galėtumėte grįžti atgal.

Iš CLI

# Navigate to the project directory
cd my-project

# Start a session with an initial instruction
codex "Add a README.md with the project description, installation instructions, and available commands"

Vietinėje aplinkoje „Codex“ failus keičia tiesiogiai jūsų darbo aplanke, laikydamasis smėlio dėžės ir patvirtinimo politikos ribų: prieš imdamasis veiksmų, kuriems reikia leidimo, jis jo prašo. Norėdami peržiūrėti, kas pasikeitė prieš įfiksuojant pakeitimus, sesijoje įveskite /diff: komanda parodys „Git“ skirtumą, įskaitant nesekamus failus. /review prašo „Codex“ peržiūrėti jūsų darbo medį. Skriptiniam naudojimui codex exec vykdo tą pačią užduotį be sąveikos (14 pamoka) – tokiu atveju nuo „Git“ ir jūsų konvejerio priklauso, kas bus palikta.

„Codex“ rezultato sandara

Nepriklausomai nuo įėjimo taško, baigta užduotis visada grąžina tuos pačius keturis elementus. Peržiūrėkite juos šia tvarka: skirtumas nurodo, kas pasikeitė, žurnalas – kodėl, testai – ar tai saugu, o veiksmai grąžina jums kontrolę.

Pateiktas elementasKą jame rasite
Pakeitimų skirtumas (Diff)Kiekviena pridėta, pakeista arba ištrinta eilutė failas po failo
Vykdymo žurnalasVisi veiksmai: skaityti failai, vykdytos komandos, agento samprotavimai
Testų rezultataiJei testų yra, „Codex“ juos paleidžia, kad įsitikintų, jog niekas nesugriauta
Galimi veiksmaiPatvirtinti, modifikuoti, sukurti PR arba paleisti iš naujo su kitomis instrukcijomis

Pradedantieji dažnai nepaiso vykdymo žurnalo, nors būtent jis moko, kaip formuluoti savo užduotis. Matydami, kuriuos failus „Codex“ atidarė prieš priimdamas sprendimą, suprantate, ko jis ieškojo, bet nerado – dažnai tai būna taisyklė, kuri turėjo būti faile AGENTS.md.

Gerų instrukcijų rašymas

Rezultato kokybė tiesiogiai priklauso nuo instrukcijų kokybės, o skirtumas tarp šių dviejų formuluuočių yra daug didesnis nei skirtumas tarp dviejų modelių.

"Improve the code"
"In src/lib/auth.ts, replace manual JWT handling 
with the jose library. Keep the same public interface 
(signToken, verifyToken). Update the corresponding tests."

Antroji versija veikia, nes atsako į keturis klausimus, kuriuos agentas vis tiek sau užduoda. Ji nurodo susijusius failus, taip sutaupydama laiko naršyti ir taikytis į neteisingą vietą. Ji apibrėžia laukiamą rezultatą – elgseną, sąsają, formatą – todėl agentas žino, kada sustoti. Ji nustato apribojimus, šiuo atveju išlaikant viešąją sąsają, kas neleidžia jam „tobulinti“ dalykų sugadinant kviečiančiąją pusę; kitur tai galėtų būti „nenutraukti testų“. O kai rizika tai pateisina, ji prideda verslo kontekstą: nurodymas „tai mokėjimo forma, saugumas yra kritinis“ iš tikrųjų pakeičia jo kompromisus.

Kad tai taptų jūsų nuosavybe, paimkite esamą projektą ir sujunkite tris skirtingo pobūdžio užduotis: analizę be modifikacijų („Išvardykite visus „TypeScript“ failus, neturinčius susijusių testų”); tikslinį generavimą („Sugeneruokite šio failo vienetinį testą“); ribotos apimties taisymą („Ištaisykite „ESLint“ įspėjimus aplanke src/utils/”). Kiekvienai užduočiai užsirašykite, ką reikėjo nurodyti iš anksto: šis apgailestavimų sąrašas yra jūsų pirmasis AGENTS.md juodraštis.

Svarbiausi punktai

  • Savo pirmąsias užduotis pradėkite nuo paprastų, tikslinių prašymų
  • „Codex“ kiekvienai užduočiai pateikia išsamų vykdymo žurnalą
  • Rezultato kokybė priklauso nuo jūsų instrukcijų tikslumo
  • Jūs visada išlaikote kontrolę: patvirtinkite, modifikuokite arba atmesti
  • Pradėkite nuo mažos rizikos užduočių, prieš pereidami prie kritinių pakeitimų