Microsoft Security Copilot (Pré-visualização)
Um assistente generativo alimentado por IA para operações diárias em segurança e TI. O conteúdo gerado por IA pode estar incorreto. Verifique a sua precisão.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Standard | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Standard | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Standard | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Microsoft |
| URL | https://learn.microsoft.com/en-us/connectors/securitycopilot/ |
| Metadados do conector | |
|---|---|
| Editora | Microsoft |
| Sítio Web | https://learn.microsoft.com/en-us/connectors/securitycopilot/ |
| Política de Privacidade | https://learn.microsoft.com/en-us/copilot/security/privacy-data-security |
| Categorias | Segurança |
| Contato | securitycopilot@microsoft.com |
Microsoft Security Copilot
Pré-requisitos
Para aproveitar ao máximo esse novo conector do Logic App, há alguns pré-requisitos a serem observados
Requisitos de implantação do locatário: Seu Aplicativo Lógico deve ser implantado em um locatário que esteja participando ativamente do Programa de Acesso Antecipado do Security Copilot
Autenticação de usuário e acesso à função: os usuários que desejam se autenticar com o conector do Aplicativo Lógico devem ter funções de acesso específicas. Para uma compreensão mais profunda dessas funções e como elas funcionam dentro da estrutura do Security Copilot, recomendamos explorar Compreender a autenticação no Microsoft Security Copilot | Microsoft Learn [en]
Acesso a dados para interação de segurança aprimorada: é importante que o usuário autenticado possa acessar dados de vários produtos de segurança remotos. Isso engloba tarefas como ler relatórios de incidentes do Defender e coletar detalhes de autenticação multifator (MFA), entre outros.
Para obter acesso ao Programa de Acesso Antecipado do Microsoft Security Copilot, consulte a seguinte documentação de integração
Authentication
O conector do Microsoft Security Copilot pode operar em nome de uma identidade de usuário Entra (AAD) que tenha as permissões necessárias para chamar o Security Copilot.
Recursos disponíveis
Conector Copilot de Segurança
Azure Logic Apps
- Cenários, exemplos e instruções passo a passo para Aplicativos Lógicos do Azure
- Expressões de aplicativos lógicos
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Oauth | Fornecer credenciais do Microsoft Entra ID | Todas as regiões | Não compartilhável |
| Autenticação do principal de serviço | Use seu próprio aplicativo Microsoft Entra ID para autenticação da entidade de serviço. | apenas | Não compartilhável |
| Padrão [DEPRECATED] | Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores. | Todas as regiões | Não compartilhável |
Oauth
ID de autenticação: Oauth
Aplicável: Todas as regiões
Fornecer credenciais do Microsoft Entra ID
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
Autenticação do Service Principal
ID de autenticação: OauthServicePrincipal
Aplicável: apenas
Use seu próprio aplicativo Microsoft Entra ID para autenticação da entidade de serviço.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| ID do Cliente | cadeia (de caracteres) | Verdade | |
| Segredo do Cliente | securestring | Verdade | |
| Tenant | cadeia (de caracteres) | Verdade |
Padrão [DEPRECATED]
Aplicável: Todas as regiões
Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 600 | 60 segundos |
Ações
| Buscar promptbookprompt status de avaliação |
Buscar promptbookprompt status de avaliação |
| Buscar status do prompt |
Obter o estado da avaliação |
| Enviar um prompt do Security Copilot |
Envie uma pergunta ou tarefa de segurança para o Security Copilot e obtenha uma resposta. O conteúdo gerado por IA pode conter erros. Verifique a precisão das respostas. |
| Executar um Agente Security Copilot |
Ativar agentes previamente configurados no Security Copilot para automatizar tarefas de segurança num calendário. O conteúdo gerado por IA pode estar incorreto. Verifique a sua precisão. |
| Submeter um Security pedido ao Copilot(V2) (Pré-visualização) |
Submeta uma pergunta ou tarefa de segurança ao Security Copilot e receba uma resposta com a melhoria da execução das competências do agente. O conteúdo gerado por IA pode conter erros. Verifique a precisão das respostas. |
Buscar promptbookprompt status de avaliação
Buscar promptbookprompt status de avaliação
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da Sessão
|
sessionId | True | string |
Id da sessão em que a avaliação foi realizada |
|
Prompt Id
|
promptId | True | string |
Id do prompt avaliado |
Devoluções
Objeto de resultado de execução do promptbook
- Body
- PromptbookRunResult
Buscar status do prompt
Obter o estado da avaliação
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID da avaliação
|
evaluationId | True | string |
Id da avaliação que está sendo buscada |
|
ID da Sessão
|
sessionId | True | string |
Id da sessão em que a avaliação foi realizada |
|
Prompt Id
|
promptId | True | string |
Id do prompt avaliado |
Devoluções
Objeto do resultado da avaliação
- Body
- EvaluationResult
Enviar um prompt do Security Copilot
Envie uma pergunta ou tarefa de segurança para o Security Copilot e obtenha uma resposta. O conteúdo gerado por IA pode conter erros. Verifique a precisão das respostas.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Avisar conteúdo
|
PromptContent | True | string |
Prompt para ser avaliado pelo copiloto de segurança |
|
Id da Sessão
|
SessionId | string |
O ID de uma sessão Copilot existente |
|
|
Plugins
|
Skillsets | array of string |
Plugins a ativar para esta sessão Copilot |
|
|
Nome da Habilidade Direta
|
SkillName | string |
Habilidade para invocar |
|
|
Entradas diretas de habilidades
|
SkillInputs | object |
Competências necessárias |
Devoluções
Objeto do resultado da avaliação
- Body
- EvaluationResult
Executar um Agente Security Copilot
Ativar agentes previamente configurados no Security Copilot para automatizar tarefas de segurança num calendário. O conteúdo gerado por IA pode estar incorreto. Verifique a sua precisão.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome do Agente
|
agentId | True | string |
Selecione o agente que quer executar |
|
Nome do gatilho
|
triggerName | True | string |
Selecione o gatilho a executar |
|
Especifique as entradas do agente como carga útil json.
|
agentInputs | dynamic |
Entradas para execução do agente |
Devoluções
- Body
- ExecutionDetail
Submeter um Security pedido ao Copilot(V2) (Pré-visualização)
Submeta uma pergunta ou tarefa de segurança ao Security Copilot e receba uma resposta com a melhoria da execução das competências do agente. O conteúdo gerado por IA pode conter erros. Verifique a precisão das respostas.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Avisar conteúdo
|
PromptContent | True | string |
Prompt para ser avaliado pelo copiloto de segurança |
|
Id da Sessão
|
SessionId | string |
O ID de uma sessão Copilot existente |
|
|
Plugins
|
Skillsets | array of string |
Plugins a ativar para esta sessão Copilot |
|
|
Nome da Habilidade Direta
|
SkillName | string |
Habilidade para invocar |
|
|
Entradas diretas de habilidades
|
SkillInputs | object |
Competências necessárias |
Devoluções
Objeto do resultado da avaliação
- Body
- EvaluationResult
Definições
AvaliaçãoResultado
Objeto do resultado da avaliação
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID de sessão
|
sessionId | string | |
|
promptId
|
promptId | string | |
|
evaluationId
|
evaluationId | string | |
|
skillName
|
skillName | string | |
|
promptContent
|
promptContent | string | |
|
Estado de avaliação
|
evaluationState | string | |
|
evaluationResultType
|
evaluationResultType | string | |
|
AvaliaçãoResultadoConteúdo
|
EvaluationResultContent | string | |
|
próximoPromptSugestões
|
nextPromptSuggestions | array of string |
PromptbookPromptEvaluationResult
Objeto de resultado da avaliação do prompt do promptbook
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
skillName
|
skillName | string | |
|
promptContent
|
promptContent | string | |
|
evaluationResultType
|
evaluationResultType | string | |
|
AvaliaçãoResultadoConteúdo
|
EvaluationResultContent | string |
PromptbookRunResult
Objeto de resultado de execução do promptbook
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
ID de sessão
|
sessionId | string | |
|
promptbookState
|
promptbookState | string | |
|
avaliaçãoResultados da avaliação
|
evaluationResults | array of PromptbookPromptEvaluationResult |
ExecuçãoDetalhe
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
estado
|
status | ExecutionStatus | |
|
numRuns
|
numRuns | integer | |
|
runIds
|
runIds | array of uuid | |
|
fetchSkillInputs
|
fetchSkillInputs | object | |
|
processSkillInputs
|
processSkillInputs | object | |
|
ID de execução
|
executionId | uuid | |
|
identityId
|
identityId | uuid | |
|
ID de sessão
|
sessionId | string | |
|
promptId
|
promptId | string | |
|
evaluationId
|
evaluationId | string | |
|
fetchSkillsetName
|
fetchSkillsetName | string | |
|
fetchSkillName
|
fetchSkillName | string | |
|
ProcessoNomeCompetências
|
processSkillsetName | string | |
|
NomeCompetência do Processo
|
processSkillName | string | |
|
startTime
|
startTime | date-time | |
|
endTime
|
endTime | date-time | |
|
tipo de execução
|
executionType | ExecutionType | |
|
erro
|
error | ErrorDetailResponse |
Estado da execução
TipoDeExecução
ErroDetalheResposta
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
código
|
code | string | |
|
mensagem
|
message | string | |
|
destino
|
target | string | |
|
details
|
details | array of ErrorDetailResponse | |
|
innerError
|
innerError | MedeinaInnerError |
MedeinaInnerError
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
código
|
code | string | |
|
innererror
|
innererror | MedeinaInnerError | |
|
mensagem do utilizador
|
userMessage | string | |
|
evaluationId
|
evaluationId | string | |
|
promptId
|
promptId | string | |
|
ID de sessão
|
sessionId | string | |
|
retentável
|
retryable | boolean |