Import deklaratywnego agenta Microsoft Agent Framework — agent i serwer MCP
Deklaratywny agent Microsoft Agent Framework — jeden agent na modelu OpenAI, przeszukujący dokumentację przez serwer MCP — przekształcony przez aggrega import w szkice plików Aggrega, z obrazem aplikacji podanym raz w pliku odpowiedzi, i skompilowany dla Docker Compose.
Import deklaratywnego agenta Microsoft Agent Framework 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łającego agenta. Ten folder zawiera każdy etap tego przewodnika:
| folder lub plik | zawartość |
|---|---|
source/ | deklaratywny agent, support-agent.yaml, .aggrega-config.yaml, który czyni folder obszarem roboczym, oraz import-answers.yaml, wartości, których nie zawiera żaden deklaratywny agent: obraz aplikacji i nazwa obiektu Secret Kubernetes, z którego kompilacja dla Kubernetes odczytuje klucz OpenAI |
draft/ | pliki zapisane przez aggrega import support-agent.yaml --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 |
Deklaratywny agent jest napisany na potrzeby tego przykładu. Kod aplikacji, który go wczytuje, nie jest jego częścią: import nigdy go nie czyta, a encja Release wskazuje obraz, w którym działa aplikacja.
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:
aggrega scaffold --example import-agent-frameworkNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd import-agent-frameworkKompilacja
Import tworzy szkice plików Aggrega obok deklaratywnego agenta, w source/. Porównuje projekt z katalogiem biblioteki standardowej, który domyślny rejestr obszaru roboczego publikuje jako podpisaną migawkę: pierwszy import pobiera go, weryfikuje, przechowuje w pamięci podręcznej zawartości obszaru roboczego i wskazuje go przez jego skrót (digest) w rekordzie, który zapisuje 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 obraz z import-answers.yaml, a następnie pobiera to, od czego zależy szkic encji Release, więc kompilacja następuje od razu:
cd sourceaggrega import support-agent.yaml --target composeaggrega build --release release.yamlObraz 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-agent-framework`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `import-agent-framework` i bez `dir`: zapisuje ono przykład w nowym folderze `import-agent-framework`, którego folder `source` zawiera to, co importuje ten przykład. Następnie wywołaj narzędzie `import` z `workspace_root` ustawionym na `import-agent-framework/source`, `source` ustawionym na `support-agent.yaml` i `target` ustawionym na `compose`: odczytuje ono potrzebne odpowiedzi z `import-answers.yaml` obok `support-agent.yaml`, zapisuje swoje szkice w `import-agent-framework/source` i pobiera to, czego one potrzebują. Następnie wywołaj narzędzie `validate` z `workspace_root` ustawionym na `import-agent-framework/source` i `release` ustawionym na `release.yaml` oraz narzędzie `build` z `workspace_root` ustawionym na `import-agent-framework/source`, `release` ustawionym na `release.yaml` i `write` ustawionym na true. Podaj mi, które pliki zapisała kompilacja; znajdują się w `import-agent-framework/source/dist/`.Testowanie
Gdy stos działa tak, jak uruchamia go przewodnik krok po kroku, jedno żądanie dociera do agenta. Poniższa trasa należy do programu samego przewodnika, małego serwera HTTP na porcie 8000; własny program ustala własną. Encja Release publikuje agenta na 127.0.0.1:8000, więc żądanie wychodzi z własnego komputera:
curl -sS -X POST http://127.0.0.1:8000/ask -H 'Content-Type: application/json' \ -d '{"question": "In one short sentence: what is Azure Container Apps?"}'{"error": "the agent failed: ChatClientException: (\"<class 'agent_framework_openai._chat_client.OpenAIChatClient'> service failed to complete the prompt: Error code: 401 - Incorrect API key provided: sk-place************-key. [… omitted: where to find an API key, and the same error repeated as the exception it wraps]"}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:
kubectl port-forward deploy/supportagent 8000:8000curl -sS -X POST http://127.0.0.1:8000/ask -H 'Content-Type: application/json' \ -d '{"question": "In one short sentence: what is Azure Container Apps?"}'Odpowiedź jest taka sama.