API / Serwer MCP

Twoje dane. Więcej możliwości.

Połącz planowanie zasobów z systemami i narzędziami AI, których już używasz. Pobieraj informacje, twórz własne zestawienia i wykonuj obsługiwane działania z kontrolowanym dostępem.

Dla Twoich systemów

REST API

Pobieraj uporządkowane dane JSON do raportów, integracji i własnych procesów. Obsługiwane operacje zapisu pozwalają tworzyć i aktualizować informacje w RessursAgent.

  • Twórz raporty i zestawienia
  • Łącz dane projektów i zasobów między systemami
  • Automatyzuj obsługiwane zadania
Dla Twoich narzędzi AI

Serwer MCP

Model Context Protocol pozwala zgodnemu klientowi AI korzystać z RessursAgent jako narzędzia. Pytaj o dane organizacji i zlecaj obsługiwane działania z użyciem swojego konta i uprawnień.

  • Pytaj o plan własnymi słowami
  • Zestawiaj zdolności, potrzeby i kwalifikacje
  • Zlecaj zmiany w granicach swoich uprawnień

Obiekty, pola i działania.

Zobacz, co Twoje systemy i narzędzia AI mogą odczytywać, tworzyć i zmieniać w RessursAgent. Przegląd obejmuje główne obiekty i wybrane pola obsługiwane przez REST API i MCP.

Nazwy pól odpowiadają rzeczywistym nazwom w modelu danych. Pola zapisu dotyczą tworzenia, aktualizacji lub osobnego działania; nie wszystkie można zmienić po utworzeniu. Projekty i zasoby łączy się zwykle za pomocą identyfikatora.

Zasoby i projekty

Personel, maszyny, dane kontaktowe, stanowiska, branże, okresy projektów, klienci i lokalizacje.

Zasoby: pracownicy i sprzęt

  • Odczyt
  • Tworzenie
  • Zmiana

Pola do odczytu

  • name
  • resource_type
  • ownership
  • is_active
  • discipline
  • position
  • department
  • email
  • phone
  • equipment_type
  • equipment_model
  • supplier
  • work_base_address
  • external_id

Pola do zapisu

  • name
  • resource_type
  • ownership
  • is_active
  • discipline
  • position
  • department
  • email
  • phone
  • equipment_type
  • equipment_model
  • supplier
  • employed_from
  • employed_until
  • work_base_address
  • external_id
  • note

Projekty

  • Odczyt
  • Tworzenie
  • Zmiana

Pola do odczytu

  • name
  • project_number
  • status
  • start_date
  • end_date
  • customer_name
  • location_address
  • project_type
  • is_template

Pola do zapisu

  • name
  • project_number
  • status
  • start_date
  • end_date
  • customer_name
  • location_address
  • location_postal_code
  • external_id
  • worklist_code
  • note
  • project_type
  • is_template

Karty HMS

  • Odczyt
  • Zmiana
  • Usuwanie

Pola do odczytu

  • resource_id
  • card_id
  • expires_at

Pola do zapisu

  • card_number
  • expires_at

Numer karty nie jest zwracany. Rejestracja wymaga zalogowanego użytkownika ze specjalnymi uprawnieniami HMS. Datę ważności można odnowić osobno.

Plan, potrzeby i zdolności

Przydziały, alokacja, zapotrzebowania na zasoby, niedostępność i obliczone zdolności dla każdego zasobu i dnia.

Przydziały

  • Odczyt
  • Tworzenie
  • Zmiana
  • Usuwanie

Pola do odczytu

  • project_id
  • resource_id
  • start_date
  • end_date
  • allocation_percent
  • activity_id
  • project_position
  • work_schedule_template_id

Pola do zapisu

  • project_id
  • resource_id
  • start_date
  • end_date
  • allocation_percent
  • work_schedule_template_id
  • work_schedule_anchor_date

Zapotrzebowanie na zasoby

  • Odczyt
  • Tworzenie
  • Zmiana
  • Usuwanie

Pola do odczytu

  • project_id
  • resource_type
  • status
  • quantity
  • start_date
  • end_date
  • allocation_percent
  • position
  • equipment_model
  • activity_id

Pola do zapisu

  • project_id
  • resource_type
  • quantity
  • start_date
  • end_date
  • allocation_percent
  • discipline
  • position
  • equipment_type
  • equipment_model
  • work_schedule_template_id

Zapotrzebowania można także zgłaszać, odrzucać, anulować i realizować za pomocą osobnych działań.

Nieobecności i niedostępność

  • Odczyt
  • Tworzenie
  • Usuwanie

Pola do odczytu

  • resource_id
  • start_date
  • end_date
  • reason
  • unavailable_percent

Pola do zapisu

  • resource_id
  • start_date
  • end_date
  • reason
  • unavailable_percent

Obliczona dostępność

  • Odczyt

Pola do odczytu

  • resource_id
  • capacity_date
  • scheduled_hours
  • scheduled_capacity_percent
  • unavailable_percent
  • effective_capacity_percent

Tylko odczyt

Są to obliczone wyniki dostępne do odczytu. Możesz na nie wpływać, zmieniając dane źródłowe, takie jak przydziały, okresy, lokalizacje i kwalifikacje.

Kwalifikacje i zmiany

Katalog kwalifikacji, zarejestrowane kwalifikacje i ich ważność, wymagania projektów, szablony zmian i wyjątki dzienne.

Katalog kwalifikacji

  • Odczyt
  • Tworzenie
  • Zmiana
  • Usuwanie

Pola do odczytu

  • name
  • code
  • category
  • description
  • requires_expiry
  • source_system

Pola do zapisu

  • name
  • code
  • category
  • description
  • is_hms_card
  • requires_expiry

Kwalifikacje zasobu

  • Odczyt
  • Tworzenie
  • Zmiana
  • Usuwanie

Pola do odczytu

  • resource_id
  • competency_id
  • level
  • valid_from
  • valid_until
  • documentation_status
  • source_system

Pola do zapisu

  • resource_id
  • competency_id
  • level
  • valid_from
  • valid_until
  • certificate_number
  • comment
  • documentation_confirmed

Kwalifikacje należące do zewnętrznego systemu źródłowego należy aktualizować w tym systemie. Numery certyfikatów i komentarze można zapisać, lecz nie są zwracane w tym obiekcie odczytu.

Wymagania kwalifikacyjne

  • Odczyt
  • Tworzenie
  • Zmiana
  • Usuwanie

Pola do odczytu

  • scope
  • entity_id
  • competency_id
  • is_mandatory
  • resource_type
  • valid_from

Pola do zapisu

  • scope
  • entity_id
  • competency_id
  • is_mandatory
  • resource_type
  • valid_from
  • comment

Szablony zmian

  • Odczyt
  • Tworzenie
  • Zmiana
  • Usuwanie

Pola do odczytu

  • name
  • workday_pattern
  • hours_pattern
  • standard_hours_per_workday
  • start_weekday
  • project_scope
  • is_active
  • is_night_shift

Pola do zapisu

  • name
  • description
  • workday_pattern
  • hours_pattern
  • standard_hours_per_workday
  • start_weekday
  • project_scope
  • project_ids
  • is_active
  • is_night_shift

Wyjątki dzienne

  • Odczyt
  • Tworzenie
  • Zmiana
  • Usuwanie

Pola do odczytu

  • resource_id
  • exception_date
  • exception_type
  • planned_hours

Pola do zapisu

  • resource_id
  • exception_date
  • exception_type
  • planned_hours
  • comment

Plany szkoleń

  • Odczyt
  • Zmiana

Pola do odczytu

  • competency_id
  • plans

Pola do zapisu

  • resource_ids
  • planned_on
Zespoły, współpraca i analizy

Zespoły planistyczne i projektowe, członkowie, zadania i role projektowe. REST API i MCP udostępniają również klastry geograficzne, pary współpracowników i obliczone propozycje zamian.

Zespoły planowania

  • Odczyt
  • Tworzenie
  • Zmiana

Pola do odczytu

  • name
  • leader_resource_id
  • end_date
  • archived_at

Pola do zapisu

  • name
  • leader_resource_id
  • end_date
  • competency_ids

Zespoły projektowe

  • Odczyt
  • Tworzenie
  • Zmiana
  • Usuwanie

Pola do odczytu

  • project_id
  • name
  • note
  • work_schedule_template_id
  • planned_start_date
  • planned_end_date

Pola do zapisu

  • project_id
  • name
  • note
  • work_schedule_template_id
  • planned_start_date
  • planned_end_date

Członkowie zespołu

  • Odczyt
  • Tworzenie
  • Zmiana
  • Usuwanie

Pola do odczytu

  • project_team_id
  • resource_id
  • is_lead

Pola do zapisu

  • project_team_id
  • resource_id
  • is_lead

Działania projektowe

  • Odczyt
  • Tworzenie
  • Zmiana
  • Usuwanie

Pola do odczytu

  • project_id
  • name
  • code
  • parent_id
  • sort_order
  • lead_resource_id
  • planned_start_date
  • planned_end_date

Pola do zapisu

  • project_id
  • name
  • description
  • code
  • note
  • lead_resource_id
  • planned_start_date
  • planned_end_date
  • parent_id
  • position

Role projektowe

  • Odczyt
  • Tworzenie
  • Zmiana
  • Usuwanie

Pola do odczytu

  • project_id
  • resource_id
  • role
  • responsibility
  • effective_from
  • effective_until

Pola do zapisu

  • project_id
  • resource_id
  • role
  • responsibility
  • effective_from
  • effective_until

Powiązane zasoby

  • Odczyt
  • Tworzenie
  • Zmiana
  • Usuwanie

Pola do odczytu

  • name
  • project_id
  • start_date
  • end_date
  • note
  • members

Pola do zapisu

  • name
  • project_id
  • start_date
  • end_date
  • note
  • members

Klastry geograficzne

  • Odczyt

Pola do odczytu

  • axis
  • radius_km
  • resource_category
  • project_count
  • resource_count
  • span_km
  • projects
  • members

Tylko odczyt

Są to obliczone wyniki dostępne do odczytu. Możesz na nie wpływać, zmieniając dane źródłowe, takie jak przydziały, okresy, lokalizacje i kwalifikacje.

Relacje współpracy

  • Odczyt

Pola do odczytu

  • resource_id
  • partner_id
  • strength
  • overlap_days
  • shared_project_count
  • has_operator_link
  • has_shared_project_team

Tylko odczyt

Są to obliczone wyniki dostępne do odczytu. Możesz na nie wpływać, zmieniając dane źródłowe, takie jak przydziały, okresy, lokalizacje i kwalifikacje.

Propozycje optymalizacji

  • Odczyt

Pola do odczytu

  • type
  • score
  • start_date
  • end_date
  • project_ids
  • incoming_resource_ids
  • outgoing_resource_ids
  • travel_saving_km
  • own_production_gain
  • manual_planning_required

Tylko odczyt

Są to obliczone wyniki dostępne do odczytu. Możesz na nie wpływać, zmieniając dane źródłowe, takie jak przydziały, okresy, lokalizacje i kwalifikacje.

Oferty i rejestry

Oferty ze statusem, prawdopodobieństwem i potrzebami. Tagi, stanowiska, branże, typy i modele maszyn, dostawcy oraz bazy maszyn.

Oferty i symulacja

  • Odczyt
  • Tworzenie
  • Zmiana
  • Usuwanie

Pola do odczytu

  • name
  • customer_name
  • status
  • win_probability
  • start_date
  • end_date
  • estimated_value
  • currency_code
  • simulation_inclusion

Pola do zapisu

  • name
  • customer_name
  • status
  • win_probability
  • start_date
  • end_date
  • estimated_value
  • currency_code
  • requirements
  • simulation_inclusion

Wymagania oferty obejmują kategorię, odwołanie do katalogu, ilość i okres (category, catalog_item_id, quantity, start_date, end_date). Status i udział w symulacji zmienia się osobnymi działaniami.

Kluczowe osoby w ofercie

  • Odczyt
  • Tworzenie
  • Usuwanie

Pola do odczytu

  • bid_opportunity_id
  • resource_id
  • responsibility

Pola do zapisu

  • bid_opportunity_id
  • resource_id
  • responsibility

Tagi

  • Odczyt
  • Tworzenie
  • Zmiana
  • Usuwanie

Pola do odczytu

  • name

Pola do zapisu

  • name

Tagi można również przypisywać do projektów, zasobów i zapotrzebowań lub z nich usuwać.

Stanowiska, branże, typy sprzętu, modele sprzętu i dostawcy

  • Odczyt
  • Tworzenie
  • Zmiana
  • Usuwanie

Pola do odczytu

  • name

Pola do zapisu

  • name

Bazy sprzętowe

  • Odczyt
  • Tworzenie
  • Zmiana
  • Usuwanie

Pola do odczytu

  • name
  • postal_code

Pola do zapisu

  • name
  • postal_code

Stawki wynajmu dla stanowisk i modeli sprzętu

  • Odczyt
  • Zmiana

Pola do odczytu

  • kind
  • hire_day_rate
  • hire_currency_code

Pola do zapisu

  • hire_day_rate
  • hire_currency_code
Powiadomienia i historia

Powiadomienia, zdarzenia, komentarze i ograniczony wyciąg z dziennika zmian. Wymaga dostępu do odpowiednich obszarów danych.

Powiadomienia

  • Odczyt

Pola do odczytu

  • notification_event_id
  • recipient_resource_id
  • status
  • read_at
  • dismissed_at
  • scheduled_for

Tylko odczyt

Zdarzenia powiadomień

  • Odczyt

Pola do odczytu

  • event_type
  • entity_type
  • entity_id
  • project_id
  • severity
  • title
  • message
  • occurred_at

Tylko odczyt

Dziennik zmian

  • Odczyt

Pola do odczytu

  • entity_type
  • entity_id
  • action
  • message
  • actor_display_name
  • source
  • created_at

Tylko odczyt

Komentarze

  • Odczyt
  • Tworzenie
  • Zmiana
  • Usuwanie

Pola do odczytu

  • entity_type
  • entity_id
  • comment
  • applies_from
  • applies_until
  • version

Pola do zapisu

  • entity_type
  • entity_id
  • comment
  • applies_from
  • applies_until
  • expected_version
Twoje własne informacje

Użytkownicy Profilu mogą pobierać własny plan, kompetencje i zmiany przez osobisty dostęp API/MCP. Połączenie respektuje uprawnienia zalogowanego użytkownika i wymaga powiązania z zasobem osobowym.

Twój profil

  • Odczyt

Pola do odczytu

  • name
  • discipline
  • position
  • phone
  • email
  • supplier
  • employed_from

Tylko odczyt

Odczytuje własne dane zalogowanego pracownika i wymaga powiązania z zasobem osobowym.

Twój plan

  • Odczyt

Pola do odczytu

  • projectName
  • startDate
  • endDate
  • activityName
  • projectPosition
  • meetingPoint
  • managerName
  • managerPhone
  • allocationPercent
  • machineNames
  • schedule

Tylko odczyt

Odczytuje własne dane zalogowanego pracownika i wymaga powiązania z zasobem osobowym.

Twoje kwalifikacje

  • Odczyt

Pola do odczytu

  • register
  • gaps
  • met
  • competencyName
  • status
  • level
  • validFrom
  • validUntil

Tylko odczyt

Odczytuje własne dane zalogowanego pracownika i wymaga powiązania z zasobem osobowym.

Twoje zmiany

  • Odczyt

Pola do odczytu

  • resource_id
  • changes

Tylko odczyt

Odczytuje własne dane zalogowanego pracownika i wymaga powiązania z zasobem osobowym.

Od informacji do praktycznych korzyści.

Przykłady / procesy z API

  1. Aktualizuj rejestr zasobów

    Twórz pracowników lub sprzęt i aktualizuj dane kontaktowe, dział, branżę oraz odniesienia zewnętrzne.

  2. Powiąż dane projektowe z planowaniem

    Aktualizuj okresy projektów i dane klientów. Twórz zapotrzebowania oraz zmieniaj daty przydziałów, obciążenie i szablony zmian.

  3. Twórz własne raporty

    Łącz dostępność, kwalifikacje, klastry i oferty we własnych raportach. Korzystaj z obliczonych wyników przy podejmowaniu decyzji.

Przykłady / pytania do klienta AI

  • Jakie zapotrzebowania na zasoby są otwarte w przyszłym tygodniu?

  • Pokaż zdolności na przyszły tydzień i znajdź zasoby z ważnymi uprawnieniami operatora maszyn.

  • Utwórz zapotrzebowanie w projekcie z uzgodnionym stanowiskiem, okresem i alokacją.

Przykłady pokazują możliwe zastosowania, a nie wykonane działania. Wynik zależy od danych, klienta i Twoich uprawnień. Sprawdź proponowane zmiany przed zleceniem ich wykonania.

Dostęp dopasowany do zadania.

Uprawnienia wynikają z dostępu do danych

Odczyt i edycja zależą od organizacji, roli użytkownika i przyznanych uprawnień. Dostępne działania zależą również od statusu obiektu i reguł walidacji aplikacji.

Zmieniaj dane źródłowe analiz

Dostępność, klastry i propozycje optymalizacji są obliczane na podstawie zapisanych danych. Wyników nie zapisuje się bezpośrednio.

Historia i widok osobisty

Powiadomienia i zdarzenia dziennika są dostępne do odczytu. Komentarze to osobne obiekty, które można zmieniać. Moja strona pokazuje dane danego pracownika.

Co chcesz połączyć?

Powiedz nam, jakich danych i procesów potrzebujesz. Pomożemy ustalić dostęp, połączenie i obsługiwane działania.

Porozmawiaj o API i MCP