Doradztwo inżynierskie

Doradztwo OpenAI Codex dla repozytoriów i zespołów

Dla zespołów, które wdrażają OpenAI Codex we własnym kodzie. Doprowadzamy repozytorium do stanu, w którym agent potrafi je zbudować i przetestować, ustalamy sandbox, zatwierdzanie i konta z osobami, które za nie odpowiadają, i pracujemy z twoimi inżynierami na prawdziwych zadaniach z backlogu. Zakres wynika z twojego problemu.

Omów swoją konfigurację

Przygotowanie repozytorium

Agent, który nie potrafi uruchomić builda ani testów, zostawia całą weryfikację recenzentowi. Dlatego pierwszy etap jest mało efektowny: sprawdzamy, co faktycznie działa na świeżym checkoucie w sandboxie, łącznie z tym, co zwykle zależy od maszyny programisty, czyli prywatnymi rejestrami, lokalnymi usługami, poświadczeniami i kodem generowanym.

Repozytoria różnią się tym, ile z tego już mają. Zaczynamy tam, gdzie różnica między zielonym przebiegiem lokalnym a zielonym przebiegiem agenta jest największa.

  • Polecenia budowania, testów i lintera, które działają na świeżym checkoucie i są zapisane w AGENTS.md
  • Instrukcje opisujące strukturę, konwencje i definicję ukończenia, na tyle krótkie, że agent nadal się ich trzyma
  • Zestaw testów na tyle szybki i deterministyczny, żeby uruchamiać go w każdej iteracji, z wyraźnie oznaczonymi testami wolnymi i niestabilnymi
  • Ścieżki, których agent nie rusza: kod generowany, zależności trzymane w repozytorium, migracje, infrastruktura

Sandbox, zatwierdzanie i miejsce uruchomienia

W konfiguracji lokalnej CLI pracuje na checkoucie na maszynie danego inżyniera, na jego koncie, w ramach sandboxa i zasad zatwierdzania, które konfigurujesz. Agent w chmurze pracuje na klonie w środowisku utrzymywanym przez OpenAI, z własnymi krokami konfiguracji, sekretami i regułami sieciowymi. Rozszerzenie IDE i aplikację desktopową można podłączyć na różne sposoby, więc to, gdzie faktycznie pracują, ustalamy dla konkretnej konfiguracji, zamiast to zakładać. Zasady napisane dla jednego wariantu nie przenoszą się na drugi, więc zakres każdego, którego chcesz używać, ustalamy osobno.

To, dokąd trafiają prompty i kontekst repozytorium, zależy od faktycznie skonfigurowanego dostawcy: mogą to być modele OpenAI albo, jeśli CLI jest tak ustawione, inny dostawca lub model uruchomiony lokalnie. Lokalne uruchomienie samo w sobie nie oznacza, że nic nie opuszcza maszyny. To, co jest wysyłane, z jakiego konta i jak długo przechowywane, zależy od wariantu pracy, konfiguracji i twojej umowy z dostawcą. Dokumentujemy przepływ dla każdego wariantu w takiej postaci, w jakiej jest skonfigurowany, a osoby odpowiedzialne u ciebie za dane i umowy porównują go z tą umową i aktualną dokumentacją dostawcy.

  • Tryb sandboxa i zasady zatwierdzania dla każdego repozytorium: co działa bez pytania, co wymaga zgody, co jest wyłączone
  • Dostęp do sieci z sandboxa oraz, jeśli jest włączony, rejestry i usługi potrzebne do builda
  • Typ konta, dostęp do modeli i to, kto nimi zarządza
  • Wspólne ustawienia w wersjonowanej konfiguracji zamiast domyślnych wartości na poszczególnych laptopach
  • Zakres repozytoriów i danych ustalony przed pilotażem

Od pracy interaktywnej do uruchomień bez nadzoru

Pilotaż prowadzimy interaktywnie: mała grupa, kilka reprezentatywnych zadań, zwykłe code review i wymagane kontrole. Pokazuje on, które rodzaje zadań w tym repozytorium wracają w stanie nadającym się do scalenia, a które kosztują w review więcej, niż oszczędzają przy pisaniu.

Uruchomienia nieinteraktywne, w CI albo jako zadania w chmurze, to osobna decyzja, bo zawodzą w inny sposób: nikt nie patrzy, gdy przebieg zaczyna iść w złą stronę. Proponujemy je dla wąskich, dobrze opisanych prac, przy których kontrole poza agentem wychwycą złą zmianę, a o pushach i scalaniu decyduje kod pipeline'u, nie agent. Poświadczenia dostępne w takim przebiegu są ograniczone do tego jednego zadania.

  • Najpierw praca interaktywna, na zadaniach, których wynik recenzent przeczyta za jednym podejściem
  • Uruchomienia bez nadzoru tylko za testami i review, których agent nie może zmienić
  • Nakład pracy w review mierzony obok przepustowości: poprawki, wycofania i uwagi z review według zespołu, zadania i modelu, bez oceniania poszczególnych osób

Przygotowanie zespołu i przekazanie

Z zespołem pracujemy w twoich repozytoriach, na zadaniach z backlogu. Sesje skupiają się na decyzjach, które wymagają wprawy: jak pociąć zadanie, żeby diff dało się przejrzeć, jaki kontekst podać, a co zostawić w AGENTS.md, kiedy przebieg odjechał na tyle, że taniej zacząć od nowa, niż dalej go korygować, i jak recenzować zmianę, której się samemu nie pisało. Zespoły, które korzystają też z agenta w chmurze, ćwiczą delegowanie osobno, bo review pull requesta z przebiegu, którego nikt nie obserwował, to inna praca niż review diffa, którym się samemu sterowało. Na koniec zespół ustala konwencje dla plików z instrukcjami i review, żeby konfiguracja nie zależała od tego, kto ją ustawiał.

Twój zespół zachowuje pliki z instrukcjami, konfigurację sandboxa i zatwierdzania, runbooki oraz pomiary porównawcze z pilotażu. Powody każdej decyzji są spisane, żeby twoi inżynierowie mogli zmieniać konfigurację bez nas.

Pytania

Używamy już Claude Code albo Cursor. Czy Codex oznacza utrzymywanie drugiego zestawu instrukcji?

Częściowo. AGENTS.md czyta Codex i kilka innych narzędzi, więc polecenia budowania i konwencje mogą być w jednym miejscu. Jeśli narzędzie ma własny plik, zwykle może on odsyłać do wspólnego. Uprawnienia, sandbox i dostęp do narzędzi konfiguruje się natomiast osobno w każdym narzędziu i nie da się ich przenieść jeden do jednego. Część wspólną utrzymujemy jako wspólną, a część specyficzną dla narzędzia dokumentujemy. Jeśli chcesz wiedzieć, które narzędzie lepiej radzi sobie z twoimi zadaniami, metodę dają ewaluacje na repozytoriach.

Ile kosztuje Codex w pracy zespołu?

To zależy od faktycznego sposobu rozliczenia: użycie w ramach planu ChatGPT, dodatkowe kredyty, rozliczenie tokenowe w przestrzeni Enterprise, użycie na własnym kluczu API albo połączenie tych wariantów. Podział bierzemy z twoich faktur i danych o zużyciu i odnosimy go do zaakceptowanych zmian, tak jak opisuje to optymalizacja kosztów LLM. Sposób rozliczenia wpływa też na sposób pracy: zespół, który po południu wyczerpuje pulę z planu, pracuje inaczej niż zespół rozliczany według zużycia.

Czy możemy zamówić samo szkolenie z Codex?

Tak, jeśli agent potrafi już niezawodnie zbudować i przetestować repozytorium. Najpierw to sprawdzamy, bo w repozytorium, w którym agent nie może zweryfikować własnej pracy, uczestnicy uczą się głównie obejść.

Powiązane usługi

Harness engineering dla agentów programistycznych

O tym, jak agent programistyczny zachowuje się w twoim repozytorium, w dużej mierze decyduje harness: co agent wie, co może uruchomić i do czego ma dostęp oraz jakie kontrole przechodzi jego wynik, zanim zobaczy go człowiek. Rozwijamy to programowe środowisko uruchomieniowe razem z twoim zespołem, żeby agent pracował z twoim procesem budowania, testami i code review.

Omów swoją konfigurację

Jeszcze nie używasz agentów programistycznych albo chcesz omówić, jak twój zespół korzysta z nich teraz? Napisz krótko o zespole, repozytoriach, narzędziach i problemie, nad którym pracujesz.

Otwórz szkic e-maila

Otwiera szkic w twoim programie pocztowym. Wysyłasz go sam, a strona nie może potwierdzić dostarczenia.

Bezpłatny przegląd zużycia

Wyślij dane o zużyciu z jednego miesiąca, a dostaniesz bezpłatnie jednostronicowe zestawienie wydatków.

Bezpłatny przegląd zużycia