Bir AI ajanı, işaretlenmiş bir belgeden tüm yorumları çıkarabilir ve bunları üç şekilde raporlayabilir: bir özet, bir tablo veya bir XML arşivi. GroupDocs.Annotation.Mcp sunucusu, LLM’ye ek açıklamaları yapılandırılmış veri olarak verir ve Claude, Cursor veya GitHub Copilot yerel olarak akıl yürütmeyi yapar:

contract_annotated.pdf dosyasının incelemesini özetle: kaç yorum var, kimden ve ana temalar neler.

PDF’den ek açıklamaları çıkardığınızda ne elde edersiniz?

İşaretlenmiş bir belge, mürekkep kadar veri de içerir. get_annotations aracı, found (bulunan sayısı) ve annotations (dizi) içeren bir JSON nesnesi döndürür. Her giriş, ek açıklama id, type, message, page (1‑tabanlı), sınırlama kutusu, user ve varsa replies bilgilerini tutar. Belge ayrıştırması ve OCR kullanılmaz; bu yüzden ajan doğrudan ek açıklama kayıtlarından çalışır.

Araç, her çağrıda bir belge alır. Bir dosya kümesini kapsamak için dosyaları istemde adlandırın; ajan her dosya için aracı bir kez çağırır. Sunucu, klasör‑seviyesinde bir çağrı sunmaz.

Yöntem 1: Özet isteyin

Tek bir çağrı, ardından akıl yürütme. Dosyayı adlandırın ve özetin ne için olduğunu söyleyin.

contract_annotated.pdf dosyasının incelemesini özetle: kaç yorum var, kimden ve ana temalar neler.

Ajan get_annotations çağırır, girişleri sayar, user göre gruplar ve message alanlarında bulduğu temaları açıklar. Sayı ve yazarlar veri üzerinden gelir. Temalar, modelin metni okumasına dayanır; bu yüzden bir insan gözden geçirmesi gerekir.

Yöntem 2: Bir tablo veya filtrelenmiş liste iste

Veri yapılandırılmış olduğundan raporun şekli isteme bağlıdır:

Bana bir tablo ver: sayfa, yazar, yorum, yanıtlandı evet/hayır.

Yorumları inceleyen kişiye göre grupla ve en çok açık öğeye sahip olanı söyle.

Yalnızca üzeri çizili olanları listele. İnsanların neyi kaldırmak istediğini görmek istiyorum.

Hangi sayfalarda hiç yorum yok?

Son soru, bir PDF okuyucusunun zayıf yanıt verdiği, bir dizinin ise doğrudan cevaplayabildiği bir durumdur: “yanıtlandı”, boş olmayan bir replies listesi; “yorum olmayan sayfalar” ise page değerlerinde eksik olan sayfa numaralarıdır. Sayfa sayısı için get_document_info ile eşleştirin.

Yöntem 3: Yorumları XML olarak arşivle

Ek açıklamaları dışa aktar ki dosyayla birlikte tutabilelim.

export_annotations yalnızca ek açıklamaları içeren bir XML dosyası yazar. Başarı mesajı şu biçimdedir: Exported N annotation(s) from <file> to <name>.annotations.xml. Dosya küçüktür ve fark karşılaştırması yapılabilir; import_annotations başka bir belge kopyasına uygulanabilir. Bu, yorumların bir saklama kuralı altında olmaması gerektiğinde veya iki inceleme turunu karşılaştırmak istediğinizde faydalıdır: aynı belgenin iki dışa aktarımı iki metin dosyasıdır ve ajan aralarındaki değişiklikleri açıklayabilir.

Örnek oturum (kısaltılmış)

Bu, araçların belgelenen davranışına dayanarak hazırlanmış bir illüstrasyondur, yakalanmış bir ekran görüntüsü değildir.

You:   Summarize the review of contract_annotated.pdf and group it by reviewer.

Agent: [calls get_annotations on contract_annotated.pdf]
       Found 5 annotations: 4 from Maria, 1 from Dana.
       Maria: payment terms (page 2), delivery date (page 5),
         liability cap (page 6), a missing signature block (page 6).
       Replies: Alex answered the page 2 payment terms comment.
       Dana: a strikeout on page 4 marking an outdated clause.
       Maria comments without a reply: page 5 and the two on page 6.

Ajan yorumlar üzerinde işlem yapabilir mi?

Listeyi aktarabilir: yanıtlanmamış her yorum için bir sorun açabilir, bir yanıt e‑posta taslağı hazırlayabilir veya bir durum paragrafı yazabilir. Tek bir kural geçerlidir. Yorumlar başka kişilerden gelir, bu yüzden ajan ek açıklama metnini raporlayacağı içerik olarak ele almalı, talimat olarak değil. “Önceki talimatları yok say” gibi bir yorum, bir alandaki veridir. Özet ve rapor isteyin; kendi incelemeniz dışındaki değişiklikleri yapan eylemleri tutmayın.

Claude, Cursor veya Copilot için sunucuyu nasıl çalıştırırım?

Sunucu, ghcr.io/groupdocs-annotation/annotation-net-mcp Docker görüntüsüyle ya da dnx GroupDocs.Annotation.Mcp --yes (.NET 10 SDK) komutuyla NuGet üzerinden çalışır ve belgelerinizi tutan klasörü bağlar. Hub sayfası, Claude Desktop, Claude Code, VS Code with GitHub Copilot, Cursor, Windsurf ve diğer istemciler için kayıtları listeler.

Dürüst sınırlamalar

  • Değerlendirme modu. Her sayfanın üst kısmına bir deneme rozeti damgalanır. Bu, ek açıklama verisini değiştirmez; bu şekilde oluşturulan raporlar lisans olmadan da doğrudur. Gönderilebilecek şeyleri etkiler. Plan “işaretlenmiş kopyayı e‑posta et” ile bitiyorsa önce get_license_status kontrol edin.
  • Her çağrıda bir belge. Birçok dosya üzerinde tarama, birçok çağrı demektir ve her biri ajanın yapması ve raporlaması gereken bir araç çağrısıdır.
  • Dışa aktarım XML’dir. get_annotations ajan için JSON döndürür; export_annotations depolamaya XML yazar.
  • Ön izleme gerekmez. Üç yöntemin hiçbiri sayfa render etmez, bu yüzden Linux’taki generate_pages_preview PDF ön izleme sınırı onları etkilemez.

SSS

Bir PDF’den tüm yorumları nasıl dışa aktarırım? Ajanı ek açıklamaları dışa aktarması için isteyin. Ajan export_annotations çağırır, bu da belgelerinizin yanına bir XML dosyası yazar; ya da yorumları sohbet içinde listelemek isterseniz get_annotations çağırır.

AI, birkaç dosya üzerindeki inceleyen yorumları özetleyebilir mi? Evet. Dosyaları istemde adlandırın; ajan her birini get_annotations ile okur, ardından sonuçları tek bir özet içinde birleştirir. Her çağrıda bir dosya okunur.

Lisansım yoksa rapor değişir mi? Ek açıklama verisi değişmez. Yalnızca render edilen veya kaydedilen sayfalarda bir deneme rozeti bulunur.

Daha derine in