Aİ ajanlı bir belge inceleme iş akışı, her turda aynı adımları izleyebilir: açık olanları listelemek, konular içinde yanıtlamak, çözümlemek, yorumları bir sonraki taslağa taşımak ve temiz bir kopya üretmek. GroupDocs.Annotation.Mcp sunucusu her adımı bir araç olarak sunar, böylece Claude, Cursor veya GitHub Copilot’taki bir LLM, turu yerel olarak çalıştırabilir ve bir kişi sonucu onaylar:

List the annotations in output/contract_annotated.pdf. Which ones have no replies?

Yapılandırma ve sorun giderme ile adım adım sürüm belgelerde bulunabilir: AI ajanıyla bir belge inceleme döngüsü nasıl çalıştırılır.

Neden sabit bir sıralama olmadan inceleme turları sapar?

Bir inceleme turu nadiren sadece “yorum ekle” olur. O, hâlâ açık olanlar, kim tarafından getirildiği, bir yanıt, bir çözüm ve bir sonraki izleyici için temiz bir kopya demektir. İnsanlar bunu elle yaptıklarında sıra değişir, yanıtlar imzasız kalır ve bir sonraki taslak önceki yorumları kaybeder.

Her seferinde aynı sıralamayı izleyen bir ajan bu değişkenliği ortadan kaldırır. Ayrıca denetimin bakacağı yer olan sohbet dökümantasyonu yerine belgenin içinde bir iz bırakır.

İş akışı, adım adım

Her adım bir istem ve bir araç içerir.

  1. Açık olanları bul. İstem: “output/contract_annotated.pdf dosyasındaki ek açıklamaları listele. Hangilerinin yanıtı yok?” Ajan get_annotations çağrısını yapar; bu, her ek açıklamayı id, tip, mesaj, sayfa, sınırlayıcı kutu, kullanıcı ve yanıtlarıyla döndürür. Yanıtsız bir yorum, replies dizisi boş olanıdır, bu yüzden ajan zaten elinde bulunan listeyi filtreler.
  2. Konu içinde yanıtla. İstem: “Maria’nın 12 Mart’ta finansın şartları onayladığı yorumuna yanıt ver. Alex olarak imzala.” Ajan add_reply çağrısını annotationId, comment ve userName ile yapar. İsim varsayılan olarak mcp-user olur, bu yüzden gerçek bir isim iste.
  3. Tamamlananı çöz. Bir konvansiyon seç ve istemde belirt: yanıtı bırak ve konuyu kayıt olarak tut, ek açıklamayı remove_annotations ile kaldır, ya da mesajı [RESOLVED] ile başlayacak şekilde update_annotation ile düzenle.
  4. Turu bir sonraki taslağa taşı. İstem: “İncelenen kopyadan ek açıklamaları dışa aktar, ardından contract-v3.pdf dosyasına içe aktar.” Ajan export_annotations çağrısını yapar; bu bir XML dosyası yazar, ardından import_annotations çağrılır.
  5. Temiz bir kopya geri ver. İstem: “Tüm ek açıklamaları kaldır ve karşı tarafa temiz bir kopya ver.” ids parametresi olmadan remove_annotations tüm ek açıklamaları yeni bir dosyaya temizler.

Ajent ne karar verir, motor ne yapar?

Karar veya eylem Ajan Motor
Hangi yorumların yanıt gerektirdiği get_annotations sonucunu okur ve filtreler id, yazar ve yanıtlarıyla her ek açıklamayı döndürür
Yanıtın içeriği Talimatınıza göre taslak oluşturur Sağladığınız userName altında saklar
Hangi çözüm konvansiyonu uygulanır İstemdeki kurala uyar İstenen düzenleme veya kaldırmayı uygular
Turun tamamlanıp tamamlanmadığı Sayıları raporlar; insan onaylar Her değişikliğin sonucunu depolamaya kaydeder

Motor asla neyin çözüldüğüne karar vermez. Ek açıklama modelinde ayarlanacak bir “çözüldü” bayrağı yoktur; çözüm, siz promptta belirttiğiniz bir konvansiyondur.

İnsan nerede döngüde kalır?

İki yer. 5. adımdan önce, ajana kaç ek açıklamayı kaldırmak üzere olduğunu söylemesini isteyin ve cevabınızı bekleyin. Tüm ek açıklamaların kaldırılması, geri alma seçeneği olmayan iş akışındaki tek çağrıdır. Herhangi bir şey ekip dışına çıkmadan önce, ajanın taslakladığı yanıtları okuyun. Ek açıklama metni diğer kişilerden geldiği için, bir yorumu ajana talimat olarak değil, özetlenecek içerik olarak ele alın.

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

Bu, araçların belgelenmiş davranışlarından oluşturulmuş bir örneklem olup, yakalanmış bir ekran görüntüsü değildir.

You:   List the annotations in output/contract_annotated.pdf. Which ones have no replies?

Agent: [calls get_annotations on output/contract_annotated.pdf]
       Found 4 annotations. Two have no replies:
       - id 2, page 2, Maria: "Confirm the payment terms with finance."
       - id 4, page 5, Maria: "Delivery date conflicts with Schedule B."

You:   Reply to the first one that finance approved the terms on 12 March.
       Sign it as Alex.

Agent: [calls add_reply: annotationId=2, userName="Alex",
        comment="Finance approved the terms on 12 March."]
       Added reply to annotation 2 in output/contract_annotated.pdf.
       (The agent uses the saved file name in the next call.)

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

Belge klasörünüzü bağlayarak ve depolama klasöründen farklı bir çıktı klasörü belirterek Docker imajını çalıştırın:

docker run --rm -i -v $(pwd)/documents:/data \
  -e GROUPDOCS_MCP_OUTPUT_PATH=/data/output \
  ghcr.io/groupdocs-annotation/annotation-net-mcp:latest

Aynı komut ve dnx GroupDocs.Annotation.Mcp --yes alternatifi, Belge içinde gerçekleşen AI incelemesi, sohbet kaydında değil adresinde açıklanmıştır. Hub sayfası Claude Desktop, Claude Code, GitHub Copilot ile VS Code, Cursor, Windsurf ve diğer istemciler için kaydı içerir.

Dürüst sınırlamalar

  • Değerlendirme modu. Lisans olmadan, her sayfanın üstüne bir deneme rozeti eklenir; bu karşı tarafa gönderilecek bir şey değildir. Resmi bir incelemeden önce get_license_status kontrol edin.
  • Her yazma aracı sonucunu depolamaya geri kaydeder. Bu nedenle bir tur dosyalar zinciri üretir. Ajana önceki sonucun dosya adını bir sonraki adıma iletmesini ve bir şey düzenlemeden önce get_annotations ile dosyayı yeniden okumasını söyleyin; çünkü id’ler okuduğunuz belgeye aittir. Düzenlemeleri zincirlerken GROUPDOCS_MCP_OUTPUT_PATH değerini depolama klasöründen farklı bir klasöre ayarlayın. Varsayılan (çıktılar depolama klasörüne gider) ile ikinci yazma being used by another process hatası verir; ayrı bir çıktı klasörüyle add_reply, update_annotation ve remove_annotations üretildiği dosyada başarılı olur.
  • Koordinatlar olduğu gibi taşınır. Yeniden akışlandırılmış bir taslakta içe aktarılan not, orijinal metnin yakınında, tam üzerinde olmayabilir. Yerleşimi sonradan kontrol edin.
  • Linux’ta ön izleme. generate_pages_preview şu anda Linux’ta PDF dosyaları için, Docker imajı dahil, başarısız olur (Gdip için TypeInitializationException: System.Drawing.Common Windows dışı platformlarda desteklenmez); Word ve diğer Office belgeleri renderlanır ve Windows’ta dnx ile her format renderlanır. Diğer on araç etkilenmez. Bu gönderideki inceleme araçları ön izleme renderlayıcısını kullanmaz.

SSS

Bir AI PDF içindeki yorumlara otomatik olarak yanıt verebilir mi? Evet. Ajan get_annotations ile yorumları okur ve add_reply ile yanıt verir; bu, ek açıklama kimliğini, yanıt metnini ve bir yazar adını alır.

Yorumlar için çözülmüş bir durum var mı? Hayır. Araçların çözülmüş bayrağı yoktur; bu yüzden konuyu tutma, ek açıklamayı kaldırma veya mesajı [RESOLVED] ile ön ekleme gibi bir konvansiyon seçersiniz.

Belge revize edildiğinde yorumları koruyabilir miyim? Evet. İncelenen kopyadan ek açıklamaları XML olarak dışa aktarın ve yeni taslağa içe aktarın. Aynı araç çifti iki inceleyenin kopyasını birleştirir.

Daha derine