SharePoint-luetteloiden työkalujen MCP-palvelinviittaus

Tärkeä

Sinun on oltava osa Frontier-esiversio-ohjelmaa, jotta pääset tutustumaan Microsoft Agent 365:een ennen sen käyttöä. Frontier yhdistää sinut suoraan Microsoftin uusimpiin tekoälyinnovaatioihin. Frontier-esiversioita koskevat asiakassopimusten nykyiset esikatseluehdot. Koska nämä ominaisuudet ovat vielä kehitteillä, niiden käytettävyys ja ominaisuudet voivat muuttua ajan mittaan.

Yleiskatsaus

Palvelintunnus	Display name	Description
mcp_SharePointListsTools	Microsoft SharePoint Lists MCP Server	MCP-palvelin, joka tarjoaa Microsoft Graph SharePoint -työkaluja luetteloita varten. MCP-palvelin, joka tarjoaa Microsoft Graph SharePoint -työkaluja luetteloita varten.

Käytettävissä olevat työkalut

sharepoint_createList

Luo uusi SharePoint-luettelo sivustoon.

Pakolliset parametrit

• siteId: Sivuston yksilöivä tunnus
• displayName: Luettelon näyttönimi
• list: luettelotiedot, kuten malli (esimerkiksi genericList, documentLibrary, issueTracking)

sharepoint_createListColumn

Luo uusi sarake (sarakeDefinition) tiettyyn SharePoint-luetteloon. Sinun on annettava kohdesivustoTunnus ja listId sekä kelvollinen sarakemääritys, joka määrittää sarakkeen nimen, näyttönimen ja täsmälleen yhden saraketyypin (kuten teksti, luku, valinta, päivämäärä/aika, personOrGroup, haku, totuusarvo tai hyperlinkOrPicture).

Pakolliset parametrit

• siteId: Sivuston yksilöivä tunnus
• listId: Luettelon yksilöivä tunnus
• name: Sarakkeen ohjelmointirajapinta/staattinen nimi (ei välilyöntejä, 1–64 merkkiä)

Valinnaiset parametrit

• displayName: Käyttäjälle suunnattu näyttönimi
• description: Sarakkeen kuvaus
• enforceUniqueValues: Jos arvo on tosi, arvojen on oltava yksilöllisiä
• hidden: Jos arvo on tosi, sarake on piilotettu
• indexed: Jos arvo on tosi, arvot indeksoidään
• pakollinen: Jos arvo on tosi, tarvitaan arvo
• readOnly: Jos arvo on tosi, arvoja ei voi muuttaa
• text, number, choice, boolean, dateTime, personOrGroup, lookup, hyperlinkOrPicture: Saraketyypin asetukset (yksi pakollinen)

sharepoint_createListItem

Luo uusi kohde SharePoint-luetteloon.

Pakolliset parametrit

• siteId: Sivuston yksilöivä tunnus
• listId: Luettelon yksilöivä tunnus
• fields: Luettelokohteen kenttien arvot (avain/arvokartta)

sharepoint_deleteListColumn

Poista olemassa oleva sarakeMäärite tietystä SharePoint-luettelosta. Anna siteId, listId ja columnId. Tämä toiminto poistaa sarakkeen pysyvästi luettelorakenteesta.

Pakolliset parametrit

• siteId: sivuston yksilöllinen tunnus
• listId: luettelon yksilöivä tunnus
• columnId: Poistettavan sarakkeen yksilöllinen tunnus

sharepoint_deleteListItem

Poista luettelon kohde.

Pakolliset parametrit

• siteId: Sivuston yksilöivä tunnus
• listId: Luettelon yksilöivä tunnus
• itemId: luettelokohteen yksilöivä tunnus

Valinnaiset parametrit

• ifMatch: Valinnainen ETag samanaikaisuuden ohjausobjektille (esimerkiksi "*")

sharepoint_editListColumn

Päivitä olemassa oleva sarakeMäärite tiettyyn SharePoint-luetteloon. Anna siteId, listId ja columnId. Leipäteksti on osittainen – sisällytä vain ominaisuudet, joita haluat muuttaa (kuten displayName-, description-, hidden-, required- tai fasettiasetukset).

Pakolliset parametrit

• siteId: sivuston yksilöllinen tunnus
• listId: luettelon yksilöivä tunnus
• columnId: Päivitettävän sarakkeen yksilöivä tunnus

Valinnaiset parametrit

• displayName: Käyttäjälle suunnattu näyttönimi
• description: Sarakkeen kuvaus
• hidden: Jos arvo on tosi, sarake on piilotettu
• pakollinen: Jos arvo on tosi, tarvitaan arvo
• enforceUniqueValues: Jos arvo on tosi, arvojen on oltava yksilöllisiä
• indexed: Jos arvo on tosi, arvot indeksoidään
• readOnly: Jos arvo on tosi, arvoja ei voi muuttaa
• text, number, choice, dateTime, personOrGroup, lookup, hyperlinkOrPicture: Päivitä saraketyypin asetukset

sharepoint_getSiteByPath

Ratkaise SharePoint-sivusto käyttämällä sen isäntänimeä ja palvelinkohtaista polkua.

Pakolliset parametrit

• hostname: SharePoint-vuokraajan isäntänimi (esimerkiksi contoso.sharepoint.com)
• serverRelativePath: palvelimen suhteellinen polku sivustoon (esimerkiksi sivustot/markkinointi)

sharepoint_listListColumns

Luettele tietyn SharePoint-luettelon sarakemääritykset (sarakeMääritysresurssit). Edellyttää siteId:n ja listId:n. Tukee OData-parameja, kuten $select, $top ja $skiptoken.

Pakolliset parametrit

• siteId: Sivuston yksilöivä tunnus
• listId: Luettelon yksilöivä tunnus

Valinnaiset parametrit

• select: Palautettavien ominaisuuksien pilkuin eroteltu luettelo
• filter: OData-suodatinlauseke tulosten rajoittamiseksi
• orderBy: Pilkuin eroteltu ominaisuusluettelo, jonka mukaan tilataan
• top: Sivun koko (1–999)
• skiptoken: Läpinäkymätön tunnus sivuttamiselle seuraavaan joukkoon

sharepoint_listListItems

Luetteloi kohteet SharePoint-luettelosta.

Pakolliset parametrit

• siteId: Sivuston yksilöivä tunnus
• listId: Luettelon yksilöivä tunnus

Valinnaiset parametrit

• expand: Valinnainen OData-laajennus (esimerkiksi kentät)
• top: Valinnainen sivun koko
• filter: Valinnainen OData-suodatinlauseke
• select: Valinnainen OData-valintalauseke

sharepoint_listLists

Luettele kaikki sivuston SharePoint-luettelot.

Pakolliset parametrit

• siteId: Sivuston yksilöivä tunnus

sharepoint_listSubsites

Luettele tietyn sivuston alisivustot (alisivustot).

Pakolliset parametrit

• siteId: Sivuston yksilöivä tunnus

sharepoint_search

Hae SharePointista Microsoft Graph Search -ohjelmointirajapinnan ja entityTypes=["site"] avulla.

Pakolliset parametrit

• requests: searchRequest-objektien matriisi

Valinnaiset parametrit

• entityTypes: Pitää olla ["sivusto"] SharePoint-sivuston hakuja varten
• query: Kyselyobjekti KQL-tyylisellä hakumerkkijonolla
• from: Ensimmäisen tuloksen nollaan perustuva siirtymä
• koko: Palautettavien tulosten määrä (1-50)
• fields: Valinnainen kenttäluettelo, joka valitaan vastauksessa

13. sharepoint_searchSitesByName

Hae SharePoint-sivustoista näyttönimen tai osittaisen URL-osoitteen (luonnollinen kieli) mukaan.

Pakolliset parametrit

• search: Haettavan SharePoint-sivuston näyttönimi tai osittainen nimi/URL-osoite

Valinnaiset parametrit

• consistencyLevel: Microsoft Graphin vaatima (oletus: lopulta)

14. sharepoint_updateListItem

Päivitä olemassa olevan luettelokohteen kentät.

Pakolliset parametrit

• siteId: Sivuston yksilöivä tunnus
• listId: Luettelon yksilöivä tunnus
• itemId: luettelokohteen yksilöivä tunnus
• fields: Päivitettävät kenttien arvot (osittain)

Valinnaiset parametrit

• ifMatch: Valinnainen ETag samanaikaisuuden ohjausobjektille (esimerkiksi "*" pakotettavaksi)

Tärkeimmät ominaisuudet

Luetteloiden hallinta

• Luo uusia SharePoint-luetteloita mallien avulla
• Luetteloi kaikki luettelon sivustossa
• Tuki erilaisille luettelomalleille (genericList, documentLibrary, issueTracking)

Sarake C – toiminnot

• Luo sarakkeita, joilla on useita tietotyyppejä (teksti, luku, valinta, päivämäärä/aika, personOrGroup, haku, totuusarvo, hyperlinkOrPicture)
• Aiemmin luotujen sarakkeiden muokkaaminen
• Sarakkeiden poistaminen
• Luettelon kaikkien sarakkeiden luettelo
• Sarakkeiden vahvistuksen ja yksilöllisyyden rajoitukset

Kohdetoiminnot

• Kenttien arvoja sisältävien luettelokohteiden luominen
• Päivitä olemassa olevat luettelokohteet (osittaiset päivitykset)
• Poista luettelon kohde.
• Suodatusta ja sivutusta sisältävien kohteiden luettelo
• Samanaikaisuuden hallinta ETagin kautta

Sivuston etsintä

• Hae sivustoja nimen tai URL-osoitteen mukaan
• Sivustojen ratkaiseminen isäntänimen ja polun mukaan
• Luetteloi alisivustoja
• KQL-tyylinen haku Microsoft Graph Search -ohjelmointirajapinnalla

OData-kyselytuki

• Valitse ominaisuudet $select avulla.
• Käytä $filter tulosten suodattamiseen.
• Sisällytä liittyvät entiteetit $expand avulla.
• Käytä $orderby tulosten lajittelemiseen.
• Käytä $top sivutusta varten.
• Käytä $skiptoken suurien tulosjoukkojen selaamiseen.

Saraketyypin tuki

• Tekstisarakkeet (yksiriviset tai moniriviset, vain- tai RTF-tekstit).
• Lukusarakkeet (desimaalien määrä, minimi- ja maksimiarvot).
• Valintasarakkeet (valintaruudut, avattava valikko tai valintanapit).
• Totuusarvosarakkeet.
• Päivämäärä ja kellonaika, Pvm ja aika, Vain päivämäärä
• Henkilö- tai Ryhmä-sarakkeet (yksittäinen tai useita valintoja).
• Hakusarakkeet (viittaa muihin luetteloihin).
• Hyperlinkki- tai kuvasarakkeet.

Huomautuksia

1. Kaikissa toiminnoissa käytetään Microsoft Graph -ohjelmointirajapinnan versiota 1.0.
2. Sarakkeiden nimissä on oltava 1–64 merkkiä ilman välilyöntejä.
3. Kunkin sarakkeen on määritettävä täsmälleen yksi saraketyyppi.
4. Samanaikaisuuden hallinta on käytettävissä otsikossa If-Match .
5. Sivuston haut edellyttävät, että consistencyLevel asetuksena on eventual.
6. Hakutulokset on rajoitettu 50 kohteeseen sivua kohden.
7. Osittaisia päivityksiä tuetaan sarakkeissa ja luettelokohteissa.