Starmind (előzetes verzió)
A Starmind-összekötő zökkenőmentes integrációt tesz lehetővé a Starmind tudásmotorjával, így a felhasználók ellenőrzött válaszokat és szakértői megállapításokat érhetnek el a szervezetükön belül. A Starmindhez való csatlakozással munkafolyamatai és ügynökei intelligensen lekérhetik az üzletileg kritikus kérdésekre adott válaszokat, szakértői ismereteket tudnak felszínre hozni, és egyszerűsíthetik a döntéshozatali folyamatokat.
Ez az összekötő a következő termékekben és régiókban érhető el:
| Service | Class | Régiók |
|---|---|---|
| Copilot Studio | prémium | Az összes Power Automate-régió, kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD) |
| Logikai alkalmazások | Standard | Az összes Logic Apps-régió , kivéve a következőket: - Azure Government-régiók - Azure China-régiók - Amerikai Védelmi Minisztérium (DoD) |
| Power Alkalmazások | prémium | Az összes Power Apps-régió , kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD) |
| Power Automate | prémium | Az összes Power Automate-régió, kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD) |
| Érintkezés | |
|---|---|
| Név | A Starmind technikai támogatási szakértői készen állnak a figyelésre és a segítségnyújtásra |
| URL | https://starmind.atlassian.net/servicedesk/customer/portal/2 |
| product@starmind.com |
| Összekötő metaadatai | |
|---|---|
| Kiadó | Starmind (inc) |
| Webhely | https://starmind.ai |
| Adatvédelmi irányelvek | https://www.starmind.ai/privacy-policy |
| Kategóriák | Termelékenység; Együttműködés |
Csillag alakú
Pontosan akkor oldja fel a megfelelő szakértelmet, amikor szüksége van rá.
A Starmind fejlett tudásmotorja azonosítja a szervezet szakértőit, és azonnal összekapcsolja Önt az elemzésekkel – zökkenőmentesen integrálva az emberi intelligenciát a napi munkafolyamatokba.
A Starmind Connector zökkenőmentes integrációt tesz lehetővé a Starmind tudásbázismotorjával, lehetővé téve a felhasználók számára az ellenőrzött válaszok elérését és a szakértőkkel való kapcsolatot a szervezeten belül. A Starmindhez való csatlakozással a Power Automate-munkafolyamatok vagy a Copilot-ügynökök intelligensen lekérhetik az üzletileg kritikus kérdésekre adott válaszokat, szakértői ismereteket tudnak felszínre hozni, és egyszerűsíthetik a döntéshozatali folyamatokat.
Közzétevő: Közzétevő neve
Csillag alakú
Előfeltételek
Az integráció használatához elő kell készítenie egy Starmind-hálózatot az integrációhoz. Kérje le a telepítést a Starmind technikai támogatási csatornán keresztül. Az összekötő bármilyen Starmind-csomaggal használható.
Támogatott műveletek
FindExperts
Szakértőket keres a megadott tartalom alapján.
FindQuestions
A megadott lekérdezési paraméterek alapján keres kérdéseket.
PostQuestion
Létrehoz egy új kérdés piszkozatot.
PublishQuestion
Közzéteszi a kérdés piszkozatát.
GetUserById
Lekéri a felhasználói adatokat.
GetQuestion (elavult)
Lekéri egy kérdés teljes adatait, beleértve a megoldásokat, megjegyzéseket és fogalmakat az azonosítójuk alapján.
ResolveUser (elavult)
A globalUserId feloldása felhasználói objektumként. Adja meg a graphQL-lekérdezést a felhasználói objektum lekéréséhez az alábbiak szerint:
query getUser($globalUserId: UUID!) {
user(globalUserId: $globalUserId) {
globalUserId
firstname
lastname
email
languageId
avatarUrl
company
department
position
location
about
countryId
created
dateDeleted
isFederated
}
}
Hitelesítő adatok beszerzése
A Starmind API-kulcsának beszerzéséhez kapcsolatba kell lépnie a Starmind-fiókkezelőjével vagy támogatási csapatával a technikai támogatási csatornánkon keresztül.
Ismert problémák és korlátozások
Ez az összekötő kizárólag API-kulccsal hitelesít.
- A hozzáférés technikai felhasználói fiókon keresztül történik.
- Az OAuth-hitelesítés a bejelentkezett felhasználó kontextusában nem támogatott.
Gyakori kérdések
Mi szükséges ahhoz, hogy ezt az összekötőt Starmind-hálózattal használja?
Az integráció használatához elő kell készítenie egy Starmind-hálózatot az integrációhoz. Kérje le a telepítést a Starmind technikai támogatási csatornán keresztül.
Hogyan szerezhetek be új API-kulcsot?
A Starmind API-kulcsának beszerzéséhez kapcsolatba kell lépnie a Starmind-fiókkezelőjével vagy támogatási csapatával a technikai támogatási csatornánkon keresztül.
Üzembe helyezési utasítások
Ezeket az utasításokat követve telepítse ezt az összekötőt egyéni összekötőként a Microsoft Power Automate-ben.
Kapcsolat létrehozása
Az összekötő a következő hitelesítési típusokat támogatja:
| Alapértelmezett | A kapcsolat létrehozásának paraméterei. | Minden régió | Nem osztható meg |
Alapértelmezett
Alkalmazható: Minden régió
A kapcsolat létrehozásának paraméterei.
Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.
| Név | Típus | Description | Kötelező |
|---|---|---|---|
| A Starmind hálózat. Példa: yourcompany.starmind.com | karakterlánc | Adja meg a Starmind-hálózatot. Példa: yourcompany.starmind.com | True |
| A Starmind által biztosított API-kulcs | securestring | Adja meg az API-kulcsot a Starmind által biztosított módon | True |
Fokozási korlátok
| Név | Hívások | Megújítási időszak |
|---|---|---|
| API-hívások kapcsolatonként | 100 | 60 másodperc |
Műveletek
| Felhasználó lekérése azonosító alapján |
A megadott felhasználói azonosító alapján kéri le a felhasználói adatokat. |
| Kérdés közzététele |
Közzéteheti a kérdéstervezetet. A kérdés közzététele szakértői keresést indít el, felderíthetővé teszi a kérdést, és lehetővé teszi, hogy más felhasználók válaszoljanak rá. A kérdéseket mindig névtelenül tesszük közzé. |
| Kérdés piszkozat létrehozása |
Létrehoz egy új kérdés piszkozatot. A piszkozat még nem kereshető vagy megválaszolható mások számára. A létrehozás után tegye közzé a piszkozatot (a közzétételi végponton keresztül), hogy szakértői keresést indítson, felderíthetővé tegye a kérdést, és lehetővé tegye a többi felhasználó számára a válaszadást. Az opcionális leírás megadásával a szakértők jobban megérthetik a kérdést, és növelik a jó minőségű válaszok esélyét. |
| Kérdések keresése |
Az opcionális |
| Szakértők keresése |
Szakértőket keres a megadott text_query alapján. A keresés a tudásgráf használatával azonosítja a lekérdezéshez kapcsolódó releváns szakértelemmel és tudással rendelkező felhasználókat. Adja meg az opcionális nyelvet a fogalomcímke-szűrés előnyben részesített nyelvének megadásához. Ez nem érinti magát a keresési egyezést; csak azokat a szakértelmeket szűri, amelyeket a visszaadott felhasználóktól mutatunk be úgy, hogy a választott nyelven az elsődleges címkén alapuló fogalmakat választja ki. A visszaadott fogalmak deduplikálva lesznek, ha több fogalom azonos elsődleges címkével rendelkezik. |
Felhasználó lekérése azonosító alapján
A megadott felhasználói azonosító alapján kéri le a felhasználói adatokat.
Paraméterek
| Név | Kulcs | Szükséges | Típus | Leírás |
|---|---|---|---|---|
|
A felhasználó azonosítója
|
id | True | string |
Az egyedi globális felhasználói azonosító (UUID) elérésiút-paraméter, amellyel a felhasználóra hivatkozhat a Starmind platformon. |
Visszatér
- Törzs
- GraphQLUserResponse
Kérdés közzététele
Közzéteheti a kérdéstervezetet. A kérdés közzététele szakértői keresést indít el, felderíthetővé teszi a kérdést, és lehetővé teszi, hogy más felhasználók válaszoljanak rá. A kérdéseket mindig névtelenül tesszük közzé.
Paraméterek
| Név | Kulcs | Szükséges | Típus | Leírás |
|---|---|---|---|---|
|
A közzéteendő kérdés azonosítója
|
questionId | True | integer |
A közzéteendő kérdéstervezet azonosítója |
Visszatér
| Név | Ösvény | Típus | Leírás |
|---|---|---|---|
|
number_of_experts
|
number_of_experts | integer |
number_of_experts |
Kérdés piszkozat létrehozása
Létrehoz egy új kérdés piszkozatot. A piszkozat még nem kereshető vagy megválaszolható mások számára. A létrehozás után tegye közzé a piszkozatot (a közzétételi végponton keresztül), hogy szakértői keresést indítson, felderíthetővé tegye a kérdést, és lehetővé tegye a többi felhasználó számára a válaszadást. Az opcionális leírás megadásával a szakértők jobban megérthetik a kérdést, és növelik a jó minőségű válaszok esélyét.
Paraméterek
| Név | Kulcs | Szükséges | Típus | Leírás |
|---|---|---|---|---|
|
kategória
|
category | integer |
A kérdés piszkozat hozzárendeléséhez szükséges kategória opcionális azonosítója |
|
|
title
|
title | True | string |
Kérdés címe, alapértelmezés szerint 4 és 100 karakter között. A hálózati konfigurációtól függően a cím maximális hossza korlátozott lehet, vagy tovább bővíthető. |
|
leírás
|
description | string |
Az opcionális kérdés leírása, amely részletes kontextust és információkat tartalmaz a kérdésről. A hálózati konfigurációtól függően előfordulhat, hogy a leírás nem üres. |
|
|
nyelv
|
language | string |
Az ISO 639-1 kétbetűs nyelvi kód (pl. "en") egy támogatott nyelvet jelöl. Az "xx" egy ismeretlen nyelv jelzésére használható. |
|
|
knowledge_space
|
knowledge_space | integer |
a kérdéshez rendelendő tudástér azonosítója |
Visszatér
- Törzs
- Question
Kérdések keresése
Az opcionális query, limit (alapértelmezett 10) filterés sort; kérdésekkel itemsellátott lapszámozott gyűjteményt ad vissza. Alapértelmezés szerint az összes közzétett kérdés vissza lesz adva, az utolsó tevékenység (csökkenő) szerint rendezve. Az eredményre szűrők, keresési lekérdezések és rendezési feltételek kombinációja alkalmazható.
Paraméterek
| Név | Kulcs | Szükséges | Típus | Leírás |
|---|---|---|---|---|
|
Lekérdezés keresése kérdésekre
|
query | string |
A kérdéskeresési lekérdezés |
|
|
A visszaadandó kérdések maximális száma
|
limit | integer |
A visszaadott kérdések számának korlátozása. Alapértelmezés szerint 10. |
|
|
Előre definiált szűrő kérdésekhez
|
filter | string |
Előre definiált szűrővel szűrheti a kérdések listáját. |
|
|
Kérdések rendezési feltételei
|
sort | string |
Adja meg, hogy az eredmény milyen feltételek szerint van rendezve |
Visszatér
| Név | Ösvény | Típus | Leírás |
|---|---|---|---|
|
href
|
_links.self.href | string |
href |
|
href
|
_links.next.href | string |
href |
|
href
|
_links.last.href | string |
href |
|
items
|
items | array of Question |
A kérdéskeresés lapszámozott eredményei. |
|
teljes
|
total | integer |
A kérésnek megfelelő kérdések teljes száma. |
Szakértők keresése
Szakértőket keres a megadott text_query alapján. A keresés a tudásgráf használatával azonosítja a lekérdezéshez kapcsolódó releváns szakértelemmel és tudással rendelkező felhasználókat. Adja meg az opcionális nyelvet a fogalomcímke-szűrés előnyben részesített nyelvének megadásához. Ez nem érinti magát a keresési egyezést; csak azokat a szakértelmeket szűri, amelyeket a visszaadott felhasználóktól mutatunk be úgy, hogy a választott nyelven az elsődleges címkén alapuló fogalmakat választja ki. A visszaadott fogalmak deduplikálva lesznek, ha több fogalom azonos elsődleges címkével rendelkezik.
Paraméterek
| Név | Kulcs | Szükséges | Típus | Leírás |
|---|---|---|---|---|
|
nyelv
|
language | string |
Az ISO 639-1 kétbetűs nyelvi kód (pl. "en") egy támogatott nyelvet jelöl. Az "xx" egy ismeretlen nyelv jelzésére használható. |
|
|
text_query
|
text_query | True | string |
Elsődleges keresési szöveg a szakértők azonosításához. Lehet egy kérdés, egy szöveg összegzése, egy vagy több témakör. |
Visszatér
| Név | Ösvény | Típus | Leírás |
|---|---|---|---|
|
Szakértők
|
experts | array of object |
A keresési lekérdezésnek megfelelő szakértők listája. Üres lehet, ha nem talál szakértőket. |
|
concept_scores
|
experts.concept_scores | ExpertConceptScores |
A szakértői keresési koncepció egyezik, beleértve a pontszámokat is. |
|
pont
|
experts.score | float |
Relevanciapont, amely azt jelzi, hogy a szakértő mennyire felel meg a lekérdezésnek |
|
felhasználó
|
experts.user | UserV3 |
Felhasználói adatokat tartalmazó felhasználói objektum. |
|
label_matches
|
label_matches | array of ConceptLabelMatch |
A szakértői keresési lekérdezés egyeztetett címkéi. Üres lehet, ha nincsenek egyező címkék. |
Meghatározások
Question
| Név | Ösvény | Típus | Leírás |
|---|---|---|---|
|
knowledge_space_id
|
knowledge_space_id | integer |
Az egyedi tudástér-azonosító, amelyhez a kérdés tartozik. |
|
upvote_count
|
upvote_count | integer |
A kérdéshez kapott felosztottak teljes száma. |
|
view_count
|
view_count | integer |
A felhasználók által megtekintett kérdések száma. |
|
Közzététel dátuma
|
published | date-time |
A kérdés közzétételének idejét jelző időbélyeg (yyyy-MM-ddTHH:mm:ss.fffZ) |
|
is_deleted
|
is_deleted | boolean |
Jelzi, hogy a kérdés törölve van-e. A törölt kérdések nem láthatók a felhasználók számára, de a rendszergazdák továbbra is hozzáférhetnek hozzájuk. |
|
title
|
title | string |
A kérdés címe |
|
Legutóbbi tevékenység dátuma
|
last_activity | date-time |
A kérdés utolsó tevékenységét jelző időbélyeg (yyyy-MM-ddTHH:mm:ss.fffZ) |
|
is_published
|
is_published | boolean |
A kérdés is_published jelző jelzi, hogy a kérdés közzé van-e téve. A közzétett megoldás minden felhasználó számára látható, míg a közzé nem tett megoldások piszkozat állapotban csak a szerző számára láthatók. |
|
Létrehozás dátuma
|
created | date-time |
A kérdés létrehozásának idejét jelző időbélyeg (yyyy-MM-ddTHH:mm:ss.fffZ) |
|
leírás
|
description | string |
A kérdés leírása, amely részletes kontextust és információt tartalmaz a kérdésről |
|
solution_count
|
solution_count | integer |
Ez a kérdéshez megadott megoldások száma. |
|
Tartalom frissítése dátuma
|
content_updated | date-time |
A kérdés tartalmának vagy mellékleteinek legutóbbi frissítését jelző időbélyeg (yyyy-MM-ddTHH:mm:ss.fffZ) |
|
azonosító
|
id | integer |
Az egyedi kérdésazonosító |
|
kérdés frissített dátuma
|
updated | date-time |
Az erőforrás legutóbbi frissítése a db-ben. Ez a dátum nem tükrözi a tartalomfrissítéseket, hanem a rekord bármely mezőjének frissítését. A tartalomfrissítésekkel kapcsolatos információkért használja a content_updated. |
|
nyelv
|
language | string |
A kérdés nyelve |
ConceptLabelMatch
| Név | Ösvény | Típus | Leírás |
|---|---|---|---|
|
concept_id
|
concept_id | string |
Az egyedi koncepcióazonosító |
|
leírás
|
description | string |
A koncepció leírása |
|
is_flat
|
is_flat | boolean |
is_flat |
|
label_match
|
label_match | string |
A koncepciónak megfelelő címke |
|
nyelv
|
language | string |
Fogalomnyelv |
|
ontology_id
|
ontology_id | string |
Az egyedi ontológiai azonosító, amelyhez a koncepció tartozik |
|
primary_label
|
primary_label | string |
Elsődleges fogalomcímke |
UserId
Az egyedi felhasználói azonosító (UUID), amellyel a Starmind platformon keresztül hivatkozhat egy felhasználóra.
Az egyedi felhasználói azonosító (UUID), amellyel a Starmind platformon keresztül hivatkozhat egy felhasználóra.
UserV3
Felhasználói adatokat tartalmazó felhasználói objektum.
| Név | Ösvény | Típus | Leírás |
|---|---|---|---|
|
névjegy
|
about | string |
A felhasználó által beírt egyéni szöveg, amely a "Rólam" szakaszban írja le magát |
|
avatar_url
|
avatar_url | string |
A felhasználó avatarképének URL-címe |
|
cég
|
company | string |
A felhasználó vállalata |
|
country
|
country | string |
A felhasználó ISO 3166-1 alfa-2 országkódja (pl. ch, us, de) |
|
created
|
created | date-time |
A felhasználó létrehozásának idejét jelző időbélyeg (yyyy-MM-ddTHH:mm:ss.fffZ) |
|
törölt
|
deleted | date-time |
A felhasználó törlésének időpontját jelző időbélyeg (yyyy-MM-ddTHH:mm:ss.fffZ). Rendszergazdai engedélyek nélkül a rendszer csak a nem törölt felhasználót adja vissza |
|
osztály
|
department | string |
A felhasználó részlege |
|
e-mail
|
A felhasználó e-mail címe |
||
|
keresztnév
|
first_name | string |
A felhasználó utóneve. |
|
first_seen
|
first_seen | date-time |
Időbélyeg, amely jelzi, hogy a felhasználó mikor jelentkezett be az első alkalommal (ééééé-MM-ddTHH:mm:ss.fffZ) |
|
azonosító
|
id | UserId |
Az egyedi felhasználói azonosító (UUID), amellyel a Starmind platformon keresztül hivatkozhat egy felhasználóra. |
|
is_federated
|
is_federated | boolean |
Azt jelzi, hogy a felhasználó helyi hitelesítő adatokkal (e-mail/jelszó) hitelesít-e külső egyszeri bejelentkezés szolgáltató helyett (SAML, OpenID Connect) |
|
is_technical
|
is_technical | boolean |
Azt jelzi, hogy a felhasználó technikai API-felhasználó-e (nem interaktív/gépi fiók); ha igaz, a felhasználó általában API-kulccsal hitelesít |
|
nyelv
|
language | Language |
Az ISO 639-1 kétbetűs nyelvi kód (pl. "en") egy támogatott nyelvet jelöl. Az "xx" egy ismeretlen nyelv jelzésére használható. |
|
vezetéknév
|
last_name | string |
A felhasználó vezetékneve. |
|
hely
|
location | string |
A felhasználó helye |
|
pozíció
|
position | string |
A felhasználó vállalata |
Nyelv
Az ISO 639-1 kétbetűs nyelvi kód (pl. "en") egy támogatott nyelvet jelöl. Az "xx" egy ismeretlen nyelv jelzésére használható.
Az ISO 639-1 kétbetűs nyelvi kód (pl. "en") egy támogatott nyelvet jelöl. Az "xx" egy ismeretlen nyelv jelzésére használható.
ExpertConceptScores
A szakértői keresési koncepció egyezik, beleértve a pontszámokat is.
| Név | Ösvény | Típus | Leírás |
|---|---|---|---|
|
concept_id
|
concept.concept_id | string |
concept_id |
|
encounter_count
|
concept.encounter_count | integer |
encounter_count |
|
is_excluded_from_suggestion
|
concept.is_excluded_from_suggestion | boolean |
is_excluded_from_suggestion |
|
is_flat
|
concept.is_flat | boolean |
is_flat |
|
labels_for_languages
|
concept.labels_for_languages | array of object |
Minden elérhető címke különböző nyelvekhez |
|
leírás
|
concept.labels_for_languages.description | string |
leírás |
|
description_type
|
concept.labels_for_languages.description_type | string |
description_type |
|
nyelv
|
concept.labels_for_languages.language | Language |
Az ISO 639-1 kétbetűs nyelvi kód (pl. "en") egy támogatott nyelvet jelöl. Az "xx" egy ismeretlen nyelv jelzésére használható. |
|
labels
|
concept.labels_for_languages.labels | array of string |
labels |
|
primary_label
|
concept.labels_for_languages.primary_label | string |
A nyelv fő címkéje |
|
last_update
|
concept.last_update | date-time |
last_update |
|
ontology_id
|
concept.ontology_id | string |
ontology_id |
|
szülők
|
concept.parents | array of uuid |
A szülőkoncepció azonosítójai |
|
pont
|
score | float |
pont |
GraphQLUserResponse
| Név | Ösvény | Típus | Leírás |
|---|---|---|---|
|
felhasználó
|
data.user | UserV3 |
Felhasználói adatokat tartalmazó felhasználói objektum. |
|
Hibák
|
errors | array of GraphQLError |
A GraphQL-hibák választható tömbje; csak akkor jelenik meg, ha hiba történt |
GraphQLError
| Név | Ösvény | Típus | Leírás |
|---|---|---|---|
|
kód
|
extensions.code | string | |
|
helyek
|
locations | array of object | |
|
oszlop
|
locations.column | integer | |
|
sor
|
locations.line | integer | |
|
üzenet
|
message | string | |
|
elérési út
|
path | array of string |