Ügynök futtatókörnyezete

Az Agent Runtime az ügynököt Azure Databricks-en üzemeltetett szerver nélküli számítási környezetben futtatja. Az ügynökszervert futtatja, például DurableAgentServer, a Databricks alkalmazásokon, így a kódot telepíted a szerverek provisionálása helyett. Ha szeretnéd megtudni, hogyan illeszkedik az Agent Runtime a keretrendszeredhez és az agentszerveredhez, lásd: Deploy agents on Azure Databricks.

Mit nyújt az Agent Runtime

  • Stabil, hitelesített végpont: Minden telepítés egy agent-bricks-<name> nevű alkalmazás, saját URL-lel. A kliensek egy Azure Databricks OAuth-tokennel hitelesítenek. Lásd: Az Azure Databricksben üzembe helyezett lekérdezési ügynökök.
  • Ügynök identitása: Az ügynök az alkalmazás szolgáltatásneveként működik. Lásd : Ügynök azonosító.
  • Tartós végrehajtás: Azoknál az ügynököknél, amelyek DurableAgentServer használnak, a telepítés egy Runtime Store-t biztosít, hogy a futási állapot túlélje a feldolgozó újraindításait, és a megszakított futások helyreállhassanak.
  • Követés: Az üzembe helyezés az MLflow-követést ahhoz a kísérlethez konfigurálja, amelyhez a projekt kapcsolódik. Lásd: A nyomkövetés áttekintése.
  • Skálázás: Futtasson egy ügynököt 1–5 példányon. Lásd : Databricks alkalmazások vízszintes skálázása.

Az ügynök azonosítója

Az ügynök identitása annak az alkalmazásnak a szolgáltatásneve, amelyre telepítették. Az ügynök ezt az identitást használja az Azure Databricks API-k meghívására, valamint olyan eszközök futtatására, amelyeket a --auth app segítségével ad hozzá.

  • Telepítéskor a agentbricks deploy hozzáférést ad a service principalnak a memóriához, a munkamenethez és a futtatási állapottárolókhoz, amelyeket az ügynök használ.
  • Ahhoz, hogy az ügynök hozzáférjen más adatokhoz és erőforrásokhoz, add meg az alkalmazás service principaljának a szükséges jogosultságokat, ahogy bármely alkalmazásnál megtennéd. Lásd: Engedélyezés konfigurálása Databricks-alkalmazásokban.
  • A auth = "user" használó eszközök a kérést küldő felhasználó jogosultságaival futnak, nem pedig a szolgáltatásnév jogosultságaival. Lásd a Felhasználói engedélyezés kérése elemet.

Ügynök telepítése

Ügynökprojekt telepítése az Agent Bricks CLI használatával:

agentbricks --profile <profile> deploy my-agent

agentbricks deploy a következőket teszi:

  1. Létrehozza vagy újrahasználja a(z) agent.toml elemben deklarált memória- és munkamenettárolókat, és hozzáférést biztosít ezekhez az alkalmazás szolgáltatási főszereplőjének.
  2. Azoknál az ügynököknél, amelyek használják DurableAgentServer, létrehozza vagy újra felhasználja a telepítés Runtime Store-ját.
  3. Konfigurálja a nyomkövetést.
  4. Telepíti az alkalmazást.

Az ügynök egynél több példányon való futtatásához add meg: --instances

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

Ha egy ügynök több példányon fut, az ügyfelek elküldhetik a session ID-t egy X-Routing-Key fejlécben, hogy az összes kérést ugyanahhoz az instance-hoz irányítsák.

Telepítések kezelése

Parancs Description
agentbricks deployments list Sorold fel az ügynökök telepítéseit.
agentbricks deployments get <app-name> Mutassa meg az üzembe helyezés URL-jét, státuszát és leírását.
agentbricks deployments logs <app-name> Mutasd meg egy telepítés naplóit.
agentbricks deployments start <app-name> és agentbricks deployments stop <app-name> Indítsa el vagy állítsa le a telepítést.
agentbricks deployments delete <app-name> Telepítés törlése.

Mivel minden telepítés egy alkalmazás, azt a Databricks Appsban is megtekintheted és figyelheted. Lásd: Databricks-alkalmazások naplózása és monitorozása.

Limitations

Nem lehet megváltoztatni egy meglévő telepítés ügynökkiszolgálóját. Szerverváltáshoz hozz létre egy új projektet a kívánt agentbricks init --server opcióval, és telepítsd azt új néven.

További erőforrások

  • Utolsó frissítés időpontja: