Nasadenie aplikácie s pomocou promptu

Čo funkcia robí

Aktuálny endpoint prompt-to-app spojí písomný brief s existujúcim Git šablónovým repozitárom a zaradí tento repozitár do bežnej immutable app-deployment pipeline. Brief sa uloží ako provenance pre neskoršie iterácie.

Negeneruje nový repozitár aplikácie z briefu. URL šablóny je povinné a prvé nasadenie obsahuje zdroj šablóny v danej revízii, pokiaľ tento zdroj požiadavku už neimplementuje.

Vytvorenie z promptu a šablóny

POST /api/apps/from-prompt
Content-Type: application/json
 
{
  "brief": "A private reading-list app with a health endpoint",
  "template_git_url": "https://github.com/example/reviewed-template.git",
  "branch": "main",
  "visibility": "private"
}

Odpoveď obsahuje trvalé ID aplikácie, nasadenia a buildu plus URL build streamu. Vytvorenie je asynchrónne. Sledujte záznam nasadenia alebo build stream, kým nedosiahne terminálny stav; neposielajte duplicitné nasadenie len preto, že priebeh dlho nič nehlási.

Pred odoslaním požiadavky:

• skontrolujte repozitár a jeho licenciu;
• pripnite alebo zaznamenajte presnú zdrojovú revíziu, ktorú nasadenie použije;
• overte správanie inštalácie, buildu, behu, portu a health checku; a
• držte secrets mimo promptu aj repozitára.

Prompt je kontext, nie dôkaz, že výsledný zdroj briefu vyhovuje. Otestujte nasadené správanie proti akceptačným kritériám odvodeným z briefu.

Požiadavka na neskoršiu zmenu

POST /api/apps/{app_id}/iterate
Content-Type: application/json
 
{
  "instruction": "Add an authenticated export endpoint and a regression test"
}

Tým sa pre aplikáciu, ktorú vlastníte a ktorá má Git zdroj, spustí asynchrónna úloha repair agenta. Dopytujte:

GET /api/apps/{app_id}/agent-status?thread_id={thread_id}

Odpoveď statusu spája najnovší stav nasadenia so stavom iteration threadu a prípadnými hlásenými dôkazmi výsledku.

Dôležitá hranica iterácie

Aktuálna repair cesta môže pracovať vo svojom sandboxe a požiadať o nové nasadenie, ale persistenciu späť do Git repozitára vývojára zatiaľ nemožno považovať za garantovanú fázu. done agent thread teda sám o sebe nepreukazuje, že:

• požadovaná zmena je v upstream repozitári;
• bol zostavený konkrétny commit;
• testy prešli;
• nové nasadenie sa stalo aktívnym; alebo
• dá sa obnoviť staré nasadenie.

Pri každej iterácii samostatne zaznamenajte upstream commit, deployment ID, build ID, výsledok health checku a dôkazy akceptačných testov. Ak upstream repozitár nebol aktualizovaný, uchovajte patch operátorom schváleným source-control workflow, kým na zmenu spoliehate.

Bezpečná akceptačná sekvencia

1. Preveďte brief na pozorovateľné akceptačné kritériá.
2. Skontrolujte vybranú šablónu a presnú revíziu.
3. Zaradte jedno nasadenie a sledujte jeho trvalé ID.
4. Potvrďte build, health check kandidáta a prepnutie trasy zvlášť.
5. Overte akceptačné kritériá proti nasadenej URL.
6. Potvrďte, že zdrojový commit existuje v repozitári, ktorý ovládate.
7. Ponechajte dôkazy a cieľ pre rollback.

Pozrite App deployment pre immutable fázy nasadenia a spracovanie chýb.