Ügynökök üzembe helyezése az Azure Databricksben

Az ügynök éles környezetben való futtatásához a kódját felügyelt számítási környezetbe telepíted, amely a felhasználóktól és az alkalmazásoktól érkező kéréseket szolgálja. A telepített ügynöknek három rétege van: a keretrendszer vagy a segédkeretrendszer, egy ügynökszerver és egy ügynök-futtatókörnyezet. Az Agent Bricks minden rétegben opciókat kínál, az DurableAgentServer elemtől a Databricks Apps Agent Runtime-ig.

Az ügynök számítási verme

Egy telepített ügynöknek három rétege van. Minden réteg beborítja az alatta lévő réteget.

Az ügynök számítási stack: a keretrendszer vagy a harness, amelyet egy ügynökszerver fog körül, amely elérhetővé teszi az invocation API-t, és az Agent Runtime-on fut.

Réteg Mire szolgál? Lehetőségek az Azure Databricksben
Keret vagy tesztkeret Futtatja az ügynökciklust: modelleket és eszközöket hív, és eldönti, mit tegyen ezután. Bármilyen keretrendszer vagy harness, mint például a LangGraph vagy az OpenAI Agents SDK, vagy egy meta-harness, mint az Omnigent.
Agentkiszolgáló Az agent loopot egy HTTP-szerverbe csomagolja. Az ügynökkiszolgáló elérhetővé teszi az invocation API-t, kezeli az ügyfélkapcsolatokat, és kezeli a perzisztenciát. DurableAgentServer (ajánlott), régi ügynökkiszolgálókat vagy saját kiszolgálót.
Ügynök futtatókörnyezet Az ügynök szervert felügyelt számítási környezetben futtatja, és kezeli az üzemeltetést, az identitást és a skálázást. Agent Runtime a Databricks Apps platformon.

A következő kifejezések írják le, hogyan működnek együtt a rétegek:

Term Mit jelent ez?
Invocation API Az a HTTP API, amelyet az ügyfelek hívnak az ügynök futtatásához. Lásd: Az Azure Databricksben üzembe helyezett lekérdezési ügynökök.
Serve Az ügynök futtatóideje futtatja az ügynök szervert, amely az invocation API-n keresztül szolgálja ki az ügynöket.
Deploy Tedd be az ügynök kódodat az ügynök-futtatókörnyezetre.

Note

A Databricks Sandbox nem a számítási stack rétege. Ez egy olyan eszköz, amelyet az ügynök kód futtatására hív meg egy izolált környezetben, az ügynök futási idejétől elkülönülve, és korlátozott hozzáféréssel a szabályozott adatokhoz. Használj sandboxot, amikor az ügynököd kódot ír és futtat, például adatelemző szkripteket. Egy CLI-projekthez sandbox eszköz hozzáadásához futtasd a(z) agentbricks tools add sandbox parancsot.

Keret vagy tesztkeret

A keretrendszer vagy a tesztkörnyezet az ügynök kódja. Futtatja azt a ciklust, amely egy modellel érvel, eszközöket hív, és eldönti, mikor válaszol. Az Agent Bricks nem igényel konkrét keretrendszert.

Keret vagy tesztkeret Mikor érdemes használni?
Templates Új ügynök indítása. Az Agent Bricks CLI projektvázakat generál a LangGraph és az OpenAI Agents SDK számára. A sablonok külön tartják a keretrendszer kódját attól, amely az agentkiszolgálóhoz köti.
Meglévő ügynökök Egy már LangGraphban vagy az OpenAI Agents SDK-val létrehozott ügynök behozatala. Futtasd a könyvtárában a agentbricks init --existing elemet. Lásd: Meglévő ügynök behozatala.
Meta-harness Több összetevőt, például kódoló ügynököket, egyetlen ügynökbe komponálni Omnigent-tel.

Agent-kiszolgáló

Az ügynökszerver egy könyvtár, amely becsomagolja az agentciklust, és szolgáltatássá alakítja. Definiálja azt az API-t, amelyet az ügyfelek hívnak, nyomon követi az egyes futásokat, és meghatározza, mi történik, ha egy futás megszakad.

Agent-kiszolgáló Mikor érdemes használni?
DurableAgentServer (ajánlott) Új ügynökök épültek az Agent Bricks CLI-jával.
Régi agentkiszolgálók Az alkalmazássablonokból létrehozott ügynökök karbantartása. Ennek a régi ügynökkiszolgálókkal való összehasonlításához lásd: DurableAgentServerAz ügynökkiszolgálók összehasonlítása az Azure Databricksben.
A saját szervered Olyan ügynökök, amelyeknek egyedi végpontokra, kérési formátumokra vagy protokollokra van szükségük. Futtasd agentbricks init --server custom, vagy tartsd meg a meglévő szerveredet.

Ügynök futtatókörnyezete

Az ügynök-futtatókörnyezet az a felügyelt számítási környezet, amely az ügynökszervert futtatja. A kódot telepíted rá ahelyett, hogy magad helyeznéd üzembe a kiszolgálókat.

Ügynök futtatókörnyezete Mikor érdemes használni?
Agent Runtime Új ügynökök. Az ügynökét Databricks Apps környezetben futtatja. agentbricks deploy biztosítja az ügynöknek szükséges erőforrásokat, hozzáférést biztosít az ügynöknek, és stabil, hitelesített végpontra telepíti azt.
Modellek kiszolgálása (régi) A korábbi ügynökök Model Serving végpontokra lettek telepítve. Lásd: Ügynök üzembe helyezése AI-alkalmazásokhoz (Modellkiszolgáló). Azok Databricks Appsba való áthelyezéséhez lásd: Agent migrálása a Model Servingből a Databricks Appsba.

Telepítés az Agent Bricks CLI-vel

Az Agent Bricks CLI összeköti a három réteget. Generálja a keretrendszerkód alapstruktúráját, helyben futtatja a DurableAgentServer-n, majd telepíti az Agent Runtime-ba:

agentbricks init my-agent --framework langgraph
cd my-agent
agentbricks dev
agentbricks deploy my-agent

Az első ügynök építéséhez és telepítéséhez nézd meg az Agent Bricks gyorsindítását.

Ügynök telepítésének engedélyei

A(z) agentbricks deploy futtató felhasználónak vagy szolgáltatásnévnek engedélyre van szüksége a következő műveletekhez:

  • Hozz létre Databricks alkalmazásokat, vagy kezeld a meglévő alkalmazást egy újbóli üzembe helyezéshez. Lásd: Databricks-alkalmazások engedélyeinek konfigurálása.
  • Hozza létre a agent.toml elemben deklarált memória- és munkamenet-tárolókat, vagy kezelje a meglévő tárolókat, hogy az Agent Bricks hozzáférést adhasson az alkalmazás szolgáltatásnévhez tartozó rendszerbiztonsági tagjának ezekhez.
  • Hozd létre az MLflow kísérletet, amit a projekt használ a követéshez, vagy szerkessd meg, ha már létezik.
  • Biztosíts az alkalmazás szolgáltatásnevének hozzáférést olyan erőforrásokhoz, amelyeket az eszközök jelölnek, --auth app például EXECUTE egy Unity Catalog függvényen, CAN RUN egy Genie ügynökön vagy SELECT egy sandbox scope-ben lévő táblán.

Az Agent Bricks csak olyan erőforrásokhoz ad hozzáférést, amelyeket közvetlenül a agent.toml deklarál. Ha egy eszköz más erőforrásokat használ, például a Genie Agent mögötti táblákat vagy azokat az objektumokat, amelyeket egy Unity Catalog függvény hív, adj hozzáférést az alkalmazás szolgáltatásnevének hozzájuk. Ha a deploy nem tudja alkalmazni a szükséges jogosultságot, akkor leáll, mielőtt feltöltené a kódodat, és az aktuális telepítés fut tovább.

További erőforrások

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