Agent Bricks gyorsútmutató

Important

Ez a funkció bétaverzióban érhető el. Ehhez nincs szükség munkatér beállításra. Telepítsd az Agent Bricks CLI-t a kezdéshez.

Ez a gyorsindítás egy üres könyvtárból egy telepített egyedi ügynökhöz vezet az Agent Bricks CLI-val (databricks-agentbricks), amely az Azure Databricks parancssoros eszköze az ügynökök építésére és telepítésére. Az Agent Bricks CLI kezeli a modellhozzáférést, a memóriát, a munkameneteket, az eszközöket és a nyomkövetést, így az ügynök logikájára koncentrálhatsz.

Hogyan működik az Agent Bricks CLI

Az Agent Bricks CLI egy helyi projektet generál egy framework sablonból, ahol a futásidő, a tesztek és egy opcionális chat UI már be van kötve. Megírod az alkalmazás logikáját (modell, szerszámok és promptok), a CLI pedig helyben futtatja és üzembe helyezi. A deklaratív agent.toml fájl a hiteles forrás az Azure Databricks által kezelt erőforrások számára, amelyekre az ügynök támaszkodik, mint például eszközök, memória, munkamenetek és követés. agentbricks deploy beolvassa, hogy kiépítse és mindent bekössön.

Három parancs visz egy agentet egy üres könyvtárból éles környezetbe:

• agentbricks init létrehozza a projekt vázát és megírja agent.toml.
• A agentbricks dev helyben futtatja az ügynököt, ugyanabban a futtatókörnyezetben és környezetben, amelyet az Azure Databricks használ.
• agentbricks deploy kiépíti a bejelentett erőforrásokat és telepíti a telepítést.

Prerequisites

• A Databricks CLI telepítve van, és szerepel a PATH-ban.

• Python 3.10 vagy újabb, pip.

• Telepítse az Agent Bricks CLI-t:

  pip install databricks-agentbricks
  

1. lépés: Hitelesítés

Hitelesítse a munkaterületét OAuth-val, mentsen el egy elnevezett profilt, és állítsa be azt az Agent Bricks CLI alapértelmezett profiljaként:

databricks auth login --host https://<your-workspace-url> --profile <profile>
agentbricks login --profile <profile>

2. lépés: Építsd fel a projektet

Hozzon létre egy új ügynökprojektet, kiválasztva egy keretrendszer-sablont a(z) --framework használatával:

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

3. lépés: Futtatd az agentet helyben

Futtasd az ügynököt a gépeden, hogy teszteld, mielőtt telepítenéd:

agentbricks dev

Ez egy helyi szervert indít el a 8000-es porton, ugyanazzal a parancsgal és környezettel, mint az Azure Databricks ügynök runtime, csatlakozva az Azure Databricks modellkiszolgáláshoz. Küldj kéréseket az http://localhost:8000 ügynökkel való kapcsolatfelvételhez.

4. lépés: Telepítsd az ügynökprogramot

Telepítse az ügynököt az Azure Databricks agent runtime-ba:

agentbricks deploy my-agent

Az Agent Bricks CLI biztosítja a társított tárolókat, hozzáférést biztosít az ügynök szolgáltatásnevének, és bevezeti a telepítést. Amikor a folyamat befejeződik, a CLI visszaadja a telepítés URL-jét. Nyisd meg az URL-t, hogy kapcsolatba léphess az élő ügynököddel.

További lépések

• Parancsok teljes bemutatása és az Agent Bricks CLI képességei: Agent Bricks CLI.
• Menedzselt memória és munkamenetek összekapcsolása: Ügynökmemória.
• Eszközök és MCP-szolgáltatások hozzáadása: MCP-k
• Ügynökök nyomkövetésének megtekintése MLflow-val: Nyomkövetés áttekintése.