Skip to content

Service Writer ​

Con il dataset Prompt service-writer, l'Agente OpenCode crea servizi ALIDA partendo da una descrizione. Scrive il codice, il meta-model, il manuale e i test, poi apre una merge request su GitLab.

Provalo ​

  1. Completa l'avvio rapido di OpenCode, collegando service-writer a input-dataset-4. Qui GITLAB_TOKEN e GITLAB_GROUP sono necessari.
  2. Descrivi cosa vuoi, per esempio: "Crea un servizio che rimuove le righe con valori vuoti da un dataset CSV."
  3. Concorda un nome breve con l'agente. Creerà il repository bda-BDAID-NAME, per esempio bda-42-clean-rows.
  4. Attendi che l'agente riporti il risultato, poi rivedi la merge request.

Il merge spetta a te

L'agente non fa mai il merge. Il merge in develop compila l'immagine e registra il servizio su ALIDA.

Cosa ottieni ​

L'agente fa push del branch feat/<service-name>, attende la pipeline di test (fino a circa 20 minuti) e riporta uno di questi risultati:

RisultatoSignificato
PASSEDLa merge request verso develop è aperta.
FAILEDL'agente prova a correggere il servizio al massimo due volte, senza indebolire i test. Se fallisce ancora, riporta l'ultimo log e si ferma.
PENDINGIl commit è stato inviato ma non c'è ancora un risultato. L'agente lo segnala e si ferma.

Modificare un servizio esistente ​

Chiedi la modifica nella stessa sessione, oppure imposta GIT_URL sul repository prima di avviare il workflow. L'agente incrementa la versione e apre una nuova merge request. Un nuovo servizio parte da 1.0.0; correggere una propria pipeline fallita non cambia la versione.

Il nome completo del servizio può avere al massimo 30 caratteri. Per test realistici, collega file di esempio come dataset senza categoria: saranno disponibili in /workspace/data.

Regole del meta-model ​

L'agente controlla queste regole prima di ogni commit e rifiuta di consegnare un servizio che le viola.

Mostra le regole
  • name, version, description, accessLevel, url, properties e markDown sono obbligatori e non vuoti; markDown ha un value.
  • name usa lettere minuscole, cifre e trattini, inizia con una lettera, non termina con un trattino e ha al massimo 30 caratteri.
  • Ogni proprietà ha una key univoca e non vuota.
  • valueType è uno tra STRING, BOOLEAN, DOUBLE, JSON: usa DOUBLE per qualsiasi numero. Solo le proprietà resource possono non avere valueType.
  • Nessuna chiave di proprietà inizia con go_manager.
  • Nessun testo con forma di tag HTML nelle descrizioni.
  • Al massimo una proprietà ha inputData: true e al massimo una ha outputData: true.
  • src/arguments.py ha un argomento per ogni proprietà, tranne assets e le proprietà di tipo static o resource.
  • Gli argomenti BOOLEAN usano type=str2bool e arguments.py definisce str2bool; gli argomenti DOUBLE usano type=float o type=int.