ETL / Ayrıştırıcı Ajanı
Yapılandırılmamış girdiyi — gelen e-postaları, serbest metni, karmaşık PDF'leri — sistemlerinizin beklediği tam JSON veya Pydantic şemasına dönüştüren, hiçbir şey kaydedilmeden önce doğrulanan backend ajanı.
ETL / Ayrıştırıcı Ajanı Nedir?
ETL / Ayrıştırıcı Ajanı, TotalApp'in Temel Ajanlarından biridir. Görevi, yapılandırılmamış veya yarı yapılandırılmış girdiyi — gelen bir e-postayı, kopyala-yapıştır ile eklenmiş serbest metin bloğunu, taranmış veya karmaşık bir PDF'i — sistemlerinizin beklediği tam olarak yapılandırılmış kayda dönüştürmektir; bu ister bir JSON Şeması ister bir Pydantic modeli olarak tanımlanmış olsun.
Gerçek dünyadaki girdiler neredeyse hiçbir zaman bir veritabanı için önceden şekillendirilmiş olarak gelmez. Her gelen format (e-posta gövdesi, PDF eki, webhook yükü) için özel bir ayrıştırıcı yazmak yerine, buna ihtiyaç duyan her ekran ve iş akışı düğümü aynı ajanı yeniden kullanır: ona ham metin ve bir hedef şema verin, o da doğrulanmış, şemaya uygun bir kayıt döndürsün — ya da neyi güvenle dolduramadığını açıklayan net bir işaret koysun.
Tek cümlede
ETL / Ayrıştırıcı Ajanı'na ham girdi ve bir hedef şema verin — o şemaya tam olarak uyan doğrulanmış bir kayıt döndürür, ya da güvenle çıkaramadığı her şeyi incelenmek üzere işaretler.
Nasıl Çalışır — Önce Çıkar, Sonra Doğrula
| Aşama | Ne olur |
|---|---|
| 1. Çıkarım | Ham girdi — bir e-posta gövdesi, taranmış bir PDF, serbest biçimli metin — hedef şemanın alan listesine göre okunur. Şemanın gerektirdiği her alan, kaynak içerikte aranır. |
| 2. Yazmadan Önce Doğrulama | Çıkarılan kayıt, bir işlem hattındaki bir sonraki adıma teslim edilmeden önce şemanın tipleri, zorunlu alanları ve kısıtlamalarıyla karşılaştırılarak kontrol edilir. Bozuk hiçbir şey bir tabloya ulaşmaz. |
| 3. Kabul veya İşaretleme | Temiz bir şekilde doğrulanan bir kayıt hemen ilerletilir. Eksik veya belirsiz bir zorunlu alanı olan bir kayıt, en iyi tahminle zorla uydurulmak yerine bir inceleme kuyruğuna yönlendirilir. |
İşaretler, asla tahmin etmez
Ajan, emin olmadığı bir alan için sessizce bir değer uydurmaması için açıkça tasarlanmıştır. Belirsiz veya eksik bir alan her zaman doldurulmak yerine insan incelemesi için gün yüzüne çıkarılır — akış aşağısındaki veriyi güvenilir tutan şey budur.
Neleri İşler
Herhangi Bir Girdi Formatı
Gelen e-postalar, PDF'ler (taranmış belgeler dahil) ve serbest biçimli yapıştırılmış metinlerin tümü aynı hedef şemaya göre ayrıştırılır — ajan girdinin hangi formatta geldiğini önemsemez.
Yazmadan Önce Doğrulama
Herhangi bir yazma işleminden önce tip, zorunlu alan ve kısıtlama kontrolleri çalışır. Doğrulanamayan bir kayıt, akış aşağısındaki veriyi sessizce bozmak yerine insan incelemesine yönlendirilir.
İşaretler, Asla Tahmin Etmez
Belirsiz veya eksik alanlar, en iyi tahminle doldurulmak yerine incelenmek üzere gün yüzüne çıkarılır — ajan bilinçli olarak cömert değil, muhafazakardır.
Herhangi Bir İş Akışına Ekleyin
İş Akışı Düzenleyici'de bir düğüm olarak devreye alınır — herhangi bir gelen tetikleyiciden (e-posta, webhook veya dosya yükleme) sonra bağlayarak girdiyi daha ileri akmadan önce normalleştirin.
Girdi & Çıktı Sözleşmesi
| Alan | Anlamı |
|---|---|
| Ham İçerik | Ayrıştırılacak yapılandırılmamış girdi — bir e-posta gövdesi, PDF metni veya serbest biçimli metin bloğu. |
| Hedef Şema | Çıktı kaydının sağlaması gereken alanları, tipleri ve kısıtlamaları tam olarak açıklayan bir JSON Şeması veya Pydantic model tanımı. |
extracted_record | Girdiden üretilen, hedef şemaya uyan yapılandırılmış kayıt. |
validation_status | Kaydın şema doğrulamasını temiz bir şekilde geçip geçmediği, ya da incelemeye yönlendirilip yönlendirilmediği. |
flagged_fields | Hangi belirli alanların güvenle çıkarılamadığı ve nedeni (eksik, belirsiz veya bir kısıtlamayı sağlamadı). |
Nereye Uyuyor
ETL / Ayrıştırıcı Ajanı, tipik olarak dış, yapılandırılmamış veriyi içeri alan her işlem hattının ilk adımıdır — gelen bir satın alma siparişi e-postası, taranmış bir fatura, başka bir sistemden yapıştırılmış bir lead yakalama formu. Kayıtlar temiz, şemaya uygun bir şekle geldikten sonra iki taraflı veri eşleştirmesi için Mutabakat Ajanı ile doğal olarak eşleşir ve herhangi bir gelen tetikleyici düğümden hemen sonra İş Akışı Düzenleyici'ye bağlanabilir.