Starmind（預覽版）

Starmind 連接器可與 Starmind 的知識引擎無縫集成，使用戶能夠訪問整個組織的經過驗證的答案和專家見解。 透過連接到 Starmind，您的工作流程和代理可以智慧地檢索對關鍵業務問題的回應、揭示專業知識並簡化決策流程。

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域 ：      - 美國政府 （GCC）      - 美國政府（海灣合作委員會高中）      - 由 21Vianet 營運的中國雲      - 美國國防部 （DoD）
邏輯應用程式	標準	所有 Logic Apps 區域， 但下列區域除外：      - Azure Government 區域      - Azure 中國區域      - 美國國防部 （DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域 ：      - 美國政府 （GCC）      - 美國政府（海灣合作委員會高中）      - 由 21Vianet 營運的中國雲      - 美國國防部 （DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域 ：      - 美國政府 （GCC）      - 美國政府（海灣合作委員會高中）      - 由 21Vianet 營運的中國雲      - 美國國防部 （DoD）

連絡人​​
名稱	Starmind 技術支持專家隨時準備傾聽並提供幫助
URL	https://starmind.atlassian.net/servicedesk/customer/portal/2
Email	product@starmind.com

連接器中繼資料
Publisher	Starmind （inc）
網站	https://starmind.ai
隱私策略	https://www.starmind.ai/privacy-policy
類別	生產力;通敵

Starmind

在您需要時釋放正確的專業知識。
Starmind 的高級知識引擎可以識別您組織內的專家，並立即將您與他們的見解聯繫起來，將人類智慧無縫整合到您的日常工作流程中。

Starmind 連接器可與 Starmind 的知識引擎無縫集成，允許用戶訪問經過驗證的答案並與整個組織的專家聯繫。 透過連接到 Starmind，Power Automate 工作流程或 Copilot 代理可以智慧地檢索對關鍵業務問題的回應、揭示專業知識並簡化決策流程。

發行商：出版商名稱

Starmind

先決條件

要使用此集成，您需要為集成準備一個 Starmind 網絡。 請透過 Starmind 技術支援管道請求設定。 該連接器可與任何 Starmind 計劃一起使用。

支援的作業

FindExperts

根據提供的內容尋找專家。

FindQuestions

根據提供的查詢參數尋找問題。

後問題

建立新的問題草稿。

發布問題

發布問題草稿。

GetUserById

取得使用者資料。

GetQuestion（已棄用）

依問題識別碼擷取問題的完整詳細資料，包括解決方案、註解和概念。

ResolveUser（已棄用）

將 globalUserId 解析為使用者物件。 提供 graphQL 查詢以擷取使用者物件，方法如下：

query getUser($globalUserId: UUID!) {
  user(globalUserId: $globalUserId) {
    globalUserId
    firstname
    lastname
    email
    languageId
    avatarUrl
    company
    department
    position
    location
    about
    countryId
    created
    dateDeleted
    isFederated
  }
}

取得憑證

要取得 Starmind 的 API 金鑰，您需要透過我們的技術支援管道聯絡您的 Starmind 客戶經理或支援團隊

已知問題和限制

此聯結器僅透過 API 金鑰進行驗證。

• 存取是透過技術使用者帳戶執行的。
• 不支援登入使用者內容中的 OAuth 驗證。

常見問題

將此連接器與 Starmind 網路搭配使用需要什麼？

要使用此集成，您需要為集成準備一個 Starmind 網絡。 請透過 Starmind 技術支援管道請求設定。

如何取得新的 API 金鑰？

要取得 Starmind 的 API 金鑰，您需要透過我們的技術支援管道聯絡您的 Starmind 客戶經理或支援團隊

部署指示

請使用 這些指示 ，將此連接器部署為 Microsoft Power Automate 中的自訂連接器。

正在建立連線

連接器支援下列驗證類型：

預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
Starmind 網絡。 範例：yourcompany.starmind.com	字串	指定您的 Starmind 網絡。 範例：yourcompany.starmind.com	對
Starmind 提供的 API 密碼	securestring	輸入 Starmind 提供的 API 金鑰	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

依識別碼取得使用者	根據提供的使用者 ID 擷取使用者資訊。
尋找問題	使用選填 query式、 limit 預設 10、 filter和 sort;回傳帶有問題 items的分頁集合。 預設情況下，所有已發表的問題都會依其最後一次活動（遞減）排序回傳。 可結合篩選、搜尋查詢及排序條件來處理結果。
尋找專家	根據所提供的text_query尋找專家。 搜尋利用知識圖譜來識別與查詢相關專業知識與專業知識的使用者。 提供可選語言以指定概念標籤過濾的偏好語言。 這不影響搜尋匹配本身;它僅根據所選語言的主要標籤，篩選回訪用戶中展示的專業內容。 當多個概念共用同一主要標籤時，回傳的概念會被去重。
建立問題草稿	建立新的問題草稿。 該草案尚未可供他人搜尋或回答。 建立後，透過發佈端點發佈草稿，觸發專家搜尋，讓問題可被發現，並讓其他使用者能回答。 提供可選描述有助於專家更好地理解問題，並提高獲得高品質答案的機會。
發佈問題	發布題目草稿。 公開問題會觸發專家搜尋，使問題可被發現，並讓其他使用者能夠回答。 問題總是匿名公開。

依識別碼取得使用者

作業識別碼：

GetUserById_V3

根據提供的使用者 ID 擷取使用者資訊。

參數

名稱	機碼	必要	類型	Description
使用者的ID	id	True	string	唯一的全球使用者識別碼（UUID）作為路徑參數，用於在 Starmind 平台上引用使用者。

傳回

身體

GraphQLUserResponse

尋找問題

作業識別碼：

FindQuestions_V3

使用選填 query式、 limit 預設 10、 filter和 sort;回傳帶有問題 items的分頁集合。 預設情況下，所有已發表的問題都會依其最後一次活動（遞減）排序回傳。 可結合篩選、搜尋查詢及排序條件來處理結果。

參數

名稱	機碼	必要	類型	Description
搜尋問題查詢	query		string	問題搜尋查詢
要傳回的問題數目上限	limit		integer	限制傳回的問題數量。 預設為 10。
預先定義的問題篩選器	filter		string	使用預先定義的篩選器篩選問題清單。
問題的排序條件	sort		string	指定排序結果的準則

傳回

名稱	路徑	類型	Description
href	_links.self.href	string	href
href	_links.next.href	string	href
href	_links.last.href	string	href
items	items	array of Question	問題搜尋的分頁結果。
總計	total	integer	與請求相符的問題總數。

尋找專家

作業識別碼：

FindExperts_V3

根據所提供的text_query尋找專家。 搜尋利用知識圖譜來識別與查詢相關專業知識與專業知識的使用者。 提供可選語言以指定概念標籤過濾的偏好語言。 這不影響搜尋匹配本身;它僅根據所選語言的主要標籤，篩選回訪用戶中展示的專業內容。 當多個概念共用同一主要標籤時，回傳的概念會被去重。

參數

名稱	機碼	必要	類型	Description
語言	language		string	ISO 639-1 兩字母語言代碼（例如「en」）代表支援語言。 「xx」可用來表示未知語言。
text_query	text_query	True	string	主要搜尋文本以識別專家。 可以是一個問題、一篇文章的摘要，或是一個或多個主題。

傳回

名稱	路徑	類型	Description
專家	experts	array of object	與搜尋詞相符的專家名單。 如果找不到專家，可能會是空的。
concept_scores	experts.concept_scores	ExpertConceptScores	專家搜尋概念配對，包括分數。
分數	experts.score	float	相關性分數表示專家匹配問題的程度
使用者	experts.user	UserV3	包含使用者資訊的使用者物件。
label_matches	label_matches	array of ConceptLabelMatch	專家搜尋查詢的匹配標籤。 如果標籤不符，可能是空的。

建立問題草稿

作業識別碼：

PostQuestionDraft_V3

建立新的問題草稿。 該草案尚未可供他人搜尋或回答。 建立後，透過發佈端點發佈草稿，觸發專家搜尋，讓問題可被發現，並讓其他使用者能回答。 提供可選描述有助於專家更好地理解問題，並提高獲得高品質答案的機會。

參數

名稱	機碼	必要	類型	Description
分類	category		integer	可選的分類識別碼，用來指派題目草稿
title	title	True	string	問題標題，預設字元介於4到100字之間。 根據網路配置，標題最大長度可能會被限制或延長。
描述	description		string	選修題目說明，提供詳細的題目背景與資訊。 根據網路配置，描述可能會被強制為非空。
語言	language		string	ISO 639-1 兩字母語言代碼（例如「en」）代表支援語言。 「xx」可用來表示未知語言。
knowledge_space	knowledge_space		integer	要指派問題的知識空間識別碼

傳回

身體

Question

發佈問題

作業識別碼：

PublishQuestionDraft_V3

發布題目草稿。 公開問題會觸發專家搜尋，使問題可被發現，並讓其他使用者能夠回答。 問題總是匿名公開。

參數

名稱	機碼	必要	類型	Description
要發佈的問題 ID	questionId	True	integer	要發佈的問題草稿的ID

傳回

名稱	路徑	類型	Description
number_of_experts	number_of_experts	integer	number_of_experts

定義

Question

名稱	路徑	類型	Description
knowledge_space_id	knowledge_space_id	integer	問題所屬的唯一知識空間 ID。
upvote_count	upvote_count	integer	該問題獲得的總讚數。
view_count	view_count	integer	該問題被用戶瀏覽的次數。
發布日期	published	date-time	指出問題發佈時間的時間戳記 （yyyy-MM-ddTHH：mm：ss.fffZ）
is_deleted	is_deleted	boolean	顯示問題是否被刪除。 已刪除的問題對使用者不可見，但管理員仍可存取。
title	title	string	問題標題
最後活動日期	last_activity	date-time	指出具有問題的最後一個活動的時間戳記 （yyyy-MM-ddTHH：mm：ss.fffZ）
is_published	is_published	boolean	問題is_published旗標會指出問題是否已發佈。 已發佈的解決方案對所有使用者都可見，而未發佈的解決方案則處於草稿狀態，只有作者才能看到。
建立日期	created	date-time	指出問題建立時間的時間戳記 （yyyy-MM-ddTHH：mm：ss.fffZ）
描述	description	string	問題描述提供有關問題的詳細背景和信息
solution_count	solution_count	integer	這是針對這個問題所提供的解答數量。
內容更新日期	content_updated	date-time	指出問題內容或附件上次更新時間的時間戳記 （yyyy-MM-ddTHH：mm：ss.fffZ）
識別碼	id	integer	唯一問題 id
問題更新日期	updated	date-time	上次在資料庫中更新資源的時間。 此日期不反映內容更新，而是記錄任何欄位的任何更新。 使用content_updated取得內容更新的相關資訊。
語言	language	string	問題語言

概念標籤匹配

名稱	路徑	類型	Description
concept_id	concept_id	string	獨特的概念 id
描述	description	string	概念描述
is_flat	is_flat	boolean	is_flat
label_match	label_match	string	與概念相匹配的標籤
語言	language	string	概念語言
ontology_id	ontology_id	string	概念所屬的唯一本體ID
primary_label	primary_label	string	概念主要標籤

UserId

用於在 Starmind 平台上指稱使用者的唯一使用者識別碼（UUID）。

用於在 Starmind 平台上指稱使用者的唯一使用者識別碼（UUID）。

uuid

UserV3

包含使用者資訊的使用者物件。

名稱	路徑	類型	Description
關於	about	string	使用者在「關於我」區塊中輸入的自訂文字，用以描述自己
avatar_url	avatar_url	string	使用者頭像圖片的網址
公司	company	string	使用者公司
country	country	string	使用者的 ISO 3166-1 alpha-2 國家代碼（例如 ch、美國、德國）
created	created	date-time	顯示使用者創建時間戳記（yyyy-MM-ddTHH：mm：ss.fffZ）
已刪除	deleted	date-time	顯示使用者被刪除的時間戳記（yyyy-MM-ddTHH：mm：ss.fffZ）。 沒有管理員權限，只有未被刪除的使用者會被回傳
部門	department	string	使用者部門
電子郵件	email	email	使用者的電子郵件
first_name	first_name	string	使用者的名字。
first_seen	first_seen	date-time	顯示使用者首次登入的時間戳記（yyyy-MM-ddTHH：mm：ss.fffZ）
識別碼	id	UserId	用於在 Starmind 平台上指稱使用者的唯一使用者識別碼（UUID）。
is_federated	is_federated	boolean	顯示使用者是否使用本地憑證（電子郵件/密碼）而非外部 SSO 提供者（SAML、OpenID Connect）進行認證
is_technical	is_technical	boolean	顯示使用者是否為技術 API 使用者（非互動式/機器帳號）;當為真時，使用者通常透過 API 金鑰進行認證
語言	language	Language	ISO 639-1 兩字母語言代碼（例如「en」）代表支援語言。 「xx」可用來表示未知語言。
姓氏	last_name	string	使用者的姓氏。
位置	location	string	使用者的位置
位置	position	string	使用者公司

語言

ISO 639-1 兩字母語言代碼（例如「en」）代表支援語言。 「xx」可用來表示未知語言。

ISO 639-1 兩字母語言代碼（例如「en」）代表支援語言。 「xx」可用來表示未知語言。

string

ExpertConceptScores

專家搜尋概念配對，包括分數。

名稱	路徑	類型	Description
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	所有可用於不同語言的標籤
描述	concept.labels_for_languages.description	string	描述
description_type	concept.labels_for_languages.description_type	string	description_type
語言	concept.labels_for_languages.language	Language	ISO 639-1 兩字母語言代碼（例如「en」）代表支援語言。 「xx」可用來表示未知語言。
labels	concept.labels_for_languages.labels	array of string	labels
primary_label	concept.labels_for_languages.primary_label	string	語言的主要標籤
last_update	concept.last_update	date-time	last_update
ontology_id	concept.ontology_id	string	ontology_id
父母	concept.parents	array of uuid	父概念 ID
分數	score	float	分數

GraphQLUserResponse

名稱	路徑	類型	Description
使用者	data.user	UserV3	包含使用者資訊的使用者物件。
錯誤	errors	array of GraphQLError	可選的 GraphQL 錯誤陣列;僅在發生錯誤時才會顯示

GraphQLError

名稱	路徑	類型	Description
字碼	extensions.code	string
地點	locations	array of object
column	locations.column	integer
線條	locations.line	integer
訊息	message	string
路徑	path	array of string