Belge özelliklerini toplu olarak düzenlemek için bir AI ajanına bir standart ve bir klasör verin ve yerel olarak çalışan GroupDocs.Metadata.Mcp aracılığıyla okumasını, yazmasını ve doğrulamasını sağlayın. Başlamak için tek bir istem yeterlidir:
Klasörümdeki her belge için Company ve Author alanlarını sırasıyla “Acme Ltd” ve “Research Team” olarak ayarlayın, ardından hangi dosyaları değiştirdiğinizi bana bildirin.
Yapılandırma ve sorun giderme ile adım adım sürüm belgelerde bulunabilir: AI ajanı ile toplu olarak belge özelliklerini düzeltme.
Metaveri standartları neden kayar?
Şablonlar her yeni dosyada önceki şirketi bırakır. Bir ekip yeniden adlandırması yazar alanında eski adı bırakır. Bir geçiş mantıksız zaman damgaları bırakır. Kimse 200 dosyada özellikleri elle düzenlemez, bu yüzden kayma devam eder. Döngülü bir ajan bunun için doğru araçtır, ancak yalnızca düzenleme bir motor tarafından yapılırsa: bir yazarın değiştirilmesi için belgeyi “yeniden yazan” bir dil modeli içeriği yeniden üretirken, write_metadata bir alanı değiştirir ve gövdeyi aynı bırakır.
İş akışı nedir?
İş akışı dört adımdan oluşur ve her birinin bir istemi vardır. Claude Desktop, Claude Code, Cursor, GitHub Copilot veya sunucunun kayıtlı olduğu herhangi bir istemcide çalıştırın.
- Lisansı kontrol edin. Şu soruyu sorun: “Metaveri sunucusunun lisans durumu nedir?” Ajan
get_license_statusçağrısını yapar. Bunu toplu çalıştırmadan önce yapın, sonrasında değil. - Mevcut değerleri okuyun. Şu soruyu sorun: “İlk olarak her dosya için mevcut Author ve Company değerlerini listele.” Ajan
search_metadata‘yinameContainsile çağırır, bu sadece eşleşen özellikleri döndürür. - Sadece yanlış olanları yazın. Şu soruyu sorun: “Sadece yanlış olanları değiştir.” Ajan her dosya ve her özellik için
write_metadataçağrısı yapar. - Doğrulayın. Şu soruyu sorun: “Yeni dosyalarda Author ve Company’yi tekrar okuyun ve hâlâ farklı olanları, nedeniyle birlikte listeleyin.” Başarısızlıkları bir sayı yerine bir liste olarak isteyin.
Kararı kim verir: ajan mı yoksa motor mu?
| Karar | Kim tarafından |
|---|---|
| Kapsamdaki dosyalar ve hangi değerlerin yanlış olduğu | Ajan, sizin standardınızdan |
| Bir PDF, DOCX veya JPEG içinde hangi özellik adının hangi alana karşılık geldiği | Motor: write_metadata her format için dostane adı eşler |
| Bir formatta bir özelliğin mevcut olup olmadığı | Motor: uygulanamayan bir yazma işlemi 0 değişiklik rapor eder veya bir mesajla başarısız olur, asla sessiz bir başarı olmaz |
| Ne kaydedildi ve nerede | Araç: kaydedilen yol mesajını ve değiştirilen alan sayısını döndürür |
| Son durumun standarda uyup uymadığı | Ajan, geri okuyarak |
write_metadata property parametresi olarak Author, Title, Subject, Keywords, Comments, Copyright, Company veya Manager değerlerinden birini kabul eder. mode set (değiştir, varsayılan) veya add (ekle, Keywords gibi liste alanları için) olabilir.
Her düzenlemeyi koruyan kural nedir?
write_metadata her çağrıda bir özelliği ayarlar ve yeni bir dosya kaydeder. Tek bir belgede iki özellik iki çağrı demektir ve ikincisi birincinin sonucuna uygulanmalıdır. İkinci çağrı orijinal dosyadan başlarsa, ilk düzenleme kaybolur. Bir ajan her iki özelliğin de ayarlandığını ancak sadece birinin kaldığını rapor ettiğinde, bunun nedeni budur. Kuralı istemde belirtin:
İkinci değişikliği, orijinal dosyaya değil, birincisi tarafından üretilen dosyaya uygulayın.
Örnek oturum (kısaltılmış)
You: Set Company to "Acme Ltd" on every .docx in the folder. List current values first.
Agent: [calls search_metadata: nameContains = "Company", per file]
Agent: proposal-q1.docx Company = "Contoso GmbH" -> will change
handbook.docx Company = "Acme Ltd" -> already correct
notes.docx (no Company property) -> will add
You: Go ahead. Name each file you produced.
Agent: [calls write_metadata: property = Company, value = "Acme Ltd", mode = set]
Agent: 2 files changed, 1 unchanged. Each saved copy is named in the tool reply.
Bu, akışın bir illüstrasyonudur, yakalanmış bir ekran görüntüsü değildir.
Neden tüm klasörü tek seferde düzeltmiyoruz?
Kör bir toplu yazma, iyi değerleri daha kötü olanlarla değiştirebilir, bu yüzden okuma adımı kuru çalıştırmadır. Bu, her dosya için bir ekstra çağrı maliyetine sahiptir. Ölçülen lisanslama altında her çağrı kullanım olarak faturalandırılır ve 200 dosyada iki özellik taraması 400 yazma çağrısı artı okuma çağrıları demektir, bu yüzden önce filtreleyin, sonra yazın.
Formatlar farklıdır. Bir formatın yer almadığı bir özellik 0 değişiklik olarak rapor edilir veya bir mesajla başarısız olur, başarılıymış gibi davranmaz; bu doğru davranıştır ancak karışık bir klasör kısmi sonuç verebilir. Başarısızlıkları bir liste olarak isteyin.
Değerlendirme modundaki sınırlamalar nelerdir?
Değerlendirme modunda yalnızca ilk 5 belge özelliği okunabilir ve XMP ile EXIF kısmen kullanılamaz. Yazma da aynı şekilde sınırlıdır. Değerlendirme altındaki “kontrol et, ardından yaz” iş akışı kısaltılmış bir listeyi kontrol eder, bu yüzden düzeltmeye çalıştığınız özelliği kaçırabilir. get_license_status ile doğrulayın ve sonuca güvenmeden önce bir lisans dosyası veya ölçülen anahtarlar uygulayın. Ücretsiz 30 günlük geçici bir lisans mevcuttur.
Sıkça Sorulan Sorular
100 Word belgesindeki yazar bilgisini bir kerede değiştirebilir miyim?
Evet, klasörü ve değeri belirten bir istemle. Ajan Author özelliği için her dosyada bir write_metadata çağrısı yapar, bu da 100 dosya için 100 yazma çağrısı demektir.
Ajan orijinal dosyalarımı üzerine yazıyor mu?
Araç yeni bir dosya kaydeder ve yolunu döndürür, bu yüzden orijinal dosya çıktı değildir. Ajanın ürettiği her dosyayı adlandırmasını isteyin ve kopyaları doğrulayana kadar orijinalleri saklayın.
Ajan listede olmayan özel bir özelliği ayarlayabilir mi?
Belgelendirilmiş property değerleri Author, Title, Subject, Keywords, Comments, Copyright, Company ve Manager’dır. Başka bir şey araç tarafından tanımlananların dışındadır.
Daha Derine İnceleyin
- Documentation, canonical how-to: AI ajanı ile toplu olarak belge özelliklerini düzeltme
- Documentation hub: GroupDocs.Metadata MCP Sunucusu
- Start here: Belge paylaşmadan önce bir AI ajanına sorulacak 3 metaveri sorusu
- Related: Fotoğraf köken soruları, görüntüyü yüklemeden bir AI ajanı tarafından yanıtlandı
- Related: Neden metaveri temizlemek bir belgeyi paylaşmak için güvenli hâle getirmez
- On-premise and security model: AI belge işleme için 3 mimari ve dosyaları ağınız içinde tutan mimari
- Questions: GroupDocs Metadata forumu
- Source: GroupDocs.Metadata.Mcp GitHub’da