API / MCP-server

Sinu andmed. Rohkem võimalusi.

Ühenda ressursiplaneerimine juba kasutatavate süsteemide ja tehisintellekti tööriistadega. Päri teavet, loo oma ülevaateid ja tee toetatud toiminguid hallatud juurdepääsuga.

Sinu süsteemidele

REST API

Päri struktureeritud JSON-andmeid aruandluseks, integratsioonideks ja oma töövoogudeks. Toetatud kirjutamistoimingutega saab RessursAgentis teavet luua ja uuendada.

  • Loo aruandeid ja ülevaateid
  • Ühenda projekti- ja ressursiandmeid süsteemide vahel
  • Automatiseeri toetatud ülesandeid
Sinu AI-tööriistadele

MCP-server

Model Context Protocol võimaldab ühilduval AI-kliendil kasutada RessursAgenti tööriistana. Küsi oma organisatsiooni andmete kohta ja taotle toetatud toiminguid oma konto ning õigustega.

  • Küsi plaani kohta oma sõnadega
  • Koonda võimsus, vajadused ja pädevused
  • Taotle muudatusi oma õiguste piires

Objektid, väljad ja toimingud.

Vaata, mida sinu süsteemid ja tehisintellekti tööriistad saavad RessursAgentis lugeda, luua ja muuta. Ülevaade näitab põhiobjekte ning valikut REST API ja MCP toetatud väljadest.

Väljanimed on andmemudeli tegelikud nimed. Kirjutatavad väljad kehtivad loomisel, uuendamisel või eraldi toimingul; kõiki ei saa pärast loomist muuta. Projektid ja ressursid seotakse tavaliselt ID abil.

Ressursid ja projektid

Töötajad, masinad, kontaktandmed, ametikohad, erialad, projektiperioodid, kliendid ja asukohad.

Ressursid: töötajad ja seadmed

  • Loe
  • Loo
  • Muuda

Loetavad väljad

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

Kirjutatavad väljad

  • 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

Projektid

  • Loe
  • Loo
  • Muuda

Loetavad väljad

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

Kirjutatavad väljad

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

HMS-kaardid

  • Loe
  • Muuda
  • Eemalda

Loetavad väljad

  • resource_id
  • card_id
  • expires_at

Kirjutatavad väljad

  • card_number
  • expires_at

Kaardinumbrit ei tagastata. Registreerimine nõuab sisselogitud kasutajat, kellel on eraldi HMS-õigus. Aegumiskuupäeva saab uuendada eraldi.

Plaan, vajadused ja võimsus

Määramised, jaotus, ressursitaotlused, kättesaamatus ja arvutatud võimsus iga ressursi ning päeva kohta.

Määramised

  • Loe
  • Loo
  • Muuda
  • Eemalda

Loetavad väljad

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

Kirjutatavad väljad

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

Ressursivajadused

  • Loe
  • Loo
  • Muuda
  • Eemalda

Loetavad väljad

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

Kirjutatavad väljad

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

Vajadusi saab ka esitada, tagasi lükata, tühistada ja täita eraldi toimingutega.

Puudumised ja kättesaamatus

  • Loe
  • Loo
  • Eemalda

Loetavad väljad

  • resource_id
  • start_date
  • end_date
  • reason
  • unavailable_percent

Kirjutatavad väljad

  • resource_id
  • start_date
  • end_date
  • reason
  • unavailable_percent

Arvutatud võimekus

  • Loe

Loetavad väljad

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

Ainult lugemine

Need on arvutatud tulemused, mida saab lugeda. Mõjuta neid, muutes lähteandmeid, näiteks määramisi, perioode, asukohti ja pädevusi.

Pädevused ja vahetused

Pädevuste kataloog, registreeritud pädevused ja kehtivus, projektinõuded, vahetusemallid ja päevaerandid.

Pädevuste kataloog

  • Loe
  • Loo
  • Muuda
  • Eemalda

Loetavad väljad

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

Kirjutatavad väljad

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

Ressursi pädevused

  • Loe
  • Loo
  • Muuda
  • Eemalda

Loetavad väljad

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

Kirjutatavad väljad

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

Välisele lähtesüsteemile kuuluvad pädevused tuleb uuendada seal. Sertifikaadinumbreid ja kommentaare saab salvestada, kuid selles lugemisobjektis neid ei tagastata.

Pädevusnõuded

  • Loe
  • Loo
  • Muuda
  • Eemalda

Loetavad väljad

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

Kirjutatavad väljad

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

Vahetuste mallid

  • Loe
  • Loo
  • Muuda
  • Eemalda

Loetavad väljad

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

Kirjutatavad väljad

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

Päevapõhised erandid

  • Loe
  • Loo
  • Muuda
  • Eemalda

Loetavad väljad

  • resource_id
  • exception_date
  • exception_type
  • planned_hours

Kirjutatavad väljad

  • resource_id
  • exception_date
  • exception_type
  • planned_hours
  • comment

Koolitusplaanid

  • Loe
  • Muuda

Loetavad väljad

  • competency_id
  • plans

Kirjutatavad väljad

  • resource_ids
  • planned_on
Meeskonnad, koostöö ja analüüsid

Planeerimistiimid, projektitiimid ja liikmed, tegevused ja projektirollid. REST API ja MCP võimaldavad hankida ka geograafilisi klastreid, koostööpaare ja arvutatud vahetusettepanekuid.

Planeerimismeeskonnad

  • Loe
  • Loo
  • Muuda

Loetavad väljad

  • name
  • leader_resource_id
  • end_date
  • archived_at

Kirjutatavad väljad

  • name
  • leader_resource_id
  • end_date
  • competency_ids

Projektimeeskonnad

  • Loe
  • Loo
  • Muuda
  • Eemalda

Loetavad väljad

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

Kirjutatavad väljad

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

Meeskonnaliikmed

  • Loe
  • Loo
  • Muuda
  • Eemalda

Loetavad väljad

  • project_team_id
  • resource_id
  • is_lead

Kirjutatavad väljad

  • project_team_id
  • resource_id
  • is_lead

Projekti tegevused

  • Loe
  • Loo
  • Muuda
  • Eemalda

Loetavad väljad

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

Kirjutatavad väljad

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

Projektirollid

  • Loe
  • Loo
  • Muuda
  • Eemalda

Loetavad väljad

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

Kirjutatavad väljad

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

Seotud ressursid

  • Loe
  • Loo
  • Muuda
  • Eemalda

Loetavad väljad

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

Kirjutatavad väljad

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

Geograafilised klastrid

  • Loe

Loetavad väljad

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

Ainult lugemine

Need on arvutatud tulemused, mida saab lugeda. Mõjuta neid, muutes lähteandmeid, näiteks määramisi, perioode, asukohti ja pädevusi.

Koostöösuhted

  • Loe

Loetavad väljad

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

Ainult lugemine

Need on arvutatud tulemused, mida saab lugeda. Mõjuta neid, muutes lähteandmeid, näiteks määramisi, perioode, asukohti ja pädevusi.

Optimeerimisettepanekud

  • Loe

Loetavad väljad

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

Ainult lugemine

Need on arvutatud tulemused, mida saab lugeda. Mõjuta neid, muutes lähteandmeid, näiteks määramisi, perioode, asukohti ja pädevusi.

Pakkumised ja registrid

Pakkumised koos oleku, tõenäosuse ja vajadustega. Sildid, ametikohad, erialad, masinatüübid ja -mudelid, tarnijad ning masinabaasid.

Pakkumised ja simulatsioon

  • Loe
  • Loo
  • Muuda
  • Eemalda

Loetavad väljad

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

Kirjutatavad väljad

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

Pakkumise vajadused sisaldavad kategooriat, kataloogiviidet, kogust ja perioodi (category, catalog_item_id, quantity, start_date, end_date). Olekut ja simulatsioonis osalemist muudetakse eraldi toimingutega.

Pakkumise võtmeisikud

  • Loe
  • Loo
  • Eemalda

Loetavad väljad

  • bid_opportunity_id
  • resource_id
  • responsibility

Kirjutatavad väljad

  • bid_opportunity_id
  • resource_id
  • responsibility

Sildid

  • Loe
  • Loo
  • Muuda
  • Eemalda

Loetavad väljad

  • name

Kirjutatavad väljad

  • name

Silte saab ka lisada projektidele, ressurssidele ja ressursivajadustele või neilt eemaldada.

Ametikohad, erialad, seadmetüübid, seadmemudelid ja tarnijad

  • Loe
  • Loo
  • Muuda
  • Eemalda

Loetavad väljad

  • name

Kirjutatavad väljad

  • name

Seadmebaasid

  • Loe
  • Loo
  • Muuda
  • Eemalda

Loetavad väljad

  • name
  • postal_code

Kirjutatavad väljad

  • name
  • postal_code

Ametikohtade ja seadmemudelite rendihinnad

  • Loe
  • Muuda

Loetavad väljad

  • kind
  • hire_day_rate
  • hire_currency_code

Kirjutatavad väljad

  • hire_day_rate
  • hire_currency_code
Teavitused ja ajalugu

Teavitused, sündmused, kommentaarid ja piiratud väljavõte muudatuste logist. Vajalik on juurdepääs vastavatele andmevaldkondadele.

Teavitused

  • Loe

Loetavad väljad

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

Ainult lugemine

Teavitussündmused

  • Loe

Loetavad väljad

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

Ainult lugemine

Muudatuste logi

  • Loe

Loetavad väljad

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

Ainult lugemine

Kommentaarid

  • Loe
  • Loo
  • Muuda
  • Eemalda

Loetavad väljad

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

Kirjutatavad väljad

  • entity_type
  • entity_id
  • comment
  • applies_from
  • applies_until
  • expected_version
Sinu enda teave

Profiili kasutajad saavad isikliku API/MCP-juurdepääsu kaudu hankida oma plaani, pädevused ja muudatused. Ühendus järgib sisselogitud kasutaja õigusi ning nõuab seost isikuressursiga.

Sinu profiil

  • Loe

Loetavad väljad

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

Ainult lugemine

Loeb sisselogitud töötaja enda andmeid ja eeldab seost isikuressursiga.

Sinu plaan

  • Loe

Loetavad väljad

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

Ainult lugemine

Loeb sisselogitud töötaja enda andmeid ja eeldab seost isikuressursiga.

Sinu pädevused

  • Loe

Loetavad väljad

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

Ainult lugemine

Loeb sisselogitud töötaja enda andmeid ja eeldab seost isikuressursiga.

Sinu muudatused

  • Loe

Loetavad väljad

  • resource_id
  • changes

Ainult lugemine

Loeb sisselogitud töötaja enda andmeid ja eeldab seost isikuressursiga.

Teabest praktilise kasuni.

Näited / API töövood

  1. Hoia ressursiregister ajakohane

    Loo töötajaid või seadmeid ning uuenda kontaktandmeid, osakonda, eriala ja väliseid viiteid.

  2. Seo projektiandmed planeerimisega

    Uuenda projektiperioode ja kliendiandmeid. Loo vajadusi ning muuda määramiste kuupäevi, koormust ja vahetuse malli.

  3. Koosta oma aruandeid

    Ühenda võimekus, pädevused, klastrid ja pakkumised oma aruannetes. Kasuta arvutatud tulemusi otsuste tegemisel.

Näited / küsimused AI-kliendile

  • Millised ressursitaotlused on järgmisel nädalal avatud?

  • Näita järgmise nädala võimsust ja leia kehtiva masinajuhipädevusega ressursid.

  • Loo projektile ressursitaotlus kokkulepitud ametikoha, perioodi ja jaotusega.

Näited kirjeldavad kasutusvõimalusi, mitte tehtud toiminguid. Tulemus sõltub registreeritud andmetest, kliendist ja sinu õigustest. Vaata pakutud muudatused üle enne nende tegemise taotlemist.

Ülesandele vastav juurdepääs.

Õigused järgivad andmeid

Lugemine ja muutmine sõltuvad organisatsioonist, kasutajarollist ja antud õigustest. Võimalikud toimingud sõltuvad ka objekti olekust ja rakenduse valideerimisreeglitest.

Muuda analüüsi lähteandmeid

Võimekus, klastrid ja optimeerimisettepanekud arvutatakse salvestatud andmetest. Tulemusi ei kirjutata otse.

Ajalugu ja isiklik vaade

Teavitusi ja logisündmusi saab lugeda. Kommentaarid on eraldi muudetavad objektid. Minu leht näitab vastava töötaja andmeid.

Mida soovid ühendada?

Kirjelda vajalikke andmeid ja töövooge. Aitame täpsustada juurdepääsu, ühendust ning toetatud toiminguid.

Räägime API-st ja MCP-st