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: - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Estándar | Todas las regiones Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Estándar | Todas las regiones Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC High) - 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 | |
|---|---|
| Publicador | 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:
| 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.
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
Envía un mensaje al Agente especificado para su procesamiento
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Agente
|
Copilot | True | string |
Agente |
|
Mensaje
|
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 |
|---|---|---|---|
|
ConversationId
|
ConversationId | string |
Identificador de conversación asociado a la respuesta |
Ejecutar agente y esperar
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
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. |
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.
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
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
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
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 | Description |
|---|---|---|---|
|
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 | Description |
|---|---|---|---|
|
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 | Description |
|---|---|---|---|
|
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 |