Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

Importare un progetto CrewAI — una crew di due agenti

Le dichiarazioni di agenti e task di un progetto CrewAI nel layout classico — due agenti su un unico modello OpenAI, un task ciascuno — trasformate in bozze di file Aggrega da aggrega import, con l’immagine in cui gira il programma della crew indicata una sola volta in un file di risposte, e compilate per Docker Compose.

Importare un progetto CrewAI lo illustra passo per passo: il comando, cosa chiede, i file che scrive e perché c’è ogni riga, la compilazione e la crew in esecuzione. Questa cartella contiene ogni fase di quella procedura guidata:

cartella o filecosa contiene
source/le dichiarazioni del progetto, src/support_brief/config/agents.yaml e tasks.yaml, il .aggrega-config.yaml che rende la cartella un workspace, e src/support_brief/import-answers.yaml, i valori che nessuna dichiarazione contiene: l’immagine di ogni agente e il nome del Secret Kubernetes da cui una compilazione per Kubernetes legge la chiave OpenAI
draft/i file che aggrega import src/support_brief --target compose ha scritto, invariati, release.lock compreso, e ciò che ha stampato: stdout.txt sullo standard output, import.txt sullo standard error

Le dichiarazioni sono scritte per questo esempio. Il programma della crew non ne fa parte: l’importazione non ne legge mai uno, e la Release indica l’immagine in cui viene eseguito.

In un checkout del repository della documentazione, check.sh esegue di nuovo l’importazione, confronta ciò che scrive e stampa con draft/, confronta i blocchi citati dalla procedura guidata con questi file, e convalida e compila ciò che l’importazione ha scritto. Richiede il catalogo della libreria standard (dove procurarselo) estratto accanto a questo repository, oppure la sua directory indicata in AGGREGA_CATALOG_DIRS.

Generare l’esempio

Puoi eseguire l’importazione di questo esempio con i comandi qui sotto, oppure far sì che il tuo assistente AI la esegua per te.

Scrivi l’esempio in una nuova cartella che porta il suo nome:

Terminal window
aggrega scaffold --example import-crewai

Poi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:

Terminal window
cd import-crewai

Build

L’importazione crea le bozze dei file Aggrega accanto al progetto, in source/. Valuta il progetto rispetto al catalogo della libreria standard, che il registry predefinito del workspace pubblica come snapshot firmato: la prima importazione lo scarica, lo verifica, lo conserva nella cache dei contenuti del workspace e lo indica tramite il suo digest nel record che scrive accanto alle bozze. Un workspace che indica le proprie cartelle di catalogo — in AGGREGA_CATALOG_DIRS, o sotto workspace.catalog_dirs — importa invece rispetto a quelle. L’importazione legge le immagini da src/support_brief/import-answers.yaml, poi scarica ciò da cui dipende la Release in bozza, così la compilazione segue subito:

Terminal window
cd source
aggrega import src/support_brief --target compose
aggrega build --release release.yaml

L’immagine indicata dall’esempio rappresenta una che compili a partire dal tuo progetto; come compilarla ed eseguire lo stack è spiegato nella procedura guidata collegata sopra.

Con un assistente AI

Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.

Usa solo gli strumenti di Aggrega e non creare tu alcuna cartella. Se la cartella dell’area di lavoro non contiene ancora una cartella `import-crewai`, chiama una volta lo strumento `scaffold` con `example` impostato a `import-crewai` e senza `dir`: scrive l’esempio in una nuova cartella `import-crewai`, la cui cartella `source` contiene ciò che questo esempio importa. Poi chiama lo strumento `import` con `workspace_root` impostato a `import-crewai/source`, `source` impostato a `src/support_brief` e `target` impostato a `compose`: legge le risposte di cui ha bisogno da `import-answers.yaml` nella cartella `src/support_brief`, scrive le sue bozze in `import-crewai/source` e scarica ciò di cui hanno bisogno. Poi chiama lo strumento `validate` con `workspace_root` impostato a `import-crewai/source` e `release` impostato a `release.yaml`, e lo strumento `build` con `workspace_root` impostato a `import-crewai/source`, `release` impostato a `release.yaml` e `write` impostato a true. Dimmi quali file ha scritto la build; si trovano in `import-crewai/source/dist/`.

Eseguire il test

Con lo stack in esecuzione come lo esegue la guida, una richiesta raggiunge la crew. La route qui sotto è quella del programma della guida stessa, un piccolo server HTTP sulla porta 8000; il tuo programma decide la propria. La Release pubblica il ricercatore su 127.0.0.1:8000 e il redattore su 127.0.0.1:8001, quindi la richiesta va al ricercatore dalla tua macchina:

Terminal window
curl -sS -X POST http://127.0.0.1:8000/kickoff -H 'Content-Type: application/json' \
-d '{"question": "Which support plan covers a weekend outage, and what does it cost?"}'
{
"error": "the crew failed: AuthenticationError: Error code: 401 - {'error': {'message': 'Incorrect API key provided: sk-place************-key. [… omitted: where to find an API key, and the error's type and code]"
}

La chiave dell’esecuzione era un segnaposto, quindi la risposta è il rifiuto di OpenAI. Su Kubernetes, inoltra una porta locale al Deployment, che non ha alcun Service, e inviagli la stessa richiesta da un altro terminale:

Terminal window
kubectl port-forward deploy/researcher 8000:8000
Terminal window
curl -sS -X POST http://127.0.0.1:8000/kickoff -H 'Content-Type: application/json' \
-d '{"question": "Which support plan covers a weekend outage, and what does it cost?"}'

La risposta è la stessa.