Aracıları Azure Databricks üzerinde dağıtın

Bir ajanı üretimde çalıştırmak için, kodunu kullanıcılarınızdan ve uygulamalarınızdan gelen istekleri karşılayan yönetilen işlem altyapısına dağıtırsınız. Dağıtıma alınmış bir ajanın üç katmanı vardır: çerçeveniz veya harnessiniz, bir ajan sunucusu ve bir ajan çalışma zamanı. Agent Bricks, her katmanda, DurableAgentServer'dan Databricks Uygulamaları'ndaki Agent Runtime'a kadar seçenekler sunar.

Aracı hesaplama yığını

Konuşlandırılan bir ajan üç katmana sahiptir. Her katman üstündekini sarar.

Katman	Ne işe yarıyor?	Azure Databricks'teki Seçenekler
Çerçeve veya test çatısı	Ajan döngüsünü çalıştırır: modelleri ve araçları çağırır ve sırada ne yapacağına karar verir.	LangGraph veya OpenAI Agents SDK gibi herhangi bir çerçeve veya koşum ya da Omnigent gibi bir meta-harness.
Agent sunucusu	Ajan döngüsünü bir HTTP sunucusuyla sarar. Ajan sunucusu çağırma API'sini açığa çıkarır, istemci bağlantılarını yönetir ve kalıcılığı sağlar.	DurableAgentServer (önerilir), legacy aracı sunucular veya kendi sunucunuz.
Ajan runtime	Ajan sunucusunu yönetilen hesaplama üzerinde çalıştırır ve barındırma, kimlik ve ölçeklendirme işlemlerini yönetir.	Databricks uygulamalarında Agent Runtime.

Aşağıdaki terimler katmanların birlikte nasıl çalıştığını açıklar:

Süre	Ne anlama gelir?
Çağrı API'si	Müşterilerin ajanı çalıştırmak için çağırdığı HTTP API'si. Bkz. Azure Databricks'e dağıtılan sorgu aracıları.
Serve	Ajan çalışma zamanı, çağrı API'si üzerinden ajanınıza hizmet veren ajan sunucusunu çalıştırır.
Yerleştir	Ajan kodunuzu agent runtime'a ekleyin.

Note

Databricks Sandbox , hesaplama yığınının bir katmanı değildir. Bu, ajanınızın, ajan çalışma zamanından ayrı, yönetilen verilerinize sınırlı erişime sahip izole bir ortamda kod çalıştırmak için çağırdığı bir araçtır. Ajanınız veri analiz betikleri gibi kodlar yazıp çalıştırdığında sandbox kullanın. Bir CLI projesine sandbox aracı vermek için agentbricks tools add sandboxçalıştırın.

Çerçeve veya test çatısı

Çerçeve veya koşum, aracı kodunuzdur. Bir modelle akıl yürüten döngüyü çalıştırır, araçları çağırır ve ne zaman yanıt vereceğine karar verir. Agent Bricks belirli bir çerçeve gerektirmez.

Çerçeve veya test düzeneği	Ne zaman kullanılır?
Şablonlar	Yeni bir ajan başlatılıyor. Agent Bricks CLI, LangGraph ve OpenAI Agents SDK için projelerin iskeletini oluşturur. Şablonlar, çerçeve kodunuzu onu ajan sunucusuna bağlayan koddan ayrı tutar.
Mevcut aracılar	LangGraph veya OpenAI Agents SDK ile zaten oluşturduğunuz bir ajanı içe aktarma agentbricks init --existing öğesini kendi dizininde çalıştırın. Mevcut bir aracı getir'e bakın.
Meta-harness	Omnigent ile kodlama ajanları gibi birden fazla araç setini tek bir ajanda birleştirmek.

Agent sunucusu

Ajan sunucusu, ajan döngüsünüzü saran ve onu bir servise dönüştüren bir kütüphanedir. İstemcilerin çağırdığı API'yi tanımlar, her çalıştırmayı takip eder ve bir çalıştırma kesintiye uğradığında ne olacağını belirler.

Agent sunucusu	Ne zaman kullanılır?
DurableAgentServer (önerilir)	Agent Bricks CLI ile oluşturulan yeni aracılar
Legacy aracı sunucuları	Uygulama şablonlarından oluşturulmuş aracıları korumak. Eski ajan sunucularıyla DurableAgentServer öğesini karşılaştırmak için bkz. Azure Databricks'te agent sunucularını karşılaştır.
Kendi sunucun	Özel uç noktalara, istek formatlarına veya protokollere ihtiyaç duyan ajanlar. agentbricks init --server custom çalıştırın ya da mevcut sunucunuzu koruyun.

Aracı çalışma zamanı

Ajan çalışma zamanı, ajan sunucunuzu çalıştıran yönetilen işlem kaynağıdır. Sunucuları kendiniz sağlamak yerine ona kod dağıtıyorsunuz.

Aracı çalışma zamanı	Ne zaman kullanılır?
Aracı Çalışma Zamanı	Yeni ajanlar. Ajanınızı Databricks Apps üzerinde çalıştırıyor. agentbricks deploy ajanınızın ihtiyaç duyduğu kaynakları sağlar, ajanın bunlara erişimini sağlar ve onu kararlı, doğrulanmış bir uç noktaya dağıtır.
Model Serving (eski sürüm)	Model Serving uç noktalarına dağıtılan önceki ajanlar Bkz. Yapay zeka uygulamaları için aracı dağıtma (Model Sunma). Bunları Databricks Apps'a taşımak için Bir ajanı Model Serving'den Databricks Apps'a taşıma bölümüne bakın.

Agent Bricks CLI ile Dağıtım

Agent Bricks CLI, üç katmanı birbirine bağlar. Çerçeve kodunuzun iskeletini oluşturur, bunu yerel olarak DurableAgentServer üzerinde çalıştırır ve Agent Çalışma Zamanına dağıtır:

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

İlk ajanınızı inşa etmek ve dağıtmak için Agent Bricks hızlı başlangıcına bakınız.

Bir ajanı dağıtım izinleri

agentbricks deploy çalıştıran kullanıcı veya hizmet sorumlusu, aşağıdakileri yapmak için izne ihtiyaç duyar:

• Databricks Uygulamaları oluşturun veya mevcut uygulamayı yeniden dağıtım için yönetin. Bkz . Databricks uygulaması için izinleri yapılandırma.
• agent.toml içinde bildirilen bellek ve oturum depolarını oluşturun veya mevcut depoları yönetin; böylece Agent Bricks uygulamanın hizmet sorumlusuna erişim izni verebilir.
• Projenin izleme için kullandığı MLflow deneyini oluşturun veya zaten varsa düzenleyin.
• Uygulamanın hizmet sorumlusuna, araçların --auth app ile bildirdiği kaynaklara erişim ver, örneğin Unity Kataloğu fonksiyonunda EXECUTE, Genie Agent'te CAN RUN veya sandbox kapsamındaki bir tabloda SELECT.

Agent Bricks yalnızca agent.toml doğrudan beyan ettiği kaynaklara erişim izni verir. Bir araç başka kaynaklar kullanıyorsa, örneğin Genie Agent'ın arkasındaki tablolar veya Unity Catalog fonksiyonunun çağırdığı nesneler, uygulamanın hizmet sorumlusuna bunlara erişimi kendiniz verin. Deploy gerekli bir izni uygulayamazsa, kodunuzu yüklemeden önce durur ve mevcut dağıtımı çalışır durumda bırakır.

Ek kaynaklar

• Agent Server
• Aracı Çalışma Zamanı
• Azure Databricks'e dağıtılan sorgu aracıları