AMAGE AI - połączenie z AMAGE Software Suite

Dokument zostanie uzupełniony w późniejszym terminie. Pracujemy nad tym. Dziękujemy za cierpliwość.

Wstęp

AMAGE AI to moduł integrujący możliwości dużych modeli językowych (LLM) z danymi i funkcjami systemu AMAGE. Wykorzystuje on standard Model Context Protocol (MCP) do bezpiecznej i ustrukturyzowanej wymiany danych, umożliwiając asystentom AI wykonywanie zadań w kontekście danych przedsiębiorstwa.

Serwer MCP i integracja z AMAGE Software Suite oraz Chat AI

Integracja realizowana jest poprzez dedykowany serwer MCP zaimplementowany w aplikacji AMAGE Web. Komunikacja odbywa się z wykorzystaniem mechanizmu Server-Sent Events (SSE) do przesyłania powiadomień oraz REST API do obsługi żądań.

Protokół komunikacyjny

Serwer nasłuchuje na następujących endpointach:

  • SSE Endpoint: GET /ai/v1/sse/

    • Służy do nawiązania stałego połączenia z serwerem.

    • Serwer zwraca identyfikator sesji (sessionId) oraz endpoint do wysyłania wiadomości.

  • Message Endpoint: POST /ai/v1/sse/messages

    • Służy do wysyłania komunikatów JSON-RPC 2.0 do serwera.

    • Wymaga podania parametru sessionId.

Obsługiwane metody JSON-RPC

Serwer obsługuje następujące metody w ramach protokołu MCP:

  • initialize: Inicjalizuje sesję, negocjuje wersję protokołu i możliwości (capabilities).

  • tools/list: Zwraca listę dostępnych narzędzi (tools), do których użytkownik ma uprawnienia.

  • tools/call: Wywołuje określone narzędzie z przekazanymi parametrami.

  • ping: Służy do sprawdzania dostępności serwera (zwraca pong).

Dostępne funkcje i możliwości integracji z AMAGE Software Suite

Szczegółowa specyfikacja techniczna wszystkich dostępnych narzędzi, wraz z opisem parametrów i przykładami wywołań, znajduje się w osobnym dokumencie: Specyfikacja Narzędzi MCP.

Dostępność poszczególnych narzędzi jest ściśle powiązana z uprawnieniami użytkownika oraz licencjonowanymi modułami systemu AMAGE.

Dostęp do danych

Narzędzia te pozwalają asystentom AI na wyszukiwanie, pobieranie i analizę danych zgromadzonych w systemie.

Sprzedaż i Klienci (Sales)

  • Listowanie i wyszukiwanie klientów.

  • Pobieranie szczegółowych danych klienta (po ID lub UUID).

Zasoby (Assets)

  • Zaawansowane wyszukiwanie i filtrowanie zasobów (Query/Search).

  • Pobieranie listy zasobów i ich liczebności.

  • Pobieranie szczegółów zasobu, w tym schematu danych.

  • Analiza historii zmian parametrów zasobów.

  • Agregacja danych o zasobach.

Zlecenia (Work Orders)

  • Przeglądanie i wyszukiwanie zleceń pracy.

  • Pobieranie szczegółów zlecenia.

  • Listowanie typów zleceń.

Dzierżawy i Szalunki (Leases)

  • Wyszukiwanie i przeglądanie elementów szalunkowych.

  • Analiza danych dotyczących dzierżaw.

Serwis (Service)

  • Wyszukiwanie i przeglądanie zdarzeń serwisowych.

  • Dostęp do komentarzy w zdarzeniach serwisowych.

  • Listowanie typów zdarzeń.

Inspekcje (Inspection)

  • Przeglądanie szablonów i planów inspekcji.

Legislacja (Legislation)

  • Dostęp do bazy aktów prawnych (konteksty, dokumenty, artykuły, aspekty).

  • Pobieranie schematów danych legislacyjnych.

Dostawy i Magazyn (Logistics)

  • Przeglądanie dostaw i zamówień.

  • Sprawdzanie stanów magazynowych (Items).

  • Przeglądanie dokumentów magazynowych.

Wykonywanie operacji i akcji

Narzędzia te pozwalają asystentom AI na aktywne działanie w systemie, w tym modyfikację danych oraz sterowanie interfejsem użytkownika.

Akcje Interfejsu Użytkownika (UI Actions)

Asystent może sterować widokiem aplikacji użytkownika: * Pokaż listę zasobów: Otwiera widok listy z zadanymi filtrami. * Pokaż szczegóły zasobu: Przechodzi do karty konkretnego zasobu. * Pokaż w przeglądarce 3D (IFC): Otwiera model BIM zasobu. * Pokaż dokumentację: Otwiera przeglądarkę PDF. * Pokaż na mapie: Lokalizuje zasób na mapie.

Operacje na danych

  • Zlecenia: Tworzenie nowych zleceń pracy.

  • Serwis:

    • Rejestrowanie nowych zdarzeń serwisowych.

    • Dodawanie komentarzy do istniejących zdarzeń.

  • Inspekcje: Tworzenie nowych planów inspekcji.

  • Legislacja: Tworzenie nowych dokumentów i artykułów prawnych.

  • Magazyn: Modyfikacja daty dokumentu magazynowego.

Agenci AI

Dzięki powyższym narzędziom, Agenci AI mogą realizować złożone scenariusze, takie jak: * "Znajdź wszystkie pompy, które miały awarię w zeszłym miesiącu i pokaż je na mapie." * "Utwórz zgłoszenie serwisowe dla urządzenia o kodzie XYZ z opisem usterki." * "Podsumuj historię zmian parametru temperatury dla wybranego węzła." * "Wyszukaj przepisy prawne dotyczące utylizacji odpadów niebezpiecznych."