Agentler#
Agentler, görsel bir iş akışında görüntüleri, modelleri, koşulları ve eylemleri birbirine bağlar. Hangi görüntülerin daha yakından incelenmesi gerektiğine karar vermek için YOLO'yu kullan, bir görsel-dil modelinden görüntüleri açıklamasını iste veya seçilen görüntüleri inceleme için bir veri kümesinde topla.
Kenar çubuğundan Agentler'i aç veya platform.ultralytics.com/agents adresine git. Erken erişim ayarını etkinleştirmene gerek yok; Agentler, kişisel ve ekip çalışma alanlarında oturum açmış tüm kullanıcıların kenar çubuğunda görünür.
İlk İş Akışını Çalıştır#
- Agentler'i aç, Blok ekle > Şablonlar'a tıkla ve YOLO → VLM Monitörü'nü seç.
- Giriş görüntüsü bloğunu seç, yüklenmiş bir veri kümesi belirle ve bir kişi içeren görüntüyü seç. Paylaşılan deneme için en fazla 4 megapiksel boyutunda bir görüntü kullan.
- Varsayılan YOLO26 nano modelini kullan. YOLO en az bir kişi algıladığında koşul sağlanır.
- Sahneyi açıkla'yı seç, bir görsel-dil modeli belirle ve bir istem gir. Henüz yapmadıysan, Ayarlar > API Anahtarları bölümüne eşleşen sağlayıcı anahtarını ekle. Ekip çalışma alanında, sağlayıcı anahtarını eklemesini veya değiştirmesini çalışma alanı sahibinden iste.
- Küçük bir çalıştırma için Paylaşılan deneme · 60 saniye seçili kalsın, ardından Çalıştır'a tıkla.
- Blokların güncellenmesini izle ve Çıktı'yı incele. Kişi algılanmazsa koşul, açıklama dalını çalıştırmadan tamamlanır.
Taslağı kaydetmeden önce çalıştırabilirsin. Daha sonra kullanmak üzere iş akışını adlandırıp kaydetmek için İş akışını kaydet'i kullan; değişiklik yaptıktan sonra yeniden kaydet. Python düğmesi, oluşturulan iş akışı kodunu gösterir.
Bir Şablonla Başla#
| Şablon | İş akışı | Kullanım amacı |
|---|---|---|
| YOLO → VLM Monitörü | Görüntü → YOLO → koşul → görsel-dil modeli → Çıktı | Yalnızca kişi algılandığında sahneyi açıklama |
| Belirsiz Algılamaları Topla | Veri kümesi → Dağıtım → güven koşulu → Veri kümesi | Belirsiz algılamalar içeren görüntülerden bir inceleme kümesi oluşturma |
| Görüntü Yakala ve Uyarı Gönder | Görüntü → YOLO → koşul → Veri kümesi ve Slack | Tek bir koşuldan hem görüntüyü kaydetme hem de bir kanala bildirim gönderme |
Şablonlar, düzenlenebilir başlangıç noktalarıdır. Çalıştırmadan önce çalışma alanın için görüntüleri, dağıtımı, hedef veri kümesini ve entegrasyonları seç. Bu iş akışları Çalıştır'a tıkladığında çalışır; Monitör şablonu seçilen giriş görüntüsünü analiz eder.
Çalıştırma Yerini Seç#
Çalıştır'ın yanındaki yürütme seçicisi, iş akışı için kullanılacak donanımı belirler.
| Seçenek | Kullanım amacı | Sınırlar ve fiyatlandırma |
|---|---|---|
| Paylaşılan deneme · 60 saniye | Küçük bir iş akışını deneme | En fazla 60 saniye, her biri en fazla 4 megapiksel olan toplam 20 giriş görüntüsü ve 20 model/sağlayıcı çağrısı; resmî YOLO26 nano modeliyle tek bir yerel YOLO modeli |
| Mevcut özel dağıtım | Daha büyük veri kümeleri, daha uzun çalıştırmalar veya başka yerel modeller | Uygun, ücretsiz özel dağıtım da dâhil olmak üzere, bu dağıtımın mevcut donanımını ve fiyatlandırmasını kullanır; genel iş akışı süresi veya görüntü sayısı sınırı yoktur |
| Yeni dağıtım… | Oluşturucudan özel donanım oluşturma | Mevcut dağıtım oluşturma ve fiyatlandırma iletişim kutusunu açar; kaynakları seç ve dağıtım hazır olana kadar bekle |
Paylaşılan denemelerde dakikada üç çalıştırma yapılabilir; özel dağıtımdaki çalıştırmalarda hız sınırı yoktur. Platform çalıştırmaları en fazla 20 bloğu destekler. Model/sağlayıcı çağrılarına YOLO, görsel-dil modelleri, dağıtım tahminleri ve Slack ile Webhook eylemleri dâhildir; dallanma, giriş görüntüsü başına çağrı sayısını artırabilir.
Özel çalıştırmalar, seçilen dağıtımda kontrol noktaları içeren isteklerle devam eder. Tarayıcıyı kapatmak veya yeniden yüklemek çalıştırmayı durdurmaz. Mevcut dağıtım ve sağlayıcı sınırları geçerliliğini korur; dil modeli kullanımı, anahtarınla ilişkili sağlayıcı tarafından faturalandırılır. Donanım seçenekleri için dağıtım fiyatlandırmasına bak.
Dağıtım bloğu, bir tahmin adımında kullanılacak uç noktayı seçer. Yürütme seçicisi, iş akışının kendisinin nerede çalışacağını belirler. Her ikisi için de aynı özel dağıtımı seçebilirsin.
Blokları Yapılandır#
| Blok | Amaç |
|---|---|
| Görüntü | Bir görüntü yükle, varsayılan olarak en fazla 10 kareye örneklenmiş bir video yükle veya yüklenmiş bir veri kümesinden tek bir görüntü seç |
| Gelen bağlantısı olmayan Veri kümesi | Yapılandırılabilir giriş sınırıyla seçilen veri kümesinden ve bölümden görüntüleri oku |
| YOLO | Resmî bir modeli veya çalışma alanındaki eğitilmiş bir modeli çalıştır |
| Dağıtım | Mevcut ve hazır bir Platform dağıtımı üzerinden tahmin yap |
| LLM | Görüntüyü ve önceki adımlardan gelen bağlamı seçilen dil veya görsel-dil modeline gönder |
| Kapı | Bir koşul veya sıklık aracılığıyla sonraki adımların yürütülmesini denetle |
| Gelen bağlantısı olan Veri kümesi | Gelen görüntüyü bir hedef veri kümesine ekle |
| Slack | Çalışma alanının bağlı Slack kanalına mesaj gönder |
| Webhook | POST JSON gövdesini bir HTTPS uç noktasına gönder |
| Dışa aktar | Platform'un mevcut dışa aktarma iş akışını kullanarak bir modeli dışa aktar |
| Çıktı | Önceki adımın sonucunu göster |
Ayarlarını düzenlemek için bir blok seç. Sonucunu sonraki adıma aktarmak için bir çıkışı başka bir bloğa bağla. Bir çıkış birden çok bloğa bağlanabilir: örneğin, tek bir koşulu hem hedef veri kümesine hem de Slack'e bağla. Her dal aynı değerlendirilmiş koşulu kullanır.
Algılamaları Koşulla Filtrele#
Algılama sayıları ve güven filtreleri için aynı Kapı bloğunu kullan. Önceki adımın sonucunu, herhangi bir sınıfı veya belirli bir sınıfı ve bir karşılaştırma seç. Örneğin:
- Kişi sayısı ≥ 1: En az bir kişi algılandığında devam et.
- Güven 0.25 ile 0.5 arasında: Eşleşen en az bir algılama bu aralıkta olduğunda devam et.
- Güven aralığındaki belirli bir sınıf: Yalnızca o sınıfa ait belirsiz algılamaları topla.
Güven filtreleri, algılamaları tek tek inceler. 0.3 ve 0.9 puanlarına sahip bir görüntü, algılamalardan biri eşleştiği için 0.25–0.5 aralığından geçer. Hiç algılama içermeyen görüntüler güven koşulunu sağlamaz. Değerlendirmek istediğin algılamaları tutmak için tahmin modelinin güven eşiğini yeterince düşük ayarla.
Eşleşmeyen bir koşul, sonraki adımlara çıktı vermeden tamamlanır. Bağlı eylemleri o görüntü için çalıştırılmaz.
İnceleme için Görüntü Topla#
Belirsiz Algılamaları Topla'yı aç, bir kaynak veri kümesi ve bölüm seç, tahmin dağıtımını belirle ve güven aralığını yapılandır. Son Veri kümesi bloğunda mevcut bir hedef veri kümesi seç. Gerekirse önce Veri Kümeleri sayfasından bir veri kümesi oluştur.
Hedefe, etiketsiz orijinal görüntüler train bölümünde eklenir. Mevcut kopyalar atlanır ve normal veri kümesi depolama kotaları geçerlidir. Kaynak etiketler ve model tahminleri açıklama olarak kopyalanmaz. Toplanan görüntüleri incelemek ve etiketlemek için hedefi mevcut açıklama düzenleyicisinde aç.
Çalışma alanının erişebildiği barındırılan görüntüleri ve düzenleme iznine sahip olduğun bir hedef veri kümesini kullan. Bağlı bulut depolama ve şirket içi veri kümeleri toplama hedefi olarak kullanılamaz.
Koşullu Slack Uyarıları Gönder#
Ayarlar > Entegrasyonlar bölümünde Slack'i bağla, ardından bir koşulu Slack bloğuna bağla. Mesajı gir ve önceki adımın sonucunu eklemek için {output} kullan. Görüntü Yakala ve Uyarı Gönder şablonu da aynı koşulu bir veri kümesine bağlar; böylece koşulla eşleşen bir görüntü toplanır ve bağlı kanala bir mesaj gönderilir.
İş akışı Slack mesajları blokta yapılandırılır. Bu mesajlar, Ayarlar bölümündeki eğitim, dışa aktarma ve dağıtım bildirim tercihlerinden ayrıdır.
Webhook Gönder#
Bir Webhook bloğu, her sonuç için Content-Type: application/json içeren bir POST'ı herkese açık bir HTTPS URL'sine gönderir; böylece JSON isteğini kabul eden herhangi bir hizmet koşulun sonucunu alabilir. Hedef URL'yi ve içinde bir dize olarak {output} bulunan, en fazla 10.000 karakterlik bir JSON gövdesini gir; bu değer önceki adımın sonucuyla değiştirilir. Blok son adımdır ve çıkış bağlantısı kabul etmez. Yönlendirmeler izlenmez, bağlantı 5 saniye sonra zaman aşımına uğrar ve 2xx dışındaki yanıtlar bloğun başarısız olmasına neden olur.
İlerlemeyi İzle ve Çalıştırmayı Durdur#
Etkin bloklarda yeşil bir dönen simge görünür. Tamamlanan bloklarda yeşil onay işareti ve yeşil kenarlık, başarısız bloklarda ise kırmızı kenarlık görünür. Sayaçlar her bloğa ulaşan girişleri gösterir; koşul eşleşmediğinde sonraki bloklar çalıştırılmaz.
Sayfayı yeniden yüklemek, çalıştırmanın ilerleme durumunu ve seçilen yürütme dağıtımını geri yükler. Tamamlanan sonuçlar eşleşen iş akışı için görünür kalır. Etkin bir çalıştırmayı iptal etmek için Durdur'a tıkla; iptal işlemi, yürütülen blok bir iptal noktasına ulaşana kadar bekler. Yürütme dağıtımını durdurmak veya silmek de iş akışını iptal eder.
Sorun Giderme#
- Çalıştırma, paylaşılan deneme sınırlarını aşıyor: Uygun ücretsiz dağıtım da dâhil olmak üzere özel bir dağıtım seç veya görüntü çözünürlüğünü, giriş sayısını ve model/sağlayıcı çağrılarını azalt.
- Dağıtım hazırlanıyor veya durdurulmuş: Hazır olmasını bekle veya Dağıtımlar bölümünden başlat.
- Sağlayıcı anahtarı eksik: Ayarlar > API Anahtarları bölümünden seçilen sağlayıcıyı bağla. Ekip çalışma alanında, anahtarı eklemesini veya değiştirmesini çalışma alanı sahibinden iste.
- Hedefe hiç görüntü ulaşmıyor: Koşulu ve tahmin güven eşiğini incele. Boş algılama sonuçları hiçbir zaman güven aralığı koşulunu sağlamaz.
- Toplanan görüntülerin etiketi yok: Toplama işlemi inceleme için orijinal görüntüleri ekler. Görüntüleri etiketlemek için mevcut açıklama araçlarını kullan.