Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

Import projektu CrewAI — załoga dwóch agentów

Deklaracje agentów i zadań projektu CrewAI w klasycznym układzie — dwóch agentów na jednym modelu OpenAI, po jednym zadaniu dla każdego — przekształcone przez aggrega import w szkice plików Aggrega, z obrazem, w którym działa program crew, podanym jednorazowo w pliku odpowiedzi, i skompilowane dla Docker Compose.

Import projektu CrewAI omawia to krok po kroku: polecenie, o co pyta, pliki, które zapisuje, i dlaczego znajduje się w nich każdy wiersz, kompilację oraz działanie crew. Ten folder zawiera każdy etap tego przewodnika:

folder lub plikzawartość
source/deklaracje projektu, src/support_brief/config/agents.yaml i tasks.yaml, .aggrega-config.yaml, który czyni folder obszarem roboczym, oraz src/support_brief/import-answers.yaml, wartości, których nie zawiera żadna deklaracja: obraz każdego agenta i nazwa obiektu Secret Kubernetes, z którego kompilacja dla Kubernetes odczytuje klucz OpenAI
draft/pliki zapisane przez aggrega import src/support_brief --target compose, bez zmian, łącznie z release.lock, oraz to, co polecenie wypisało: stdout.txt na standardowe wyjście, import.txt na standardowe wyjście błędów

Deklaracje są napisane na potrzeby tego przykładu. Program załogi nie jest ich częścią: import nigdy żadnego nie czyta, a encja Release wskazuje obraz, w którym działa.

W kopii repozytorium dokumentacji check.sh ponownie uruchamia import, porównuje to, co zapisuje i wypisuje, z draft/, porównuje bloki cytowane w przewodniku z tymi plikami oraz waliduje i kompiluje to, co zapisał import. Wymaga katalogu biblioteki standardowej (skąd go pobrać) pobranego obok tego repozytorium albo jego folderu wskazanego w AGGREGA_CATALOG_DIRS.

Generowanie przykładu

Import tego przykładu można uruchomić poleceniami poniżej albo zlecić jego uruchomienie swojemu asystentowi AI.

Należy zapisać przykład w nowym folderze nazwanym tak jak on:

Terminal window
aggrega scaffold --example import-crewai

Następnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:

Terminal window
cd import-crewai

Kompilacja

Import tworzy szkice plików Aggrega obok projektu, w source/. Porównuje projekt z katalogiem biblioteki standardowej, który domyślny rejestr obszaru roboczego publikuje jako podpisaną migawkę: pierwszy import go pobiera, weryfikuje, przechowuje w pamięci podręcznej treści obszaru roboczego i wskazuje go po jego skrócie (digest) w zapisie, który tworzy obok szkiców. Obszar roboczy, który wskazuje własne foldery katalogu — w AGGREGA_CATALOG_DIRS lub pod workspace.catalog_dirs — importuje zamiast tego względem nich. Import odczytuje obrazy z src/support_brief/import-answers.yaml, a następnie pobiera to, od czego zależy szkic encji Release, dzięki czemu kompilacja może nastąpić od razu:

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

Obraz wskazany w przykładzie zastępuje obraz budowany z własnego projektu; jego budowanie i uruchamianie stosu opisuje przewodnik podlinkowany powyżej.

Z asystentem AI

Asystent AI skonfigurowany z narzędziami Aggrega może zrobić to samo: wystarczy wkleić mu ten prompt.

Używaj wyłącznie narzędzi Aggrega i nie twórz samodzielnie żadnego folderu. Jeśli folder obszaru roboczego nie zawiera jeszcze folderu `import-crewai`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `import-crewai` i bez `dir`: zapisze ono przykład w nowym folderze `import-crewai`, którego folder `source` zawiera to, co importuje ten przykład. Następnie wywołaj narzędzie `import` z `workspace_root` ustawionym na `import-crewai/source`, `source` ustawionym na `src/support_brief` i `target` ustawionym na `compose`: odczytuje ono potrzebne odpowiedzi z `import-answers.yaml` w folderze `src/support_brief`, zapisuje swoje szkice w `import-crewai/source` i pobiera to, czego one potrzebują. Następnie wywołaj narzędzie `validate` z `workspace_root` ustawionym na `import-crewai/source` i `release` ustawionym na `release.yaml` oraz narzędzie `build` z `workspace_root` ustawionym na `import-crewai/source`, `release` ustawionym na `release.yaml` i `write` ustawionym na true. Powiedz mi, które pliki zapisała kompilacja; znajdują się w `import-crewai/source/dist/`.

Testowanie

Gdy stos działa tak, jak uruchamia go przewodnik, jedno żądanie dociera do crew. Poniższa trasa należy do własnego programu przewodnika, małego serwera HTTP na porcie 8000; własny program decyduje o swojej. Encja Release publikuje badacza na 127.0.0.1:8000, a autora na 127.0.0.1:8001, więc żądanie trafia do badacza z własnego komputera:

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]"
}

Klucz tego uruchomienia był symbolem zastępczym, więc odpowiedzią jest odmowa OpenAI dla tego klucza. W Kubernetes należy przekierować lokalny port do Deployment, który nie ma Service, i wysłać do niego to samo żądanie z innego terminala:

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?"}'

Odpowiedź jest taka sama.