Tüm Ürünler
Search

Bu Ürün

    Platform For AI:Dosya türü giriş ve çıkış

    Belge Merkezi

    Platform For AI:Dosya türü giriş ve çıkış

    Son Güncelleme:Oct 04, 2026

    LangStudio iş akışları, sıfırdan dosya işleme altyapısı yazmadan kullanıcılardan dosyaları kabul edebilir, bunları işleme düğümleri aracılığıyla yönlendirebilir ve dosya çıktısı döndürebilir. Başlangıç düğümündeki dosya yüklemelerini Python veya belge ayrıştırma düğümlerine bağlamak ve işlenmiş dosyaları Bitiş düğümünden döndürmek için dosya türü değişkenlerini kullanın.

    Ön koşullar

    Başlamadan önce şunlara sahip olduğunuzdan emin olun:

    • En az bir Başlangıç düğümü ve bir Bitiş düğümü içeren bir LangStudio uygulama akışı

    • Bir OSS paketinde okuma ve yazma erişimi (tüm File türü işlemler için gereklidir)

    Başlangıç düğümünde dosya yüklemelerini kabul etme

    Bir iş akışının başında kullanıcılardan dosya kabul etmek için Başlangıç düğümünde bir dosya türü giriş değişkeni tanımlayın.

    image

    LangStudio, Başlangıç düğümü girişi için aşağıdaki dosya türlerini destekler:

    • Belge türleri: PDF, DOCX, PPTX, XLSX, XLS, TXT, MD, CSV, JSONL, HTML ve HTM

    • Görüntü türleri: JPG, JPEG, PNG, BMP ve TIFF

    • Ses türleri: MP3, WAV ve AAC

    • Video türleri: MP4, MOV, AVI, MKV, M4V, WMV, FLV, ASF ve QT

    Bir dosya türü değişkeni tanımladıktan sonra kullanıcılar sohbet panelinden Parameter Configuration yoluyla dosya yükleyebilir. İki yükleme yöntemi mevcuttur:

    • Upload From Local: Kullanıcının cihazından doğrudan bir dosya yükleyin.

    • Enter URL: Dosyayı işaret eden bir URL sağlayın. İki URL biçimi kabul edilir:

      • OSS URI: Alibaba Cloud OSS içindeki bir dosya yolu, örneğin oss://bucket-name/path/to/file.pdf.

      • HTTP/HTTPS bağlantısı: Herkese açık bir indirme bağlantısı, örneğin https://example.com/file.docx.

    image

    Dosyaları işleme

    Başlangıç düğümü dosyayı toplar; içeriği okumaz veya ayrıştırmaz. Dosyayı işlemek üzere bir alt akış düğümüne iletin.

    Hangi yaklaşımı kullanmalısınız?

    Senaryo Önerilen yaklaşım
    LLM işleme için standart belge biçimlerinden (PDF, DOCX, TXT ve benzerleri) metin ayıklama Belge Ayrıştırma düğümü
    Özel ikili işleme, biçim dönüştürme veya programatik olarak yeni dosyalar oluşturma Python düğümü

    Belge Ayrıştırma düğümü

    Yüklenen belgeleri, LLM düğümlerinde kullanmak üzere metin içeriklerini ayıklamak için bir Belge Ayrıştırma düğümüne yönlendirin. Ayrıntılar için bkz. Belge Ayrıştırma.

    Yaygın senaryo: Bir kullanıcı PDF yükler, Belge Ayrıştırma düğümü metni ayıklar ve bir LLM düğümü içeriğe dayanarak soruları yanıtlar.

    Python düğümü

    Bir Python düğümünde bir dosya türü değişkenini düğüm girişi olarak referans gösterin veya bir düğüm çıktısı olarak bir File nesnesi oluşturun.

    Not

    File , LangStudio'nun dosyaları temsil etmek için kullandığı temel türdür. Bunu from langstudio.types import File ile içe aktarın.

    LangStudio, File nesneleri oluşturmak için beş yöntem sağlar.

    Doğrudan yapılandırma

    Mevcut bir dosyayı konumuna göre referans göstermek için File() kullanın. Bu en basit yöntemdir ve zaten OSS'te depolanan veya URL üzerinden erişilebilen dosyalar için çalışır.

    Parametre Tür Gerekli Açıklama Örnek
    source_uri str Evet Dosyanın konumu. Bir HTTP/HTTPS URL'sini, bir OSS URI'sini (oss://) veya konteynerin bağlama yolu içindeki yerel bir yolu kabul eder. "https://files.example.com/report.pdf"
    download_url str Hayır İndirilebilir bir HTTP/HTTPS bağlantısı. Sağlanmazsa sistem otomatik olarak bir tane oluşturur. OSS URI'leri için yedi gün geçerli olan imzalı bir URL oluşturulur — süresi dolduktan sonra yenilemek için File.get_download_url() öğesini çağırın. "https://oss-cn-beijing.aliyuncs.com/my-bucket/...?Expires=...&OSSAccessKeyId=..."
    file_id str Hayır Dosya için benzersiz bir tanımlayıcı. Sağlanmazsa sistem 8 basamaklı evrensel benzersiz tanımlayıcı (UUID) oluşturur. "a1b2c3d4"
    file_name str Hayır Dosya adı. Sağlanmazsa sistem bunu source_uri adresinden çıkarır. "annual_summary_report.docx"
    file_type str Hayır Çok Amaçlı İnternet Posta Uzantıları (MIME) türü, örneğin application/pdf. Sağlanmazsa sistem bunu dosya adı uzantısından çıkarır. "application/vnd.openxmlformats-officedocument.wordprocessingml.document" 
    from langstudio.types import File

file = File(source_uri="https://example.com/report.pdf")
file = File(source_uri="oss://my-bucket/docs/file.docx")

    Dizeden yapılandırma

    Bir dosyayı dize içeriğinden oluşturmak için File.from_content() kullanın. Bu yöntem, Markdown, TXT ve CSV gibi metin tabanlı dosyalar oluşturmak için uygundur.

    Parametre Tür Gerekli Açıklama Örnek
    content str Evet Kaydedilecek dize içeriği. İçerik yüklenmeden önce UTF-8 olarak kodlanır. "# Generate Report\nThis content is automatically generated by the system."
    file_name str Evet Oluşturulan dosyanın adı. "report.md" 
    from langstudio.types import File

content = "# Generate Report\nThis content is automatically generated by the system."
file = File.from_content(content=content, file_name="report.md")

    Bayt dizisinden yapılandırma

    Bir dosyayı ikili verilerden oluşturmak için File.from_bytes() kullanın. Bu yöntem, PDF dosyaları, görüntüler ve Office belgeleri gibi ikili biçimler için uygundur.

    Parametre Tür Gerekli Açıklama Örnek
    content bytes Evet Kaydedilecek ikili veriler. b"%PDF-1.4\n1 0 obj\n<< /Type /Catalog >>\nendobj\n"
    file_name str Evet Oluşturulan dosyanın adı. "test.pdf" 
    from langstudio.types import File

# pdf_data is a bytes object
file = File.from_bytes(content=pdf_data, file_name="test.pdf")

    Yerel dosyadan yapılandırma

    Konteynerin yerel dosya sisteminden bir dosya yüklemek için File.from_local_file() kullanın. Bu yöntem, konteyner içinde bilinen bir yolda bulunan dosyalar için uygundur.

    Parametre Tür Gerekli Açıklama Örnek
    local_path str Evet Yerel dosya sistemindeki dosya yolu. "/tmp/report.docx"
    file_name str Hayır Oluşturulan dosyanın adı. Sağlanmazsa local_path adresindeki dosya adı kullanılır. "final_report.docx" 
    from langstudio.types import File

# The file already exists at /tmp/output.pptx
file = File.from_local_file(local_path="/tmp/output.pptx", file_name="presentation.pptx")

    Veri akışından yapılandırma

    Bir dosyayı akış kaynağından oluşturmak için File.from_stream() kullanın. Bu yöntem, büyük dosyalar veya veriler bir ağ akışı, bir BytesIO nesnesi veya başka bir yinelenebilir öğe olarak geldiğinde uygundur.

    Parametre Tür Gerekli Açıklama Örnek
    stream str | bytes | BinaryIO | Iterator[bytes] Evet Veri kaynağı. Bir HTTP/HTTPS URL dizesini, bir bytes nesnesini, bir io.BytesIO akışını, bir requests.Response nesnesini (stream=True ile) veya baytlardan oluşan herhangi bir yinelenebilir öğeyi kabul eder. "https://example.com/large-video.mp4"
    file_name str Evet Oluşturulan dosyanın adı. "downloaded_video.mp4" 
    import io
from langstudio.types import File

url = "https://example.com/data.jsonl"
file = File.from_stream(stream=url, file_name="data.jsonl")

    Bitiş düğümünden dosya çıktısı döndürme

    İş akışından bir dosya döndürmek için Bitiş düğümünün çıktısı olarak bir File nesnesi kullanın. Sohbet panelinde çıktı dosyasını görüntülemek ve indirmek için View other outputs öğesine tıklayın.

    image

    image

    image

    OSS izinlerini yapılandırma

    Tüm File türü işlemler bir OSS paketinde okuma ve yazma erişimi gerektirir. Çalışma zamanı oluştururken ve bir uygulama akışı dağıtırken aşağıdaki ayarları yapılandırın:

    1. Varsayılan çalışma alanı yolunu geçerli çalışma yolu olarak seçin.

      image

    2. Instance RAM Role için PAI Default Role öğesini seçin. Bunun yerine Custom Role seçerseniz özel role AliyunOSSFullAccess iznini verin. Bu izin olmadan LangStudio dosya giriş ve çıkış işlemlerini gerçekleştiremez.

      Çalışma zamanı oluşturun:

      image

      Uygulama akışı dağıtın:

      image