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 dostupný 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