Přeskočit na hlavní obsah

ALVAO Service Desk MCP Server (Preview)

Tento modul obsahuje MCP server, který zpřístupňuje ALVAO Service Desk AI agentům jako je Microsoft Copilot. Modul je k dispozici od verze 26.2.

Technické požadavky a nasazení​

Tento modul je v režimu preview a zákazníkům je k dispozici na vyžádání. Pro instrukce k nasazení kontaktujte prosím ALVAO technickou podporu.

Nástroje agenta MS Copilotu​

Nástroj FindTickets​

  • Hledá požadavky na základě různých kritérií
  • Podporované filtry:
    • TicketId - ID konkrétního požadavku k vyhledání.
    • SearchTerm – Hledaný výraz pro vyhledávání požadavků v názvu, popisu atd.
    • State - Stav požadavku (např. "Otevřený", "Vyřešený", "Uzavřený" atd.).
    • Priority - Úroveň priority požadavku (např. "Nízká", "Střední", "Vysoká", "Kritická").
    • Requester - Jméno žadatele, který požadavek vytvořil.
    • Solver - Jméno přiřazeného řešitele požadavku.
    • Service - Název služby/sekce, ke které požadavek patří.
    • SlaName – název SLA spojený s požadavkem.
    • Expand - zda zahrnout související entity (např. "'requester,service,coRequesters,objects,state')1
    • Limit - Maximální počet požadavků k vrácení (výchozí: 50).
    • Skip - Počet požadavků k přeskočení pro stránkování.
    • OrderBy - Pole, podle kterého se řadí výsledky (výchozí: 'id').
    • OrderDirection - Směr řazení - 'asc' nebo 'desc' (výchozí: 'desc').
    • SpecialBehavior
    • vlastní položky

Nástroj ChangeTicketState​

  • Změnit stav požadavku
  • Podporované parametry:
    • TicketId - ID požadavku, jehož stav se má změnit.
    • StateName - Nový stav, který bude nastaven pro požadavek. Použijte buď toto NEBO stateId.
    • StateId - ID nového stavu, který bude nastaven pro požadavek. Použijte buď toto NEBO stateName.
    • CommentHTML – Nepovinný HTML komentář, který lze přidat při změně stavu.
    • CommentForApprovers - Nepovinný komentář určený výhradně pro schvalující (pokud je ke stavu potřeba schválení).
    • ** CommentForRequesters** - Volitelný komentář určený speciálně pro žadatele.
    • ** IncludeNextState** - Zda zahrnout další dostupné stavy v odpovědi (výchozí: ne).

Nástroj FindObjects​

  • Hledá objekty na základě různých kritérií
  • Podporované filtry:
    • ObjectId - ID konkrétního objektu, který se má získat.
    • Name - Název objektu k načtení.
    • Path - Cesta k objektu k načtení nebo k podstromu objektů.
    • Type - Typ objektu k načtení. (např. "Počítač", "Telefon").
    • SearchInTemplates - Výsledky zahrnou šablony.
    • ** PropertyName** + PropertyValue
      • Název vlastnosti, podle které se filtruje.
      • Hodnota vlastnosti, podle které se má filtrovat.
      • Obě musí být vyplněny, aby bylo možné použít filtr
    • SearchTerm – hledaný výraz používaný k vyhledávání objektů v názvu, popisu atd.
    • Limit - Maximální počet objektů k vrácení (výchozí: 50).
    • Skip - Počet objektů k přeskočení pro stránkování.
    • OrderBy - Pole, podle kterého se řadí výsledky (výchozí: 'id').
    • OrderDirection - 'asc' nebo 'desc' (výchozí: 'desc').

Nástroj MoveObject​

  • Přesune určený objekt na jinou destinaci.
  • Podporované parametry:
    • ObjectId – ID objektu, který má být přesunut.
    • NewParentObjectId - ID nového cílového objektu.
    • PathToObject - Cesta k objektu, který má být přesunut.
    • ** PathToDestination** - Cesta k nové destinaci.
  • ID jsou upřednostňována, cesty se používají pouze tehdy, když ID nejsou použita. Prázdná cílová destinace a cílová cesta vedou k přemístění na kořen stromu.

Nástroj GetTicketCommunication​

  • Podporované parametry:
    • TicketId - ID požadavku, jehož komunikaci chcete získat

AssignTicketToSolver​

  • Podporované parametry:

    • TicketId
    • Jeden z
      • ** SolverId**
      • SolverName
      • SolverTeamId
      • SolverTeamName

  • Pokud je nalezeno více řešitelů nebo týmů řešitelů, vrací se varování s seznamem dostupných řešitelů/týmů

GetRelationsOfTicket​

  • Podporované parametry:
    • TicketId

CreateMessage​

  • Vytvoří poznámku pro určený požadavek.
  • Podporované parametry:
    • TicketId
    • Subject
    • Message
    • ** MessageType**

UpdateTicket​

  • Podporované parametry:
    • TicketId
    • CustomItems

GetTicketCommunication​

  • Podporované parametry:
    • TicketId

AssignObjectToUser​

  • Snaží se najít osobu, pokud jich je nalezeno více (podle jména), vrací varování + seznam osob k výběru. Pokud byla nalezena přesně jedna osoba, snaží se přiřadit objekt (osobě zodpovědné za), pokud vlastnost není u objektu k dispozici, snaží se najít objekt osoby a přesunout přiřazený objekt jako jeho podřízený.
  • Podporované parametry:
    • Jeden z
      • ** ObjectId**
      • Path to object
    • Jeden z
      • ** PersonId**
      • Person Name*

GetInstalledSwOnDevice​

  • Podporované parametry:
    • Jeden z
      • ObjectId
      • PathToObject

GetLinksToObjects​

  • Podporované parametry:
    • Jeden z
      • ObjectId
      • PathToObject

GetLinksToTickets​

  • Podporované parametry:
    • Jeden z
      • ObjectId
      • PathToObject

FindKnowledge​

  • Podporované parametry:
    • Search term

ConfirmAction​

  • Podporované parametry:
    • UUID of sensitive action