Microsoft Copilot Studio

Microsoft Copilot Studio que se usan para detectar y desencadenar agentes

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

Service	Class	Regions
Copilot Studio	Estándar	Todas las regiones Power Automate excepto las siguientes: - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)
Power Apps	Estándar	Todas las regiones Power Apps excepto las siguientes: - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)
Power Automate	Estándar	Todas las regiones Power Automate excepto las siguientes: - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD)

Contacto
Nombre	Microsoft Copilot Studio
URL	https://aka.ms/copilotstudio
Correo Electrónico	donglei@microsoft.com

Metadatos del conector
Publisher	Microsoft
Sitio web	https://aka.ms/copilotstudio
Directiva de privacidad	https://www.microsoft.com/en-us/privacy/privacystatement
Categorías	AI

Límites generales

Nombre	Importancia
Conexiones por cuenta	50

Creación de una conexión

El conector admite los siguientes tipos de autenticación:


Oauth	Inicie sesión con Microsoft Entra ID en Power Platform API.	Todas las regiones	No se puede compartir
Valor predeterminado [EN DESUSO]	Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.	Todas las regiones	No se puede compartir

OAuth

Identificador de autenticación: oauthDefault

Aplicable: Todas las regiones

Inicie sesión con Microsoft Entra ID en Power Platform API.

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.

Valor predeterminado [EN DESUSO]

Aplicable: Todas las regiones

Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.

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.

Limitaciones

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

Acciones

Ejecutar agente	Envía un mensaje al Agente especificado para su procesamiento
Ejecutar agente y esperar	Envía un mensaje al Agente especificado para su procesamiento y espera a reanudarse.
Evaluar agente	Evalúa un agente mediante un conjunto de pruebas específico.
Obtención de los detalles de la ejecución de pruebas del agente	Obtiene los detalles de una ejecución de prueba de evaluación de creador específica.
Obtener conjuntos de pruebas del agente	Obtiene los conjuntos de pruebas de un agente.
Obtener detalles del conjunto de pruebas del agente	Obtiene los detalles de un conjunto de pruebas de evaluación de creador específico.
Obtener ejecuciones de pruebas del agente	Obtiene las ejecuciones de pruebas de evaluación del creador para el Agente especificado.

Ejecutar agente

Id. de la operación:: ExecuteCopilot

Envía un mensaje al Agente especificado para su procesamiento

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Agente	Copilot	True	string	Agente
Message	message	True	string	Message
Nombre de configuración regional BCP-47 para el contenido del campo de texto.	locale		string	Nombre de configuración regional BCP-47 para el contenido del campo de texto.
tipo de contenido	contentType		string
URL de contenido	contentUrl		string
contenido	content		object
nombre	name		string
URL de miniatura	thumbnailUrl		string
Id. de la conversación	x-ms-conversation-id		string	Proporcione el identificador de conversación exisiting para reanudar la ejecución del agente.
Id. de entorno	environmentId		string	Identificador de entorno opcional

Devoluciones

Nombre	Ruta de acceso	Tipo	Description
ConversationId	ConversationId	string	Identificador de conversación asociado a la respuesta

Ejecutar agente y esperar

Id. de la operación:: ExecuteCopilotAsyncV2

Envía un mensaje al Agente especificado para su procesamiento y espera a reanudarse.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Agente	Copilot	True	string	Agente
Message	message		string	Message
Nombre de configuración regional BCP-47 para el contenido del campo de texto.	locale		string	Nombre de configuración regional BCP-47 para el contenido del campo de texto.
tipo de contenido	contentType		string
URL de contenido	contentUrl		string
contenido	content		object
nombre	name		string
URL de miniatura	thumbnailUrl		string
Id. de la conversación	x-ms-conversation-id		string	Proporcione el identificador de conversación exisiting para reanudar la ejecución del agente.
Id. de entorno	environmentId		string	Identificador de entorno opcional

Devoluciones

Nombre	Ruta de acceso	Tipo	Description
lastResponse	lastResponse	string	La última respuesta de texto de la lista de actividades
respuestas	responses	array of string	Lista de respuestas de cadena en la lista de actividades
Id de conversación	conversationId	string	Identificador de conversación asociado a la respuesta

Evaluar agente

Id. de la operación:: RunAgentMakerEvaluationTestSet

Evalúa un agente mediante un conjunto de pruebas específico.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Agente	Agent	True	string	seleccione un agente en la lista desplegable o escriba un valor personalizado (el identificador del agente).
Conjunto de pruebas	TestSetId	True	string	Seleccione un conjunto de pruebas en la lista desplegable o escriba un valor personalizado (el identificador del conjunto de pruebas).
Identificador de conexión de MCS	mcsConnectionId		string	Seleccione Perfil de usuario: escriba el identificador de conexión de MCS o deje vacío para la ejecución anónima.
Nombre de ejecución de evaluación	evaluationRunName		string	Escriba un nombre para la ejecución de evaluación o deje vacío.

Devoluciones

Body: RunStatusResponse

Obtención de los detalles de la ejecución de pruebas del agente

Id. de la operación:: GetAgentMakerEvaluationTestRunDetails

Obtiene los detalles de una ejecución de prueba de evaluación de creador específica.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Agente	Agent	True	string	seleccione un agente en la lista desplegable o escriba un valor personalizado (el identificador del agente).
Ejecución de evaluación	EvaluationRunId	True	string	Seleccione la ejecución de evaluación en la lista desplegable o escriba un valor personalizado (el identificador de ejecución de evaluación).

Devoluciones

Body: TestRun

Obtener conjuntos de pruebas del agente

Id. de la operación:: GetAgentMakerEvaluationTestSets

Obtiene los conjuntos de pruebas de un agente.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Agente	Agent	True	string	seleccione un agente en la lista desplegable o escriba un valor personalizado (el identificador del agente).

Devoluciones

Body: TestSetsResponse

Obtener detalles del conjunto de pruebas del agente

Id. de la operación:: GetAgentMakerEvaluationTestSetDetails

Obtiene los detalles de un conjunto de pruebas de evaluación de creador específico.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Agente	Agent	True	string	seleccione un agente en la lista desplegable o escriba un valor personalizado (el identificador del agente).
Conjunto de pruebas	TestSetId	True	string	Seleccione un conjunto de pruebas en la lista desplegable o escriba un valor personalizado (el identificador del conjunto de pruebas).

Devoluciones

Body: TestSet

Obtener ejecuciones de pruebas del agente

Id. de la operación:: GetAgentMakerEvaluationTestRuns

Obtiene las ejecuciones de pruebas de evaluación del creador para el Agente especificado.

Parámetros

Nombre	Clave	Requerido	Tipo	Description
Agente	Agent	True	string	seleccione un agente en la lista desplegable o escriba un valor personalizado (el identificador del agente).

Devoluciones

Body: TestRunsResponse

Definiciones

TestSetsResponse

Nombre	Ruta de acceso	Tipo	Description
value	value	array of TestSet

TestSet

Nombre	Ruta de acceso	Tipo
id	id	string
Nombre para mostrar	displayName	string
totalTestCases	totalTestCases	integer
descripción	description	string
auditInfo	auditInfo	AuditInfo
estado	state	string

AuditInfo

Nombre	Ruta de acceso	Tipo
createdBy	createdBy	string
createdTimeUtc	createdTimeUtc	date-time
modifiedBy	modifiedBy	string
modifiedTimeUtc	modifiedTimeUtc	date-time

TestRunsResponse

Nombre	Ruta de acceso	Tipo	Description
value	value	array of TestRun

TestRun

Nombre	Ruta de acceso	Tipo
id	id	string
environmentId	environmentId	string
cdsBotId	cdsBotId	string
ownerId	ownerId	string
testSetId	testSetId	string
estado	state	string
startTime	startTime	date-time
endTime	endTime	date-time
nombre	name	string
totalTestCases	totalTestCases	integer
msConnectionId	msConnectionId	string
testCasesResults	testCasesResults	array of TestCaseResult

TestCaseResult

Nombre	Ruta de acceso	Tipo
testCaseId	testCaseId	string
estado	state	string
metricsResults	metricsResults	array of TestCaseMetric

TestCaseMetric

Nombre	Ruta de acceso	Tipo	Description
tipo	type	string
resultado	result	TestCaseMetricResult

TestCaseMetricResult

Nombre	Ruta de acceso	Tipo
datos	data	object
estado	status	string
errorReason	errorReason	string
aiResultReason	aiResultReason	string

RunStatusResponse

Nombre	Ruta de acceso	Tipo
runId	runId	string
lastUpdatedAt	lastUpdatedAt	date-time
estado	state	string
executionState	executionState	string
totalTestCases	totalTestCases	integer
testCasesProcessed	testCasesProcessed	integer