Starmind (предварительная версия)

Соединитель Starmind обеспечивает простую интеграцию с подсистемой знаний Starmind, позволяя пользователям получать доступ к проверенным ответам и аналитическим сведениям экспертов по всей организации. Подключившись к Starmind, рабочие процессы и агенты могут интеллектуально получать ответы на критически важные для бизнеса вопросы, знания экспертов по поверхности и оптимизировать процессы принятия решений.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Премия	Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD)
Power Apps	Премия	Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Power Automate	Премия	Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)

Контакт
Имя	Специалисты по технической поддержке Starmind готовы слушать и помочь
URL	https://starmind.atlassian.net/servicedesk/customer/portal/2
Адрес электронной почты	product@starmind.com

Метаданные соединителя
Publisher	Starmind (inc)
Website	https://starmind.ai
Политика конфиденциальности	https://www.starmind.ai/privacy-policy
Категории	Продуктивность; Сотрудничество

Starmind

Разблокируйте правильный опыт точно, когда вам нужно.
Расширенный механизм знаний Starmind определяет экспертов в вашей организации и мгновенно подключает вас к их аналитическим сведениям— без проблем интеграции человеческой аналитики в ежедневные рабочие процессы.

Соединитель Starmind позволяет легко интегрироваться с подсистемой знаний Starmind, позволяя пользователям получать доступ к проверенным ответам и подключаться к экспертам по всей организации. Подключившись к Starmind, рабочие процессы Power Automate или агенты Copilot могут интеллектуально получать ответы на критически важные для бизнеса вопросы, знания экспертов по поверхности и оптимизировать процессы принятия решений.

Издатель: имя издателя

Starmind

Предпосылки

Чтобы использовать эту интеграцию, вам потребуется сеть Starmind, подготовленная для интеграции. Пожалуйста, запросить настройку через канал технической поддержки Starmind. Соединитель можно использовать с любым планом Starmind.

Поддерживаемые операции

FindExperts

Находит экспертов на основе предоставленного содержимого.

FindQuestions

Находит вопросы на основе предоставленных параметров запроса.

PostQuestion

Создает новый черновик вопросов.

PublishQuestion

Публикует черновик вопросов.

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
  }
}

Получение учетных данных

Чтобы получить ключ API для Starmind, необходимо обратиться к руководителю учетной записи Starmind или группе поддержки через наш канал технической поддержки

Известные проблемы и ограничения

Этот соединитель проходит проверку подлинности исключительно через ключ API.

Доступ выполняется с помощью технической учетной записи пользователя.
Проверка подлинности OAuth в контексте пользователя, вошедшего в систему, не поддерживается.

Часто задаваемые вопросы

Что необходимо для использования этого соединителя с сетью Starmind?

Как получить новый ключ API?

Инструкции по развертыванию

Используйте эти инструкции для развертывания этого соединителя в качестве пользовательского соединителя в Microsoft Power Automate.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:


По умолчанию	Параметры для создания подключения.	Все регионы	Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательно
Сеть Starmind. Пример: yourcompany.starmind.com	струна	Укажите сеть Starmind. Пример: yourcompany.starmind.com	True
Ключ API, предоставляемый Starmind	securestring	Введите ключ API, предоставленный Starmind	True

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	100	60 секунд

Действия

Поиск вопросов	Поиск вопросов с помощью необязательных `query`, `limit` (по умолчанию 10) `filter`и `sort`; возвращает коллекцию с разбивкой на страницы с вопросом `items`. По умолчанию возвращаются все опубликованные вопросы, упорядоченные по их последнему действию (убыванию). К результату можно применить сочетание фильтров, поисковых запросов и условий упорядочивания.
Поиск экспертов	Находит экспертов на основе предоставленных text_query. Поиск использует граф знаний для идентификации пользователей с соответствующим опытом и знаниями, связанными с запросом. Укажите необязательный язык, чтобы указать предпочтительный язык для фильтрации меток концепции. Это не влияет на само соответствие поиска; Он фильтрует только тот опыт, который мы отображаем от возвращаемых пользователей, выбрав основные понятия на основе основной метки на выбранном языке. Возвращаемые понятия дедупликируются, если несколько концепций используют одну и ту же основную метку.
Получение пользователя по идентификатору	Извлекает сведения о пользователе на основе предоставленного идентификатора пользователя.
Публикация вопроса	Публикует черновик вопроса. Публикация запроса активирует поиск экспертов, делает его обнаруживаемым и позволяет другим пользователям отвечать на него. Вопросы всегда публикуются анонимно.
Создание черновика вопроса	Создает новый черновик вопросов. Проект еще не доступен для поиска или ответа другими пользователями. После создания опубликуйте черновик (через конечную точку публикации), чтобы активировать поиск экспертов, сделать его обнаруживаемым и разрешить другим пользователям ответить на него. Предоставление необязательного описания помогает экспертам лучше понять вопрос и повышает вероятность получения высококачественных ответов.

Поиск вопросов

Идентификатор операции:: FindQuestions_V3

Поиск вопросов с помощью необязательных query, limit (по умолчанию 10) filterи sort; возвращает коллекцию с разбивкой на страницы с вопросом items. По умолчанию возвращаются все опубликованные вопросы, упорядоченные по их последнему действию (убыванию). К результату можно применить сочетание фильтров, поисковых запросов и условий упорядочивания.

Параметры

Имя	Ключ	Тип	Описание
Поиск запросов на вопросы	query	string	Запрос поиска вопросов
Максимальное количество вопросов для возврата	limit	integer	Ограничить количество возвращаемых вопросов. Значение по умолчанию равно 10.
Предопределенный фильтр для вопросов	filter	string	Отфильтруйте список вопросов с помощью предопределенного фильтра.
Критерии сортировки вопросов	sort	string	Укажите критерии, по которым будет отсортирован результат

Возвращаемое значение

Имя	Путь	Тип	Описание
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. Поиск использует граф знаний для идентификации пользователей с соответствующим опытом и знаниями, связанными с запросом. Укажите необязательный язык, чтобы указать предпочтительный язык для фильтрации меток концепции. Это не влияет на само соответствие поиска; Он фильтрует только тот опыт, который мы отображаем от возвращаемых пользователей, выбрав основные понятия на основе основной метки на выбранном языке. Возвращаемые понятия дедупликируются, если несколько концепций используют одну и ту же основную метку.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
language	language		string	Код языка ISO 639-1 (например, en), представляющий поддерживаемый язык. "xx" можно использовать для указания неизвестного языка.
text_query	text_query	True	string	Основной текст поиска для выявления экспертов. Может быть вопросом, сводкой текста, одной или нескольких тем.

Возвращаемое значение

Имя	Путь	Тип	Описание
Экспертов	experts	array of object	Список экспертов, соответствующих поисковому запросу. Может быть пустым, если эксперты не найдены.
concept_scores	experts.concept_scores	ExpertConceptScores	Совпадения концепции поиска экспертов, включая оценки.
счёт	experts.score	float	Оценка релевантности, указывающая, насколько хорошо эксперт соответствует запросу
Пользователь	experts.user	UserV3	Объект пользователя, содержащий сведения о пользователе.
label_matches	label_matches	array of ConceptLabelMatch	Соответствующие метки для запроса поиска эксперта. Может быть пустым, если метки не соответствуют.

Получение пользователя по идентификатору

Идентификатор операции:: GetUserById_V3

Извлекает сведения о пользователе на основе предоставленного идентификатора пользователя.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор пользователя	id	True	string	Уникальный глобальный идентификатор пользователя (UUID) в качестве параметра пути, используемого для ссылки на пользователя на платформе Starmind.

Возвращаемое значение

Тело: GraphQLUserResponse

Публикация вопроса

Идентификатор операции:: PublishQuestionDraft_V3

Публикует черновик вопроса. Публикация запроса активирует поиск экспертов, делает его обнаруживаемым и позволяет другим пользователям отвечать на него. Вопросы всегда публикуются анонимно.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор вопроса для публикации	questionId	True	integer	Идентификатор проекта вопроса, который будет опубликован

Возвращаемое значение

Имя	Путь	Тип	Описание
number_of_experts	number_of_experts	integer	number_of_experts

Создание черновика вопроса

Идентификатор операции:: PostQuestionDraft_V3

Создает новый черновик вопросов. Проект еще не доступен для поиска или ответа другими пользователями. После создания опубликуйте черновик (через конечную точку публикации), чтобы активировать поиск экспертов, сделать его обнаруживаемым и разрешить другим пользователям ответить на него. Предоставление необязательного описания помогает экспертам лучше понять вопрос и повышает вероятность получения высококачественных ответов.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
категория	category		integer	Необязательный идентификатор категории для назначения черновика вопроса
title	title	True	string	Заголовок вопроса: от 4 до 100 символов по умолчанию. В зависимости от конфигурации сети максимальная длина заголовка может быть ограничена или расширена дальше.
описание	description		string	Необязательное описание вопроса, предоставляющее подробный контекст и сведения о вопросе. В зависимости от конфигурации сети описание может быть применено к непустой.
language	language		string	Код языка ISO 639-1 (например, en), представляющий поддерживаемый язык. "xx" можно использовать для указания неизвестного языка.
knowledge_space	knowledge_space		integer	Идентификатор пространства знаний, назначаемого вопросу

Возвращаемое значение

Тело: Question

Определения

Question

Имя	Путь	Тип	Описание
knowledge_space_id	knowledge_space_id	integer	Уникальный идентификатор пространства знаний, к которому принадлежит вопрос.
upvote_count	upvote_count	integer	Общее число upvotes, полученное вопросом.
view_count	view_count	integer	Количество просмотров вопроса пользователями.
Дата публикации	published	date-time	Метка времени, указывающая, когда был опубликован вопрос (гггг-ММ-ддTHH:мм:ss.fffZ)
is_deleted	is_deleted	boolean	Указывает, удаляется ли вопрос. Удаленные вопросы не видны пользователям, но по-прежнему могут получать доступ к администраторам.
title	title	string	Заголовок вопроса
Дата последнего действия	last_activity	date-time	Метка времени, указывающая последнее действие с вопросом (гггг-ММ-ддTHH:мм:ss.fffZ)
is_published	is_published	boolean	Вопрос is_published флаг указывает, публикуется ли вопрос. Опубликованное решение отображается всем пользователям, в то время как неопубликованное решение находится в состоянии черновика только для автора.
Дата создания	created	date-time	Метка времени, указывающая, когда был создан вопрос (гггг-ММ-ддTHH:мм:ss.fffZ)
описание	description	string	Описание вопроса, предоставляющее подробный контекст и сведения о вопросе
solution_count	solution_count	integer	Это число решений, которые были предоставлены для этого вопроса.
Дата обновления содержимого	content_updated	date-time	Метка времени, указывающая, когда содержимое или вложение вопроса были обновлены (гггг-ММ-ddTHH:мм:ss.fffZ)
id	id	integer	Уникальный идентификатор вопроса
Дата обновления вопроса	updated	date-time	При последнем обновлении ресурса в базе данных. Эта дата не отражает обновления содержимого, но любое обновление для любых полей записи. Используйте content_updated для получения сведений об обновлениях содержимого.
language	language	string	Язык вопросов

ConceptLabelMatch

Имя	Путь	Тип	Описание
concept_id	concept_id	string	Уникальный идентификатор концепции
описание	description	string	Описание концепции
is_flat	is_flat	boolean	is_flat
label_match	label_match	string	Метка, соответствующая концепции
language	language	string	Язык концепции
ontology_id	ontology_id	string	Уникальный идентификатор ontology, к которому принадлежит концепция
primary_label	primary_label	string	Основная метка концепции

UserId

Уникальный идентификатор пользователя (UUID), используемый для ссылки на пользователя на платформе Starmind.

: uuid

UserV3

Объект пользователя, содержащий сведения о пользователе.

Имя	Путь	Тип	Описание
О	about	string	Пользовательский текст, введенный пользователем, чтобы описать себя в разделе "О мне"
avatar_url	avatar_url	string	URL-адрес изображения аватара пользователя
компания	company	string	Компания пользователя
country	country	string	Код страны ISO 3166-1 alpha-2 (например, ch, de) пользователя
создано	created	date-time	Метка времени, указывающая, когда пользователь был создан (гггг-ММ-ддTHH:мм:ss.fffZ)
удалено	deleted	date-time	Метка времени, указывающая, когда пользователь был удален (гггг-ММ-ddTHH:мм:ss.fffZ). Без разрешений администратора возвращается только не удаленный пользователь
отдел	department	string	Отдел пользователя
электронная почта	email	email	Электронная почта пользователя
первое имя	first_name	string	Имя пользователя.
first_seen	first_seen	date-time	Метка времени, указывающая, когда пользователь вошел в систему в первый раз (гггг-ММ-ддTHH:мм:ss.fffZ)
id	id	UserId	Уникальный идентификатор пользователя (UUID), используемый для ссылки на пользователя на платформе Starmind.
is_federated	is_federated	boolean	Указывает, выполняется ли проверка подлинности пользователя с помощью локальных учетных данных (email/password), а не внешнего поставщика единого входа (SAML, OpenID Connect)
is_technical	is_technical	boolean	Указывает, является ли пользователь техническим пользователем API (неинтерактивная или компьютерная учетная запись); если пользователь обычно выполняет проверку подлинности с помощью ключа API
language	language	Language	Код языка ISO 639-1 (например, en), представляющий поддерживаемый язык. "xx" можно использовать для указания неизвестного языка.
Фамилия	last_name	string	Фамилия пользователя.
location	location	string	Расположение пользователя
позиция	position	string	Компания пользователя

Language

Код языка ISO 639-1 (например, en), представляющий поддерживаемый язык. "xx" можно использовать для указания неизвестного языка.

: string

ExpertConceptScores

Совпадения концепции поиска экспертов, включая оценки.

Имя	Путь	Тип	Описание
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
language	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	Идентификаторы родительской концепции
счёт	score	float	счёт

GraphQLUserResponse

Имя	Путь	Тип	Описание
Пользователь	data.user	UserV3	Объект пользователя, содержащий сведения о пользователе.
Ошибки	errors	array of GraphQLError	Необязательный массив ошибок GraphQL; только в том случае, если произошли ошибки

GraphQLError

Имя	Путь	Тип
код	extensions.code	string
местоположения	locations	array of object
column	locations.column	integer
линия	locations.line	integer
сообщение	message	string
путь	path	array of string

Поделиться через

Starmind (предварительная версия)

Starmind

Издатель: имя издателя

Предпосылки

Поддерживаемые операции

FindExperts

FindQuestions

PostQuestion

PublishQuestion

GetUserById

GetQuestion (не рекомендуется)

ResolveUser (не рекомендуется)

Получение учетных данных

Известные проблемы и ограничения

Часто задаваемые вопросы

Что необходимо для использования этого соединителя с сетью Starmind?

Как получить новый ключ API?

Инструкции по развертыванию

Создание подключения

По умолчанию

Ограничения регулирования

Действия

Поиск вопросов

Параметры

Возвращаемое значение

Поиск экспертов

Параметры

Возвращаемое значение

Получение пользователя по идентификатору

Параметры

Возвращаемое значение

Публикация вопроса

Параметры

Возвращаемое значение

Создание черновика вопроса

Параметры

Возвращаемое значение

Определения

Question

ConceptLabelMatch

UserId

UserV3

Language

ExpertConceptScores

GraphQLUserResponse

GraphQLError