SharePoint-listák eszközei MCP kiszolgáló hivatkozás

Fontos

A Microsoft Agent 365-höz való korai hozzáféréshez a Frontier előzetes verziójának részeként kell lennie. A Frontier közvetlenül összekapcsolja Önt a Microsoft legújabb AI-innovációival. Gyakorlati ismereteket szerezhet az úttörő funkciókról, megoszthatja észrevételeit a termékcsapatokkal, és segíthet a mesterséges intelligencia jövőjének alakításában. A Frontier előzetesekre az ügyfélszerződések meglévő előzetes feltételei vonatkoznak. Mivel ezek a funkciók még fejlesztés alatt állnak, rendelkezésre állásuk és képességeik idővel változhatnak."

Áttekintés

Kiszolgálóazonosító	Megjelenítendő név	Description
mcp_SharePointListsTools	A Microsoft SharePoint listázza az MCP-kiszolgálót	MCP-kiszolgáló, amely Microsoft Graph SharePoint-eszközöket biztosít listákhoz. MCP-kiszolgáló, amely Microsoft Graph SharePoint-eszközöket biztosít listákhoz.

A rendelkezésre álló eszközök

sharepoint_createList (listalétrehozás)

Hozzon létre egy új SharePoint-listát egy webhelyen.

Kötelező paraméterek

• siteId: A webhely egyedi azonosítója
• displayName: A lista megjelenítendő neve
• lista: Lista információ, mint például sablon (genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Hozzon létre egy új oszlopot (columnDefinition) egy adott SharePoint-listában. Meg kell adnia a célhelyazonosítót és a listId azonosítót, valamint egy érvényes oszlopdefiníciót, amely megadja az oszlop nevét, megjelenítendő nevét és pontosan egy oszloptípust (például szöveg, szám, választási lehetőség, dateTime, personOrGroup, lookup, boolean vagy hyperlinkOrPicture).

Kötelező paraméterek:

• siteId: A webhely egyedi azonosítója
• listId: A lista egyedi azonosítója
• név: Az oszlop API-/statikus neve (szóközök nélkül, 1-64 karakter)

Választható paraméterek:

• displayName: Felhasználói megjelenítendő név
• leírás: Oszlop leírása
• enforceUniqueValues: Ha igaz, az értékeknek egyedinek kell lenniük
• rejtett: Ha igaz, az oszlop rejtett
• Indexelt: Ha igaz, a rendszer indexeli az értékeket
• szükséges: Ha igaz, értékre van szükség
• readOnly: Ha igaz, az értékek nem módosíthatók
• szöveg, szám, választási lehetőség, logikai érték, dateTime, personOrGroup, lookup, hyperlinkOrPicture: Oszloptípus beállításai (egy kötelező)

sharepoint_createListItem

Hozzon létre egy új elemet egy SharePoint-listában.

Kötelező paraméterek:

• siteId: A webhely egyedi azonosítója
• listId: A lista egyedi azonosítója
• Mezők: Mezőértékek a listaelemhez (kulcs/érték megfeleltetés)

sharepoint_deleteListColumn

Meglévő oszlopdefiníció törlése egy adott SharePoint-listából. Adja meg a siteId, listId és columnId azonosítót. Ez a művelet véglegesen eltávolítja az oszlopot a listasémából.

Kötelező paraméterek:

• siteId: A webhely egyedi azonosítója
• listId: A lista egyedi azonosítója
• columnId: A törölni kívánt oszlop egyedi azonosítója

sharepoint_deleteListItem

Listaelem törlése.

Kötelező paraméterek:

• siteId: A webhely egyedi azonosítója
• listId: A lista egyedi azonosítója
• itemId: A listaelem egyedi azonosítója

Választható paraméterek:

• ifMatch: Opcionális ETag az egyidejű feldolgozás vezérléséhez (pl. "*")

sharepoint_editListColumn

Egy meglévő oszlopdefiníció frissítése egy adott SharePoint-listában. Adja meg a siteId, listId és columnId azonosítót. A törzs részleges – csak a módosítani kívánt tulajdonságokat (például displayName, leírás, rejtett, kötelező vagy aspektusbeállítások) tartalmazza.

Kötelező paraméterek:

• siteId: A webhely egyedi azonosítója
• listId: A lista egyedi azonosítója
• columnId: A frissíteni kívánt oszlop egyedi azonosítója

Választható paraméterek:

• displayName: Felhasználói megjelenítendő név
• leírás: Oszlop leírása
• rejtett: Ha igaz, az oszlop rejtett
• szükséges: Ha igaz, értékre van szükség
• enforceUniqueValues: Ha igaz, az értékeknek egyedinek kell lenniük
• Indexelt: Ha igaz, a rendszer indexeli az értékeket
• readOnly: Ha igaz, az értékek nem módosíthatók
• szöveg, szám, választási lehetőség, dateTime, personOrGroup, keresés, hiperhivatkozásOrPicture: Oszloptípus beállításainak frissítése

sharepoint_getSiteByPath

A SharePoint-webhely azonosítása a hosztnév és a kiszolgálóhoz viszonyított útvonal segítségével.

Kötelező paraméterek:

• állomásnév: A SharePoint-bérlő állomásneve (például contoso.sharepoint.com)
• serverRelativePath: A webhely kiszolgálóhoz viszonyított elérési útja (például webhelyek/marketing)

sharepoint_listListColumns

Egy adott SharePoint-lista oszlopdefinícióinak (columnDefinition-erőforrások) listázása. SiteId és listId azonosítót igényel. Támogatja az OData-paramokat, például $select, $top és $skiptoken.

Kötelező paraméterek:

• siteId: A webhely egyedi azonosítója
• listId: A lista egyedi azonosítója

Választható paraméterek:

• kiválaszt: A visszaadandó tulajdonságok vesszővel tagolt listája
• szűrő: OData szűrőkifejezés az eredmények korlátozásához
• orderBy: Sorrendbe rendezendő tulajdonságok vesszővel tagolt listája
• felső: Oldalméret (1-999)
• skiptoken: Átlátszatlan token lapozáshoz a következő készlethez

sharepoint_listListItems

Elemek listázása SharePoint-listából.

Kötelező paraméterek:

• siteId: A webhely egyedi azonosítója
• listId: A lista egyedi azonosítója

Választható paraméterek:

• kibővít: Nem kötelező OData-kibontás (például mezők)
• felső: Nem kötelező oldalméret
• szűrő: Nem kötelező OData-szűrőkifejezés
• select: Nem kötelező OData select záradék

sharepoint_listLists

Az összes SharePoint-lista listázása egy webhelyen.

Kötelező paraméterek:

• siteId: A webhely egyedi azonosítója

sharepoint_listSubsites

Egy adott hely gyermekwebhelyeinek (alwebhelyeinek) listázása.

Kötelező paraméterek:

• siteId: A webhely egyedi azonosítója

sharepoint_search

Keresés a SharePointban a Microsoft Graph Search API-val, entityTypes=["site"].

Kötelező paraméterek:

• Kérelmek: SearchRequest objektumok tömbje

Választható paraméterek:

• entityTypes: SharePoint-webhelykeresésekhez a következőnek kell lennie: ["site"]
• lekérdezés: Objektum lekérdezése KQL-stílusú keresési sztringgel
• Tól: Az első eredmény nulláról kezdődő eltérése
• méret: Visszaadandó eredmények száma (1-50)
• Mezők: A válaszban kijelölendő mezők választható listája

13. sharepoint_searchSitesByName

SharePoint-webhelyek keresése megjelenítendő név vagy részleges URL-cím (természetes nyelv) alapján.

Kötelező paraméterek:

• keresés: A SharePoint-webhely nevének vagy részleges nevének/URL-címének megjelenítése a kereséshez

Választható paraméterek:

• konzisztenciaszint: A Microsoft Graph által megkövetelt (alapértelmezett: végleges)

14. sharepoint_updateListItem

Meglévő listaelem mezőinek frissítése.

Kötelező paraméterek:

• siteId: A webhely egyedi azonosítója
• listId: A lista egyedi azonosítója
• itemId: A listaelem egyedi azonosítója
• Mezők: Frissítendő mezőértékek (részleges)

Választható paraméterek:

• ifMatch: Nem kötelező ETag az egyidejűség-vezérléshez (például "*" kényszerítéshez)

A legfontosabb jellemzők    

Listakezelés

• Új SharePoint-listák létrehozása sablonokkal
• Az összes lista felsorolása egy webhelyen
• Különböző listasablonok (genericList, documentLibrary, issueTracking) támogatása

Oszlopműveletek

• Oszlopok létrehozása több adattípussal (szöveg, szám, választási lehetőség, dateTime, personOrGroup, keresés, logikai, hiperhivatkozásOrPicture)
• Meglévő oszlopok szerkesztése
• Oszlopok törlése
• Lista összes oszlopának listázása
• Oszlop érvényesítési és egyediségi feltételek

Elemműveletek

• Listaelemek létrehozása mezőértékekkel
• Meglévő listaelemek frissítése (részleges frissítések)
• Listaelemek törlése
• Listaelemek szűréssel és lapozással
• Egyidejűség-vezérlés az ETag használatával

Webhelyfelderítés

• Webhelyek keresése név vagy URL-cím alapján
• Webhelyek feloldása állomásnév és elérési út alapján
• Alwebhelyek listázása
• KQL-stílusú keresés a Microsoft Graph Search API-val

OData-lekérdezés támogatása

• Tulajdonságok kiválasztása $select használatával.
• Az eredmények szűréséhez használja a $filter.
• A kapcsolódó entitások belefoglalásához használja a $expand.
• Az eredmények rendezése $orderby használatával.
• Lapozáshoz használja a $top.
• A $skiptoken nagy eredményhalmazok lapozására használható.

Oszloptípusok támogatása

• Szövegoszlopok (egysoros vagy többsoros, egyszerű vagy gazdag szöveg).
• Számoszlopok (tizedesjegyekkel, minimális és maximális értékekkel).
• Választási lehetőségek oszlopai (jelölőnégyzetek, legördülő listák vagy választógombok).
• Logikai oszlopok.
• DateTime oszlopok (csak dátum vagy dátum és idő).
• Személy- vagy csoportoszlopok (egy vagy több kijelölés).
• Keresési oszlopok (hivatkozás más listákra).
• Hivatkozás vagy képoszlopok.

Jegyzetek

1. Minden művelet a Microsoft Graph API 1.0-s verziót használja.
2. Az oszlopneveknek szóközök nélkül 1–64 karakter hosszúságúnak kell lenniük.
3. Minden oszlopnak pontosan egy oszloptípust kell megadnia.
4. Az egyidejűség-vezérlés a If-Match fejlécen keresztül érhető el.
5. A webhelykeresésekhez consistencyLevel értékét eventual-re kell állítani.
6. A keresési eredmények oldalanként legfeljebb 50 elemet tartalmazhatnak.
7. Az oszlopok és listaelemek részleges frissítései támogatottak.