Microsoft Copilot Studio
Microsoft Copilot Studio usados para descobrir e disparar agentes
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Standard | Todas as regiões Power Apps exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Standard | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Microsoft Copilot Studio |
| URL | https://aka.ms/copilotstudio |
| donglei@microsoft.com |
| Metadados do conector | |
|---|---|
| Publicador | Microsoft |
| Website | https://aka.ms/copilotstudio |
| Política de privacidade | https://www.microsoft.com/en-us/privacy/privacystatement |
| Categorias | IA |
Limites Gerais
| Nome | Value |
|---|---|
| Conexões por conta | 50 |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 300 | 60 segundos |
Ações
| Avaliar Agente |
Avalia um agente usando um conjunto de testes específico. |
| Executar Agente |
Envia um prompt para o Agente especificado para processamento |
| Executar Agente e aguardar |
Envia um prompt para o Agente especificado para processamento e espera para retomar |
| Obter conjuntos de teste do agente |
Obtém os conjuntos de teste para um Agente. |
| Obter detalhes da execução de teste do agente |
Obtém os detalhes de uma execução de teste de avaliação específica do criador. |
| Obter detalhes do conjunto de testes do agente |
Obtém os detalhes de um conjunto de testes de avaliação do criador específico. |
| Obter execuções de teste do agente |
Obtém as execuções de teste de avaliação do criador para o Agente especificado. |
Avaliar Agente
Avalia um agente usando um conjunto de testes específico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Agente
|
Agent | True | string |
selecione um agente na lista suspensa ou insira um valor personalizado (a ID do agente). |
|
Conjunto de testes
|
TestSetId | True | string |
Selecione um conjunto de testes na lista suspensa ou insira um valor personalizado (a ID do conjunto de testes). |
|
ID de conexão do MCS
|
mcsConnectionId | string |
Selecionar Perfil de usuário – insira a ID de conexão do MCS ou deixe vazia para execução anônima. |
|
|
Nome da execução de avaliação
|
evaluationRunName | string |
Insira um nome para a execução de avaliação ou deixe vazio. |
Executar Agente
Envia um prompt para o Agente especificado para processamento
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Agente
|
Copilot | True | string |
Agente |
|
mensagem
|
message | string |
Message |
|
|
Um nome de localidade BCP-47 para o conteúdo do campo de texto.
|
locale | string |
Um nome de localidade BCP-47 para o conteúdo do campo de texto. |
|
|
tipo de conteúdo
|
contentType | string | ||
|
contentUrl
|
contentUrl | string | ||
|
conteúdo
|
content | object | ||
|
nome
|
name | string | ||
|
URL da miniatura
|
thumbnailUrl | string | ||
|
ID da conversa
|
x-ms-conversation-id | string |
Forneça a ID da conversa de exisiting para retomar a execução do Agente. |
|
|
ID do Ambiente
|
environmentId | string |
ID do ambiente opcional |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ConversationId
|
ConversationId | string |
A ID da conversa associada à resposta |
Executar Agente e aguardar
Envia um prompt para o Agente especificado para processamento e espera para retomar
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Agente
|
Copilot | True | string |
Agente |
|
Message
|
message | string |
Message |
|
|
Um nome de localidade BCP-47 para o conteúdo do campo de texto.
|
locale | string |
Um nome de localidade BCP-47 para o conteúdo do campo de texto. |
|
|
tipo de conteúdo
|
contentType | string | ||
|
contentUrl
|
contentUrl | string | ||
|
conteúdo
|
content | object | ||
|
nome
|
name | string | ||
|
URL da miniatura
|
thumbnailUrl | string | ||
|
ID da conversa
|
x-ms-conversation-id | string |
Forneça a ID da conversa de exisiting para retomar a execução do Agente. |
|
|
ID do Ambiente
|
environmentId | string |
ID do ambiente opcional |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
lastResponse
|
lastResponse | string |
A última resposta de texto na lista de atividades |
|
respostas
|
responses | array of string |
A lista de respostas de cadeia de caracteres na lista de atividades |
|
conversationId
|
conversationId | string |
A ID da conversa associada à resposta |
Obter conjuntos de teste do agente
Obtém os conjuntos de teste para um Agente.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Agente
|
Agent | True | string |
selecione um agente na lista suspensa ou insira um valor personalizado (a ID do agente). |
Retornos
- Corpo
- TestSetsResponse
Obter detalhes da execução de teste do agente
Obtém os detalhes de uma execução de teste de avaliação específica do criador.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Agente
|
Agent | True | string |
selecione um agente na lista suspensa ou insira um valor personalizado (a ID do agente). |
|
Execução de avaliação
|
EvaluationRunId | True | string |
Selecione a execução de avaliação na lista suspensa ou insira um valor personalizado (a ID da execução de avaliação). |
Retornos
- Corpo
- TestRun
Obter detalhes do conjunto de testes do agente
Obtém os detalhes de um conjunto de testes de avaliação do criador específico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Agente
|
Agent | True | string |
selecione um agente na lista suspensa ou insira um valor personalizado (a ID do agente). |
|
Conjunto de testes
|
TestSetId | True | string |
Selecione um conjunto de testes na lista suspensa ou insira um valor personalizado (a ID do conjunto de testes). |
Retornos
- Corpo
- TestSet
Obter execuções de teste do agente
Obtém as execuções de teste de avaliação do criador para o Agente especificado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Agente
|
Agent | True | string |
selecione um agente na lista suspensa ou insira um valor personalizado (a ID do agente). |
Retornos
- Corpo
- TestRunsResponse
Definições
TestSetsResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of TestSet |
TestSet
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | string | |
|
nome de exibição
|
displayName | string | |
|
totalTestCases
|
totalTestCases | integer | |
|
descrição
|
description | string | |
|
Auditinfo
|
auditInfo | AuditInfo | |
|
estado
|
state | string |
Auditinfo
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
createdBy
|
createdBy | string | |
|
createdTimeUtc
|
createdTimeUtc | date-time | |
|
modifiedBy
|
modifiedBy | string | |
|
modifiedTimeUtc
|
modifiedTimeUtc | date-time |
TestRunsResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
value
|
value | array of TestRun |
Testrun
| Nome | Caminho | 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 | |
|
nome
|
name | string | |
|
totalTestCases
|
totalTestCases | integer | |
|
msConnectionId
|
msConnectionId | string |