Starmind (versión preliminar)

El conector Starmind permite una integración perfecta con el motor de conocimiento de Starmind, lo que permite a los usuarios acceder a respuestas comprobadas e información experta en toda su organización. Al conectarse a Starmind, los flujos de trabajo y los agentes pueden recuperar de forma inteligente respuestas a preguntas críticas para la empresa, conocimientos expertos y simplificar los procesos de toma de decisiones.

Este conector está disponible en los siguientes productos y regiones:

Service	Class	Regions
Copilot Studio	Premium	Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas	Estándar	Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD)
Power Apps	Premium	Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)
Power Automate	Premium	Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)

Contacto
Nombre	Los expertos en soporte técnico de Starmind están listos para escuchar y ayudar
URL	https://starmind.atlassian.net/servicedesk/customer/portal/2
Correo Electrónico	product@starmind.com

Metadatos del conector
Publicador	Starmind (inc)
Website	https://starmind.ai
Directiva de privacidad	https://www.starmind.ai/privacy-policy
Categorías	Productividad; Colaboración

Starmind

Desbloquee la experiencia correcta exactamente cuando lo necesite.
El motor de conocimiento avanzado de Starmind identifica a los expertos de su organización y le conecta al instante con sus conclusiones, integrando sin problemas la inteligencia humana en los flujos de trabajo diarios.

El conector Starmind permite una integración perfecta con el motor de conocimiento de Starmind, lo que permite a los usuarios acceder a respuestas comprobadas y conectarse con expertos en toda su organización. Al conectarse a Starmind, los flujos de trabajo de Power Automate o los agentes de Copilot pueden recuperar de forma inteligente respuestas a preguntas críticas para la empresa, conocimientos expertos en superficie y simplificar los procesos de toma de decisiones.

Publicador: nombre del publicador

Starmind

Prerrequisitos

Para usar esta integración, necesitará una red Starmind preparada para la integración. Solicite la configuración a través del canal de soporte técnico de Starmind. El conector se puede usar con cualquier plan Starmind.

Operaciones admitidas

FindExperts

Busca expertos en función del contenido proporcionado.

FindQuestions

Busca preguntas basadas en los parámetros de consulta proporcionados.

PostQuestion

Crea un nuevo borrador de pregunta.

PublishQuestion

Publica el borrador de la pregunta.

GetUserById

Recupera los detalles del usuario.

GetQuestion (en desuso)

Recupera los detalles completos de una pregunta, incluidas las soluciones, los comentarios y los conceptos por su identificador.

ResolveUser (en desuso)

Resuelve globalUserId en el objeto user. Proporcione la consulta graphQL para recuperar el objeto de usuario de la siguiente manera:

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

Obtención de credenciales

Para obtener una clave de API para Starmind, debe ponerse en contacto con el administrador de cuentas o el equipo de soporte técnico de Starmind a través de nuestro canal de soporte técnico.

Problemas conocidos y limitaciones

Este conector se autentica exclusivamente a través de la clave de API.

El acceso se realiza a través de una cuenta de usuario técnica.
No se admite la autenticación de OAuth en el contexto del usuario que ha iniciado sesión.

Preguntas más frecuentes

¿Qué es necesario para usar este conector con una red Starmind?

Para usar esta integración, necesitará una red Starmind preparada para la integración. Solicite la configuración a través del canal de soporte técnico de Starmind.

¿Cómo puedo obtener una nueva clave de API?

Para obtener una clave de API para Starmind, debe ponerse en contacto con el administrador de cuentas o el equipo de soporte técnico de Starmind a través de nuestro canal de soporte técnico.

Instrucciones de implementación

Use estas instrucciones para implementar este conector como un conector personalizado en Microsoft Power Automate.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:


Predeterminado	Parámetros para crear una conexión.	Todas las regiones	No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre	Tipo	Description	Obligatorio
La red Starmind. Ejemplo: yourcompany.starmind.com	cuerda / cadena	Especifique la red Starmind. Ejemplo: yourcompany.starmind.com	Cierto
Clave de API proporcionada por Starmind	securestring	Escriba la clave de API proporcionada por Starmind.	Cierto

Limitaciones

Nombre	Llamadas	Período de renovación
Llamadas API por conexión	100	60 segundos

Acciones

Buscar preguntas	Busca preguntas mediante `query`, `limit` (valor predeterminado 10), `filter`y `sort`; devuelve una colección paginada con la pregunta `items`. De forma predeterminada, se devuelven todas las preguntas publicadas, ordenadas por su última actividad (descendente). Se puede aplicar una combinación de filtros, consultas de búsqueda y criterios de ordenación al resultado.
Búsqueda de expertos	Busca expertos basados en el text_query proporcionado. La búsqueda aprovecha el gráfico de conocimiento para identificar a los usuarios con conocimientos y conocimientos relevantes relacionados con la consulta. Proporcione el idioma opcional para especificar el idioma preferido para el filtrado de etiquetas de concepto. Esto no afecta a la búsqueda en sí misma; solo filtra qué experiencia mostramos de los usuarios devueltos seleccionando conceptos basados en la etiqueta principal en el idioma elegido. Los conceptos devueltos se desduplican cuando varios conceptos comparten la misma etiqueta principal.
Crear un borrador de pregunta	Crea un nuevo borrador de pregunta. El borrador aún no es accesible ni respondeble por otros usuarios. Después de la creación, publique el borrador (a través del punto de conexión de publicación) para desencadenar la búsqueda de expertos, hacer que la pregunta sea reconocible y permitir que otros usuarios lo respondan. Proporcionar la descripción opcional ayuda a los expertos a comprender mejor la pregunta y aumenta las posibilidades de obtener respuestas de alta calidad.
Obtención del usuario por identificador	Recupera información de usuario basada en el identificador de usuario proporcionado.
Publicar una pregunta	Publica un borrador de pregunta. La publicación de la pregunta desencadena la búsqueda de expertos, hace que la pregunta sea reconocible y permite a otros usuarios responderla. Las preguntas siempre se publican de forma anónima.

Buscar preguntas

Id. de la operación:: FindQuestions_V3

Busca preguntas mediante query, limit (valor predeterminado 10), filtery sort; devuelve una colección paginada con la pregunta items. De forma predeterminada, se devuelven todas las preguntas publicadas, ordenadas por su última actividad (descendente). Se puede aplicar una combinación de filtros, consultas de búsqueda y criterios de ordenación al resultado.

Parámetros

Nombre	Clave	Tipo	Description
Consulta de búsqueda de preguntas	query	string	Consulta de búsqueda de preguntas
Número máximo de preguntas que se van a devolver	limit	integer	Limite el número de preguntas devueltas. El valor predeterminado es 10.
Filtro predefinido para preguntas	filter	string	Filtre la lista de preguntas mediante un filtro predefinido.
Criterio de ordenación de preguntas	sort	string	Especificar los criterios por los que se ordena el resultado

Devoluciones

Nombre	Ruta de acceso	Tipo	Description
href	_links.self.href	string	href
href	_links.next.href	string	href
href	_links.last.href	string	href
items	items	array of Question	Resultados paginados de la búsqueda de preguntas.
total	total	integer	Número total de preguntas que coinciden con la solicitud.

Búsqueda de expertos

Id. de la operación:: FindExperts_V3

Busca expertos basados en el text_query proporcionado. La búsqueda aprovecha el gráfico de conocimiento para identificar a los usuarios con conocimientos y conocimientos relevantes relacionados con la consulta. Proporcione el idioma opcional para especificar el idioma preferido para el filtrado de etiquetas de concepto. Esto no afecta a la búsqueda en sí misma; solo filtra qué experiencia mostramos de los usuarios devueltos seleccionando conceptos basados en la etiqueta principal en el idioma elegido. Los conceptos devueltos se desduplican cuando varios conceptos comparten la misma etiqueta principal.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
lenguaje	language		string	Código de idioma de dos letras ISO 639-1 (por ejemplo, "en") que representa un idioma admitido. 'xx' se puede usar para indicar un idioma desconocido.
text_query	text_query	True	string	Texto de búsqueda principal para identificar expertos. Puede ser una pregunta, un resumen de un texto, uno o varios temas.

Devoluciones

Nombre	Ruta de acceso	Tipo	Description
Expertos	experts	array of object	Lista de expertos que coinciden con la consulta de búsqueda. Puede estar vacío si no se encuentra ningún experto.
concept_scores	experts.concept_scores	ExpertConceptScores	El concepto de búsqueda experto coincide con las puntuaciones.
puntuación	experts.score	float	Puntuación de relevancia que indica el grado de coincidencia del experto con la consulta
user	experts.user	UserV3	Objeto de usuario que contiene información del usuario.
label_matches	label_matches	array of ConceptLabelMatch	Etiquetas coincidentes para la consulta de búsqueda de expertos. Puede estar vacío si no coinciden las etiquetas.

Crear un borrador de pregunta

Id. de la operación:: PostQuestionDraft_V3

Crea un nuevo borrador de pregunta. El borrador aún no es accesible ni respondeble por otros usuarios. Después de la creación, publique el borrador (a través del punto de conexión de publicación) para desencadenar la búsqueda de expertos, hacer que la pregunta sea reconocible y permitir que otros usuarios lo respondan. Proporcionar la descripción opcional ayuda a los expertos a comprender mejor la pregunta y aumenta las posibilidades de obtener respuestas de alta calidad.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
categoría	category		integer	Identificador opcional de la categoría para asignar el borrador de pregunta a
title	title	True	string	Título de la pregunta, entre 4 y 100 caracteres de forma predeterminada. Dependiendo de la configuración de red, la longitud máxima del título puede estar limitada o extendida más.
descripción	description		string	Descripción de la pregunta opcional que proporciona contexto detallado e información sobre la pregunta. En función de la configuración de red, es posible que la descripción se aplique para que no esté vacía.
lenguaje	language		string	Código de idioma de dos letras ISO 639-1 (por ejemplo, "en") que representa un idioma admitido. 'xx' se puede usar para indicar un idioma desconocido.
knowledge_space	knowledge_space		integer	el identificador del espacio de conocimiento al que asignar la pregunta.

Devoluciones

Body: Question

Obtención del usuario por identificador

Id. de la operación:: GetUserById_V3

Recupera información de usuario basada en el identificador de usuario proporcionado.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Identificador del usuario	id	True	string	El identificador de usuario global único (UUID) como parámetro de ruta de acceso usado para hacer referencia al usuario a través de la plataforma Starmind.

Devoluciones

Body: GraphQLUserResponse

Publicar una pregunta

Id. de la operación:: PublishQuestionDraft_V3

Publica un borrador de pregunta. La publicación de la pregunta desencadena la búsqueda de expertos, hace que la pregunta sea reconocible y permite a otros usuarios responderla. Las preguntas siempre se publican de forma anónima.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Identificador de la pregunta que se va a publicar	questionId	True	integer	Identificador del borrador de pregunta que se va a publicar

Devoluciones

Nombre	Ruta de acceso	Tipo	Description
number_of_experts	number_of_experts	integer	number_of_experts

Definiciones

Pregunta

Nombre	Ruta de acceso	Tipo	Description
knowledge_space_id	knowledge_space_id	integer	Identificador de espacio de conocimiento único al que pertenece la pregunta.
upvote_count	upvote_count	integer	Número total de invocaciones que ha recibido la pregunta.
view_count	view_count	integer	Número de veces que los usuarios han visto la pregunta.
Fecha de publicación	published	date-time	Marca de tiempo que indica cuándo se publicó la pregunta (aaaa-MM-ddTHH:mm:ss.fffZ)
is_deleted	is_deleted	boolean	Indica si se elimina la pregunta. Las preguntas eliminadas no son visibles para los usuarios, pero los administradores todavía pueden acceder a ellas.
title	title	string	Título de la pregunta
Fecha de la última actividad	last_activity	date-time	Marca de tiempo que indica la última actividad con la pregunta (aaaa-MM-ddTHH:mm:ss.fffZ)
is_published	is_published	boolean	La pregunta is_published marca indica si la pregunta se publica o no. Una solución publicada es visible para todos los usuarios, mientras que una solución no publicada está en estado borrador solo visible para el autor.
Fecha de creación	created	date-time	Marca de tiempo que indica cuándo se creó la pregunta (aaaa-MM-ddTHH:mm:ss.fffZ)
descripción	description	string	Descripción de la pregunta que proporciona contexto detallado e información sobre la pregunta
solution_count	solution_count	integer	Este es el número de soluciones que se han proporcionado para esta pregunta.
Fecha de actualización del contenido	content_updated	date-time	Marca de tiempo que indica cuándo se actualizaron por última vez el contenido o los datos adjuntos de la pregunta (aaaa-MM-ddTHH:mm:ss.fffZ)
id	id	integer	Identificador de pregunta único
fecha de actualización de preguntas	updated	date-time	Última vez que el recurso se ha actualizado en la base de datos. Esta fecha no refleja las actualizaciones de contenido, sino ninguna actualización de ningún campo del registro. Use content_updated para obtener información sobre las actualizaciones de contenido.
lenguaje	language	string	El idioma de la pregunta

ConceptLabelMatch

Nombre	Ruta de acceso	Tipo	Description
concept_id	concept_id	string	Identificador de concepto único
descripción	description	string	Descripción del concepto
is_flat	is_flat	boolean	is_flat
label_match	label_match	string	Etiqueta que coincide con el concepto
lenguaje	language	string	Lenguaje de concepto
ontology_id	ontology_id	string	Identificador de ontología único al que pertenece el concepto
primary_label	primary_label	string	Etiqueta principal de concepto

UserId

Identificador de usuario único (UUID) que se usa para hacer referencia a un usuario a través de la plataforma Starmind.

: uuid

UserV3

Objeto de usuario que contiene información del usuario.

Nombre	Ruta de acceso	Tipo	Description
acerca de	about	string	Texto personalizado escrito por el usuario para describirse en su sección "Acerca de mí"
avatar_url	avatar_url	string	Dirección URL a la imagen de avatar del usuario
empresa	company	string	Compañía del usuario
country	country	string	Código de país iso 3166-1 alfa-2 (por ejemplo, ch, us, de) del usuario
creado	created	date-time	Marca de tiempo que indica cuándo se creó el usuario (aaaa-MM-ddTHH:mm:ss.fffZ)
eliminado	deleted	date-time	Marca de tiempo que indica cuándo se eliminó el usuario (aaaa-MM-ddTHH:mm:ss.fffZ). Sin permisos de administrador, solo se devolverá un usuario no eliminado.
departamento	department	string	Departamento del usuario
Correo electrónico	email	email	Correo electrónico del usuario
primer nombre	first_name	string	Nombre del usuario.
first_seen	first_seen	date-time	Marca de tiempo que indica cuándo el usuario inició sesión por primera vez (aaaa-MM-ddTHH:mm:ss.fffZ)
id	id	UserId	Identificador de usuario único (UUID) que se usa para hacer referencia a un usuario a través de la plataforma Starmind.
is_federated	is_federated	boolean	Indica si el usuario se autentica mediante credenciales locales (correo electrónico y contraseña) en lugar de un proveedor de SSO externo (SAML, OpenID Connect)
is_technical	is_technical	boolean	Indica si el usuario es un usuario de API técnica (cuenta no interactiva o de máquina); cuando es true, el usuario se autentica normalmente a través de la clave de API
lenguaje	language	Language	Código de idioma de dos letras ISO 639-1 (por ejemplo, "en") que representa un idioma admitido. 'xx' se puede usar para indicar un idioma desconocido.
apellido	last_name	string	Apellidos del usuario.
location	location	string	Ubicación del usuario
posición	position	string	Compañía del usuario

Language

Código de idioma de dos letras ISO 639-1 (por ejemplo, "en") que representa un idioma admitido. 'xx' se puede usar para indicar un idioma desconocido.

: string

ExpertConceptScores

El concepto de búsqueda experto coincide con las puntuaciones.

Nombre	Ruta de acceso	Tipo	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	Todas las etiquetas disponibles para diferentes idiomas
descripción	concept.labels_for_languages.description	string	descripción
description_type	concept.labels_for_languages.description_type	string	description_type
lenguaje	concept.labels_for_languages.language	Language	Código de idioma de dos letras ISO 639-1 (por ejemplo, "en") que representa un idioma admitido. 'xx' se puede usar para indicar un idioma desconocido.
labels	concept.labels_for_languages.labels	array of string	labels
primary_label	concept.labels_for_languages.primary_label	string	Etiqueta principal del idioma
last_update	concept.last_update	date-time	last_update
ontology_id	concept.ontology_id	string	ontology_id
padres	concept.parents	array of uuid	Identificadores de concepto primarios
puntuación	score	float	puntuación

GraphQLUserResponse

Nombre	Ruta de acceso	Tipo	Description
user	data.user	UserV3	Objeto de usuario que contiene información del usuario.
Errores	errors	array of GraphQLError	Matriz opcional de errores de GraphQL; solo está presente si se produjeron errores

GraphQLError

Nombre	Ruta de acceso	Tipo
código	extensions.code	string
ubicaciones	locations	array of object
column	locations.column	integer
line	locations.line	integer
Mensaje	message	string
camino	path	array of string

Compartir a través de

Starmind (versión preliminar)

Starmind

Publicador: nombre del publicador

Prerrequisitos

Operaciones admitidas

FindExperts

FindQuestions

PostQuestion

PublishQuestion

GetUserById

GetQuestion (en desuso)

ResolveUser (en desuso)

Obtención de credenciales

Problemas conocidos y limitaciones

Preguntas más frecuentes

¿Qué es necesario para usar este conector con una red Starmind?

¿Cómo puedo obtener una nueva clave de API?

Instrucciones de implementación

Creación de una conexión

Predeterminado

Limitaciones

Acciones

Buscar preguntas

Parámetros

Devoluciones

Búsqueda de expertos

Parámetros

Devoluciones

Crear un borrador de pregunta

Parámetros

Devoluciones

Obtención del usuario por identificador

Parámetros

Devoluciones

Publicar una pregunta

Parámetros

Devoluciones

Definiciones

Pregunta

ConceptLabelMatch

UserId

UserV3

Language

ExpertConceptScores

GraphQLUserResponse

GraphQLError