Work IQ: nástroje SharePoint MCP jsou dostupné v preview

Propojení SharePointu s vlastními aplikacemi a agenty pomocí Work IQ API

Nové nástroje SharePoint MCP v Work IQ

Jak Microsoft nedávno oznámil, nástroje SharePoint MCP, nyní dostupné v preview, zpřístupňují funkce SharePointu v Work IQ prostřednictvím koncového bodu MCP hostovaného SharePointem, který vyžaduje ověření identity. Pokrývají seznamy a knihovny, položky seznamů, soubory a složky, vyhledávání, schvalování, pravidla, Quick Steps, koš a správu verzí.

Katalog obsahuje více než 60 operací SharePointu, agent ale nemusí každou z nich registrovat ani zpřístupňovat jako samostatný nástroj. Work IQ nabízí pevně danou sadu obecných nástrojů a potřebné cesty k operacím SharePointu zjišťuje za běhu. Základní posloupnost tvoří search_paths pro vyhledání odpovídající operace, get_schema pro zjištění jejích argumentů a do_action pro vyvolání vrácené cesty s tělem požadavku. Díky tomuto zjišťování za běhu zůstává sada nástrojů agenta malá, zatímco dostupné funkce SharePointu se mohou dále rozšiřovat.

Poskytovatel pro SharePoint zpracovává cesty pod svým registrovaným prefixem sharepoint/. Volání probíhají pod identitou přihlášeného uživatele v SharePointu, takže agent může číst nebo měnit pouze to, k čemu už má daný uživatel oprávnění.

Operace vázané na konkrétní web obvykle používají neprůhledný identifikátor siteKey, nikoli přímo URL webu. Agent může pro daný web jednou zavolat get_site_key a vrácený klíč pak beze změny předávat dalším operacím. Operace zápisu používají interní názvy polí SharePointu. Hodnoty pro osoby, vyhledávací pole a taxonomii je proto nutné určit podle schématu, nikoli předpokládat, že budou přijaty zobrazované názvy.

Jak agent pracuje s nástroji SharePoint MCP v Work IQ

V praxi může agent nejprve určit kontext webu a poté vyhledat operaci pro hledání nebo práci se seznamem, která mu umožní najít relevantní dokument či jiný obsah. Konkrétní cesta a argumenty závisejí na daném postupu. Následující příklad ukazuje hypotetickou posloupnost:

1. get_site_key(siteUrl: "https://contoso.sharepoint.com/sites/project")
   → uchovejte vrácený siteKey pro tento web
2. search_paths(...)
   → zjistěte cestu SharePointu pro požadovanou operaci
3. get_schema(path: "<path returned by search_paths>")
   → ověřte požadované argumenty a jejich typy
4. do_action(
     "<discovered SharePoint path>",
     body: {
       siteKey: "<opaque key from get_site_key>",
       ...arguments shaped by get_schema...
     }
   )

Agenti mohou podle schématu vráceného nástrojem get_schema sestavit tělo body požadavku do_action. Nemusí odhadovat volitelná pole ani převádět zobrazované popisky na interní hodnoty. V rozhraní obecných nástrojů Work IQ mohou být argumenty jako items, folders nebo viewIds reprezentovány řetězcem obsahujícím JSON namísto vnořeného objektu. Agenti tak mohou za běhu přesně dodržet vrácené schéma a používat klíče webů pouze pro weby, pro které byly vytvořeny.

Vrácená data závisejí na zvolené operaci. Vyhledávací operace může vrátit odpovídající stránky, soubory, položky seznamů nebo jiné prostředky SharePointu spolu s identifikátory a URL, které agent využije při dalších voláních.

Bezpečnostní model nástrojů SharePoint MCP v Work IQ

Zabezpečení je zásadní součástí každé softwarové architektury. Microsoft v Work IQ zavádí dva nové rozsahy oprávnění, WorkIQ.Read a WorkIQ.Act, které umožňují přesnější nastavení přístupu. Poskytovatel nástrojů SharePointu v Work IQ tyto rozsahy respektuje. Pro přístup k nástrojům SharePointu v Work IQ tedy Váš agent musí mít buď WorkIQ.Read, nebo WorkIQ.Act.

Agenti pouze s rozsahem oprávnění WorkIQ.Read získají omezenou sadu nástrojů nejvyšší úrovně Work IQ: fetch, call_function, get_schema a search_paths. Uvedené nástroje odpovídají operacím, které nemění data. Agenti s rozsahem oprávnění WorkIQ.Act získají úplnou sadu nástrojů.

V obou případech jde o delegovaná oprávnění v souladu s bezpečnostním modelem Work IQ. Každá operace se provádí jménem uživatele, a je proto omezena na akce, ke kterým už má tento uživatel oprávnění.

Tvorba inteligentních agentů s Work IQ

Pokud Váš agent potřebuje pracovat s obsahem webu nebo provádět operace v SharePointu, můžete vyzkoušet postup, při kterém nejprve zjistí dostupnou operaci a její schéma a následně ji vykoná. Při testování prozkoumejte vrácená schémata a data, abyste mohli nové nástroje správně využít ve svých agentech.