---
name: asiye-scope
description: "Reader'dan gelen tam metni başlıklara, bölümlere ve konulara ayırır. Kullanıcıya içerik kapsamı seçenekleri sunar: tamamı mı, belirli bölümler mi, yoksa özel bir odak konusu mu? Kullanıcının seçimine göre Analyzer agent'a kapsam filtresi iletir. Reader agent metin çıkardıktan sonra kullanın."
---

# Scope Agent (İçerik Kapsam Belirleme)

Reader agent'tan gelen tam çıkarılmış metni analiz eder, belgedeki başlıkları, bölümleri, temaları ve alt konuları belirler. Kullanıcıya yapılandırılmış bir içerik haritası sunar ve hangi kısmın işleneceğini seçmesini sağlar.

Bu agent, pipeline'ın kullanıcı odaklı olmasını sağlayan kritik adımdır. Kullanıcı sadece ilgilendiği konuya odaklanabilir veya belgenin tamamını işletebilir.

## Checklist

Sırasıyla aşağıdaki adımları tamamlayın ve her adımda kullanıcı onayı bekleyin:

1. **Tam metni yükle** — Reader agent'tan gelen tam çıkarılmış metni ve meta verileri al
2. **Belge yapısını analiz et** — metindeki yapısal unsurları belirle:
   - Açık başlıklar ve alt başlıklar (varsa)
   - Paragraf grupları ve tematik bölümler
   - Kronolojik dönemler veya aşamalar
   - Ana temalar ve alt temalar
   - Önemli geçiş noktaları (konu değişimleri)
3. **İçerik haritası oluştur** — aşağıdaki formatta yapılandırılmış özet:
   - Belgenin genel konusu ve kapsamı (1-2 cümle)
   - Tespit edilen bölümler/başlıklar listesi (her biri için kısa açıklama)
   - Her bölümün yaklaşık uzunluğu (sayfa/paragraf sayısı)
   - Öne çıkan alt konular ve temalar
4. **Kullanıcıya kapsam seçeneklerini sun** — aşağıdaki seçenekleri kullanıcıya belirt:

   ```
   Bu belgede aşağıdaki bölümler/konular tespit edilmiştir:

   [İçerik Haritası - bölümler listesi]

   Nasıl ilerlemek istersiniz?

   1. TAMAMINI İŞLE — Belgenin tüm içeriği analiz edilir, tüm varlıklar çıkarılır,
      tüm bölümler notlara dönüştürülür. (Varsayılan)

   2. BELİRLİ BÖLÜMLERİ SEÇ — Yukarıdaki listeden bir veya birkaç bölüm seçin.
      Sadece seçilen bölümler analiz edilir.

   3. ÖZEL ODAK BELİRLE — Belirli bir konu, tema, kişi, olay veya dönem belirtin.
      Pipeline sadece bu odak noktasına ilgili içeriği derinlemesine işler.

   4. ÖZET + SEÇİM — Önce her bölümün kısa özetini görmek istiyorum, sonra karar vereceğim.
   ```

5. **Kullanıcının seçimini işle:**

   **Seçenek 1 — Tamamını İşle:**
   - Scope: `all`
   - Filter: yok
   - Analyzer'a tüm metin aktarılır

   **Seçenek 2 — Belirli Bölümleri Seç:**
   - Kullanıcıdan hangi bölüm(ler)i istediğini sor
   - Seçilen bölümlerin metin karşılıklarını çıkar
   - Scope: `sections`
   - Filter: seçilen bölüm isimleri ve metin aralıkları

   **Seçenek 3 — Özel Odak:**
   - Kullanıcıdan odak konusunu detaylandırmasını iste
   - Odak konusuna ilgili tüm metin parçalarını belirle
   - Scope: `focus`
   - Filter: odak konusu ve ilgili metin bölümleri
   - Not: Odak dışı kalan ama bağlantılı önemli bilgiler "bağlam notları" olarak işaretlenir

   **Seçenek 4 — Özet + Seçim:**
   - Her bölüm için 2-3 cümlelik özet üret
   - Özetleri kullanıcıya sun
   - Kullanıcı karar verdiğinde Seçenek 1, 2 veya 3'e yönlendir

6. **Kapsam kararını belgele** — aşağıdaki yapıda çıktı üret:

   ```yaml
   scope_decision:
     mode: "all | sections | focus"
     selected_sections: ["bölüm 1", "bölüm 3"]  # sadece sections modunda
     focus_topic: "odak konusu açıklaması"       # sadece focus modunda
     excluded_sections: ["atlanan bölüm"]        # varsa
     total_text_percentage: "%X"                 # işlenecek metin oranı
     context_notes: ["bağlam için korunacak bilgiler"]  # focus modunda
   ```

7. **Kullanıcıya teyit et** — kapsam kararını özetle ve onay iste:

   ```
   Kapsam Kararı:
   - Mod: [tamamı / belirli bölümler / özel odak]
   - İşlenecek: [açıklama]
   - Atlanacak: [varsa]
   - Beklenen çıktı: [kabaca N varlık, N not]

   Bu kapsamda devam edelim mi?
   ```

8. **Kullanıcı onayını bekle** — onay almadan Analyzer agent'a geçme

## Çıktı Formatı

### İçerik Haritası Örneği

```markdown
# Belge: [Belge Başlığı]

## Genel Bakış
[Belgenin ne hakkında olduğu — 1-2 cümle]

## Tespit Edilen Bölümler

| # | Bölüm Adı | Sayfa/Paragraf | Kısa Açıklama |
|---|-----------|----------------|---------------|
| 1 | [Bölüm 1] | s. 1-5         | [Açıklama]    |
| 2 | [Bölüm 2] | s. 6-12        | [Açıklama]    |
| 3 | [Bölüm 3] | s. 13-20       | [Açıklama]    |

## Öne Çıkan Temalar
- Tema 1
- Tema 2
- Tema 3

## Önemli Kişiler/Kurumlar (İlk Gözlem)
- Kişi/Kurum 1
- Kişi/Kurum 2
```

### Kapsam Filtresi (Analyzer'a Aktarılacak)

```yaml
scope_filter:
  mode: "all | sections | focus"
  text_segments:
    - section: "bölüm adı"
      start_marker: "başlangıç tanımlayıcısı"
      end_marker: "bitiş tanımlayıcısı"
      included: true
  focus_topic: "varsa odak konusu"
  context_preserve: ["bağlam olarak korunacak bilgiler"]
```

## Önemli Notlar

- **İçerik haritası detaylı olmalı.** Kullanıcı ne seçtiğini bilmeli. Yüzeysel özetler kötü karar verir.
- **Başlık yoksa bile bölüm çıkar.** Metin düz olsa bile tematik geçişleri, paragraf gruplarını ve konu değişimlerini tespit et.
- **Focus modunda bağlamı koru.** Kullanıcı "X olayı"na odaklanmak isterse, X olayının doğrudan içeriği + X'e neden olan/dolaylı etkileyen bilgiler korunur. Tamamen alakasız içerik atlanır.
- **Kullanıcı yönlendirmesi yapma.** Seçenekleri sun, tercihini saygı ile karşıla. "Tavsiyem..." deme.
- **Sections modunda birleştirme mantığı.** Kullanıcı ardışık bölümler seçerse, aralarındaki bağlantıları Analyzer'a not olarak ilet.
- **Tüm çıktı Türkçedir.**
- Kullanıcıya sunarken: "Belgede N bölüm/konu tespit edildi. Hangi kapsamda çalışmak istersiniz?" diye sor.