Odkaz na kalendář (náhled)

Note

Tento článek popisuje funkce používané v agentech nebo tocích agentů využívajících standardní harness.

Important

Toto je funkce Preview.

• Microsoft uvolňuje funkce ve verzi Preview před oficiálním vydáním, aby k nim zákazníci mohli získat předběžný přístup a poskytnout zpětnou vazbu.
• Funkce ve verzi Preview mají omezené funkce a nejsou určené pro produkční použití.
• Microsoft můžou změnit názvy a parametry nástrojů MCP ve verzi Preview. Vyhněte se pevně zakódovaným závislostem. Microsoft udržuje podporu scénářů.
• Funkce ve verzi Preview podléhají Microsoft dodatečným podmínkám použití.

Přehled

ID serveru	Adresa URL na úrovni tenanta	Zobrazované jméno	Description
mcp_CalendarTools	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_CalendarTools	Kalendář	Nástroje pro operace s kalendářem, jako je vytváření, aktualizace, vyhledávání událostí, správa pozvánek a kontrola dostupnosti.

Dostupné nástroje

mcp_CalendarTools_graph_acceptEvent

Přijměte zadanou pozvánku na událost v kalendáři uživatele.

Požadované parametry:

• eventId: ID události, která se má přijmout

Volitelné parametry:

• userId: ID uživatele nebo userPrincipalName
• komentář: Volitelný text zahrnutý v odpovědi
• sendResponse: Zda odeslat odpověď organizátorovi

mcp_CalendarTools_graph_cancelEvent

Zrušení události v kalendáři zadaného uživatele a upozorňovat účastníky.

Požadované parametry:

• eventId: Jedinečný identifikátor události, která se má zrušit

Volitelné parametry:

• userId: ID uživatele nebo userPrincipalName
• komentář: Nepovinná zpráva o zrušení

mcp_CalendarTools_graph_createEvent

Vytvořte novou událost kalendáře v kalendáři zadaného uživatele. Podporuje opakované události a online schůzky.

Požadované parametry:

• subject: Předmět události nebo název (bez závorky)
• start: Počáteční časové razítko s dateTime a timeZone
• end: Koncové časové razítko s dateTime a timeZone
• attendees_addresses: Pole e-mailových adres účastníků

Volitelné parametry:

• userId: ID uživatele nebo userPrincipalName
• body: Tělo události s typem obsahu (Text/HTML) a obsahem
• location: Umístění s displayName
• attendees_types: Role účastníků (povinný, volitelný, zdroj)
• attendees_names: Zobrazovaná jména účastníků
• recurrence: Způsob opakování a rozsah
• isOnlineMeeting: Nastavení na hodnotu true pro online schůzku
• onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeForConsumer
• allowNewTimeProposals: Povolit návrhy času (výchozí hodnota: true)
• transactionId: Idempotence identifikátor

mcp_CalendarTools_graph_declineEvent

Odmítne zadanou pozvánku na událost v kalendáři uživatele.

Požadované parametry:

• eventId: ID události, kterou chcete odmítnout

Volitelné parametry:

• userId: ID uživatele nebo userPrincipalName

• komentář: Volitelný text v odpovědi

• sendResponse: Zda odeslat odpověď

mcp_CalendarTools_graph_deleteEvent

Odstraňte událost z kalendáře zadaného uživatele.

Požadované parametry:

• eventId: Jedinečný identifikátor události k odstranění

Volitelné parametry:

• userId: ID uživatele nebo userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Navrhněte časy a místa schůzky na základě dostupnosti organizátora a účastníka.

Požadované parametry:

• meetingDuration: Doba trvání schůzky (například PT1H)

Volitelné parametry:

• userId: ID organizátora nebo userPrincipalName
• attendees_addresses: E-mailové adresy účastníků
• attendees_types: Typy účastníků
• attendees_names: Zobrazovaná jména účastníků
• timeConstraint: Časová dostupnost s timeslots a activityDomain
• locationConstraint: Možnosti umístění
• maxCandidates: Maximální počet návrhů
• isOrganizerOptional: příznak volitelného organizátora
• returnSuggestionReasons: Zahrnout důvody
• minimumAttendeePercentage: Minimální prahová hodnota docházky

mcp_CalendarTools_graph_getEvent

Získá jednu událost kalendáře z kalendáře zadaného uživatele.

Požadované parametry:

• eventId: Jedinečný identifikátor události

Volitelné parametry:

• userId: ID uživatele nebo userPrincipalName
• select: Parametr dotazu OData \$select
• expand: OData \$expand pro navigační vlastnosti

mcp_CalendarTools_graph_getSchedule

Získejte plán informací o volném čase pro uživatele, distribuční seznam nebo prostředek.

Požadované parametry:

• plány: Adresy SMTP uživatelů nebo prostředků
• startTime: Čas zahájení s dateTime a timeZone
• endTime: Koncový čas s dateTime a timeZone

Volitelné parametry:

• userId: ID uživatele nebo userPrincipalName
• availabilityViewInterval: Délka časového úseku v minutách

mcp_CalendarTools_graph_listCalendarView

Umožňuje načíst výskyty kalendáře v zadaném časovém rozsahu pro uživatele.

Požadované parametry:

• startDateTime: Začátek časového rozsahu (ISO 8601)
• endDateTime: Konec časového rozsahu (ISO 8601)

Volitelné parametry:

• userId: ID uživatele nebo userPrincipalName
• top: Maximální počet událostí
• orderby: Order by – klauzule

mcp_CalendarTools_graph_listEvents

Načte seznam událostí z kalendáře zadaného uživatele.

Volitelné parametry:

• userId: ID uživatele nebo userPrincipalName
• startDateTime: Začátek časového rozsahu (ISO 8601)
• endDateTime: Konec časového rozsahu (ISO 8601)
• top: Maximální počet událostí
• filter: dotaz filtru OData
• orderby: klauzule OData order by

mcp_CalendarTools_graph_updateEvent

Aktualizujte existující událost kalendáře v kalendáři zadaného uživatele.

Požadované parametry:

• eventId: Jedinečný identifikátor události

Volitelné parametry:

• userId: ID uživatele nebo userPrincipalName
• předmět: Aktualizovaný předmět
• body: Aktualizovaný obsah textu
• start: Aktualizovaný čas zahájení
• end: Aktualizovaný čas ukončení
• umístění: Aktualizované umístění
• attendees_addresses: Aktualizované e-maily účastníků
• attendees_types: Aktualizované typy účastníků
• attendees_names: Aktualizace jmen účastníků
• isCancelled: Nastavit na hodnotu true pro zrušení
• recurrence: Aktualizovaný způsob opakování

Klíčové funkce

Správa akcí

• Vytvářejte, čtěte, aktualizujte a mažte události.
• Přijímání, odmítání a rušení pozvánek.
• Podpora opakujících se událostí.
• Integrace s online schůzkami (Teams, Skype).

Dostupnost a plánování

• Získejte informace o dostupnosti/obsazenosti.
• Najděte časy schůzek pomocí kontroly dostupnosti.
• Kalendářní pohled s filtrováním časových rozmezí.
• Analýza dostupnosti účastníků.

Správa účastníků

• Spravujte povinné, nepovinné a zdroje jako účastníky.
• Podpora návrhů termínů.
• Sledujte odpovědi.
• Podpora distribučních seznamů.

Způsoby opakování

• Denní, týdenní, měsíční a roční vzorce.
• Absolutní a relativní recidiva.
• Datum ukončení nebo počet výskytů.
• Specifikace dne týdne a měsíce.

Online schůzky

• Integrace s aplikací Teams pro firmy
• Podpora Skypu pro firmy
• Podpora pro Skype (pro osobní použití)
• Automatické generování odkazu na schůzku

Poznámky

• Všechna časová razítka používají formát UTC/ISO 8601 s časovým pásmem.
• Kalendář MCP využívá UserprofileMCP k vyhledávání uživatelů v organizaci.
• E-mailové adresy musí mít platný formát.
• Pole účastníků (adresy, typy, jména) musí být ve stejném pořadí.
• Online schůzky vyžadují isOnlineMeeting=true a onlineMeetingProvider
• Opakování vyžaduje objekty vzoru i rozsahu.
• Časová pásma by měla být konzistentní napříč počátečními a koncovými časy.
• TransactionId idempotent umožňuje vytváření událostí.