Word referansı (önizleme)

Note

Bu makale, standard harness ile desteklenen ajanlarda veya ajan akışlarında kullanılan özellikleri açıklamaktadır.

Important

Bu bir önizleme özelliğidir.

• Microsoft, müşterilerin erken erişim elde edebilmesi ve geri bildirim sağlayabilmesi için önizleme özelliklerini resmi bir sürümden önce yayınlar.
• Önizleme özellikleri sınırlı işlevlere sahiptir ve üretim kullanımı için tasarlanmamıştır.
• Microsoft, önizleme MCP araç adlarını ve parametrelerini değiştirebilir. Sabit kodlanmış bağımlılıklardan kaçının. Microsoft senaryo desteğini korur.
• Önizleme özellikleri Microsoft ek kullanım koşullarına tabidir.

Genel Bakış

Sunucu Kimliği	Kiracı düzeyinde URL	Ekran adı	Description
mcp_WordServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/ servers/mcp_WordServer	Microsoft Word	Microsoft Word belgeleriyle çalışmak için araçlar

Kullanılabilir araçlar

WordYeniBelgeOluştur

Kullanıcının OneDrive kökünde yeni bir Word belgesi oluşturur. Belge gövdesini doldurmak için istenen dosya adını (boş olabilir) ve HTML veya düz metin içeriği sağlayın. fileName boşsa, Document_yyyyMMdd_HHmms.docx gibi bir ad oluşturulur. Microsoft Graph oluşturulan DriveItem JSON değerini döndürür.

Gerekli parametreler:

• Dosyaadı: İstenen dosya adı (otomatik oluşturulan ad için boş olabilir)
• contentInHtml: Belge gövdesi için HTML veya düz metin içeriği

WordGetDocumentContent

Belirtilen SharePoint paylaşım URL’si kullanılarak OneDrive veya SharePoint’ten ham Word belgesi (DOCX) içeriğini getirir. Dosya adı, boyut driveId, , , documentIddüz metin içeriği ve bu belgedeki tüm açıklamaları içeren bir JSON yükü döndürür. Giriş, paylaşım bağlantısı (SharePoint veya OneDrive URL'si) olmalıdır.

Gerekli parametreler:

• URL: Belgenin SharePoint veya OneDrive paylaşım URL'si

WordYeniYorumOluştur

Word belgesine yeni bir açıklama ekler. driveId, documentId ve yorum metnini sağlayın.

Gerekli parametreler:

• driveId: Belgenin Sürücü Kimliği
• documentId: Belge Kimliği
• newComment: Eklenecek açıklama metni

Word Yorum Yanıtı

Word belgesindeki bir açıklamayı yanıtlar. commentId, driveId, documentId ve yanıt metnini sağlayın.

Gerekli parametreler:

• commentId: Yanıt için açıklamanın kimliği
• driveId: Belgenin Sürücü Kimliği
• documentId: Belge Kimliği
• newComment: Yanıt metni

Önemli Özellikler

Belge oluşturma

• doğrudan OneDrive Word belgeleri oluşturun.
• HTML ve düz metin içeriği desteği.
• ile timestampotomatik olarak oluşturulan dosya adları.
• Microsoft Graph DriveItem meta verilerini döndürür.

Belge erişimi

• SharePoint veya OneDrive URL'lerini kullanarak belge içeriğini getirin.
• DOCX dosyalarından düz metin içeriği ayıklayın.
• Tüm belge açıklamalarını alın.
• Dosya adı, boyut ve kimlikler gibi belge meta verilerini alın.

Yorum yönetimi

• Belgelere yeni açıklamalar ekleyin.
• Mevcut açıklamaları yanıtlayın.
• Tam açıklama yazışması desteği.

Notlar

• Kullanıcının OneDrive kökünde belgeler oluşturun.
• SharePoint veya OneDrive paylaşım URL'lerini kullanarak belgeleri alın.
• Belge alma işleminden elde edilen driveId ve documentId kullanarak yorum işlemlerini gerçekleştirin.
• Zengin belge biçimlendirmesi için HTML içeriğini destekleyin.
• Şu biçimi izleyen otomatik oluşturulan dosya adlarını kullanın: Document_yyyyMMdd_HHmms.docx