Środowisko uruchomieniowe agenta

Agent Runtime uruchamia twojego agenta w środowisku serverless compute hostowanym przez Azure Databricks. Uruchamia serwer agenta, na przykład DurableAgentServer, w aplikacjach Databricks, więc wdrażasz kod zamiast konfigurować serwery. Aby dowiedzieć się, jak Agent Runtime pasuje do Twojego frameworka i serwera agenta, zobacz Wdrażanie agentów w usłudze Azure Databricks.

Co oferuje Agent Runtime

  • Stabilny, uwierzytelniony punkt końcowy: Każde wdrożenie to aplikacja o nazwie agent-bricks-<name> z własnym adresem URL. Klienci uwierzytelniają się za pomocą tokenu OAuth usługi Azure Databricks. Zobacz Agenty zapytań wdrożone na platformie Azure Databricks.
  • Tożsamość agenta: Agent działa jako jednostka usługi aplikacji. Zobacz Tożsamość Agenta.
  • Trwałe wykonanie: Dla agentów korzystających z DurableAgentServer, wdrożenie zapewnia Runtime Store, tak aby stan uruchomienia przetrwał restarty pracowników, a przerwane uruchomienia mogły zostać wznowione.
  • Śledzenie: Wdrażanie konfiguruje śledzenie MLflow dla eksperymentu, z którym projekt jest powiązany. Zobacz przegląd Śledzenia.
  • Skalowanie: Uruchom agenta na 1 do 5 instancji. Zobacz skalowanie poziome dla aplikacji Databricks.

Tożsamość agenta

Tożsamość agenta to nazwa główna usługi aplikacji, do której został wdrożony. Agent używa tej tożsamości do wywoływania API Azure Databricks oraz uruchamiania narzędzi, które dodajesz za pomocą --auth app.

  • Podczas wdrażania element agentbricks deploy przyznaje jednostce usługi dostęp do magazynów pamięci, sesji i stanu uruchomienia, których używa agent.
  • Aby dać agentowi dostęp do innych danych i zasobów, nadaj jednostce usługi aplikacji potrzebne uprawnienia, tak jak w przypadku każdej aplikacji. Zobacz Konfigurowanie autoryzacji w aplikacji usługi Databricks.
  • Narzędzia, które używają auth = "user", działają z uprawnieniami użytkownika, który wysłał żądanie, zamiast z uprawnieniami jednostki usługi. Zobacz Autoryzację użytkownika żądania.

Wdróż agenta

Wdroż projekt agenta z CLI Agent Bricks:

agentbricks --profile <profile> deploy my-agent

agentbricks deploy wykonuje następujące czynności:

  1. Tworzy lub ponownie wykorzystuje pamięć i magazyny sesji zadeklarowane w agent.toml oraz przyznaje jednostce usługi aplikacji dostęp do nich.
  2. Dla agentów, którzy korzystają z DurableAgentServer, tworzy lub ponownie używa Runtime Store wdrożenia.
  3. Konfiguruje śledzenie.
  4. Wdraża aplikację.

Aby uruchomić agenta na więcej niż jednej instancji, należy przekazać --instances:

agentbricks --profile <profile> deploy my-agent --instances 2

Gdy agent działa na więcej niż jednej instancji, klienci mogą wysłać identyfikator sesji w nagłówku X-Routing-Key, aby kierować wszystkie żądania w sesji do tej samej instancji.

Zarządzaj wdrożeniami

Polecenie Opis
agentbricks deployments list Wyświetl listę wdrożeń agentów.
agentbricks deployments get <app-name> Pokaż adres URL, status i opis wdrożenia.
agentbricks deployments logs <app-name> Pokaż logi wdrożenia.
agentbricks deployments start <app-name> i agentbricks deployments stop <app-name> Rozpocznij lub zakończ wdrożenie.
agentbricks deployments delete <app-name> Usuń wdrożenie.

Ponieważ każde wdrożenie jest aplikacją, możesz ją również przeglądać i monitorować w aplikacjach Databricks. Zobacz Rejestrowanie i monitorowanie aplikacji usługi Databricks.

Limitations

Nie możesz zmienić serwera agenta istniejącego wdrożenia. Aby zmienić serwer, stwórz nowy projekt z opcją agentbricks init --server, którą chcesz, i wdroż go pod nową nazwą.

Dodatkowe zasoby