PM: API: Goal: PATCH /planning-api/goals/{goalId}/ai-smart-score
Üldkirjeldus
Teenus võimaldab pärida ChatGPT hinnangut eesmärgi kirjelduse SMART põhimõtetele vastavuse kohta 5-punktilisel skaalal.
Seotud andmeobjektid:
Seotud Jira taskid
NSIL-706 - Getting issue details... STATUS
NSIL-796 - Getting issue details... STATUS
Eeltingimused ja kasutusõigused
- Kui tegemist on asutusepõhise eesmärgiga (Goal.goalScope = INSTITUTIONAL):
- Kasutajal on seos eesmärgi asutusega ja sama asutuse eesmärkide lisamise ja muutmise õigus.
- Goal.institution.id = Kasutaja poolt valitud rolliga seotud asutus
- Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_MANAGE.
- Kasutajal on seos eesmärgi asutusega ja sama asutuse eesmärkide lisamise ja muutmise õigus.
- Kui tegemist on isikupõhise eesmärgiga (Goal.goalScope = INDIVIDUAL):
- Kasutaja on eesmärgi omanik ja tal on seos eesmärgi asutuse ja ametikohaga.
- Goal.personalCode = Päringu käivitanud kasutaja isikukood.
- Goal.institution.id = Kasutaja poolt valitud rolliga seotud asutus
- Goal.jobsite = Kasutaja poolt valitud rolliga seotud ametikoht
- Eraldi privileegi ei ole vaja.
- Kasutaja on eesmärgi omanik ja tal on seos eesmärgi asutuse ja ametikohaga.
- Või kasutaja on eesmärgi meeskonnas ja planeerimise meeskonna liikme rollil on eesmärkide lisamise ja muutmise õigus.
- Goal.goalScope = INSTITUTIONAL või INDIVIDUAL
- Goal.teamMembers.id = GoalTeamMember.id, mille personalCode = Päringu käivitanud kasutaja isikukood
- Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_MANAGE.
Planeerimise mooduli kasutusrollide ja õiguste kohta saab täpsemalt infot leida lehelt Kasutusõigused ja rollid.
Sisendid
| Atribuut | Kohustuslikkus, mitmesus | Tüüp | Vaikeväärtus, valideerimine | Kirjeldus, täiendav info |
|---|---|---|---|---|
goalId | 1 | String |
| Eesmärgi unikaalne identifikaator, mille jaoks saadakse ChatGPT mudelilt hinnang eesmärgi kirjeldusele. |
Väljundid
Atribuut | Kohustuslikkus, mitmesus | Tüüp | Kirjeldus, täiendav info |
|---|---|---|---|
| Samad, mis teenusel PM: API: Goal: POST /planning-api/goals#V%C3%A4ljundid. | |||
Tegevused
- Süsteem kontrollib, kas kasutajal on õigust päringut teostada.
- Kui õigust pole, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
- Süsteem kontrollib, kas sisendandmed vastavad nõuetele.
- Kui andmed ei vasta nõuetele, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
- Süsteem kontrollib, kas sisendis esitatud eesmärk (goalId) eksisteerib ja kas päringu käivitanud kasutajal on õigus selle andmeid hallata.
- Kontroll toimub vastavalt üldreeglites kirjeldatud loogikale.
- Kui eesmärki ei leita või see ei vasta üldreeglitele, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
- Süsteem kontrollib, kas eesmärgile on lisatud kirjeldus.
- Süsteem kontrollib, kas Objektid#Goal objekt, mille id = sisendis esitatud goalId ja archived = false, vastab järgmistele tingimustele:
- description != NULL
- Kui tingimused ei ole täidetud, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
- Süsteem kontrollib, kas Objektid#Goal objekt, mille id = sisendis esitatud goalId ja archived = false, vastab järgmistele tingimustele:
- Süsteem saadab OpenAI API kaudu päringu ChatGPT mudelile eesmärgi kirjeldusele SMART skoori hinnangu saamiseks.
- OpenAI käsk
- Kui päring ebaõnnestub, lõpetatakse päringu töötlemine ja tagastatakse OpenAI veakood.
- OpenAI käsk
- Süsteem lisab eesmärgile ChatGPT antud eesmärgi kirjelduse SMART skoori.
- Süsteem uuendab Objektid#Goal objekti andmeid:
- aiSmartScore.specific = OpenAI API päringust saadud hinnang eesmärgi kirjelduse konkreetsusele.
- aiSmartScore.measurable = OpenAI API päringust saadud hinnang eesmärgi kirjelduse mõõdetavusele.
- aiSmartScore.achievable = OpenAI API päringust saadud hinnang eesmärgi kirjelduse saavutatavusele.
- aiSmartScore.relevant = OpenAI API päringust saadud hinnang eesmärgi kirjelduse asjakohasusele.
- aiSmartScore.timely = OpenAI API päringust saadud hinnang eesmärgi kirjelduse ajaliselt sobivusele.
- aiSmartScore.average = Arvutatakse eesmärgi kõigi SMART kriteeriumite hinnangute aritmeetiline keskmine.
- audit = audit (muutmine)
- Süsteem uuendab Objektid#Goal objekti andmeid:
- Süsteem tagastab eesmärgi muudetud andmed.