Namespace: microsoft.graph.security.securityCopilot
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Crie um novo prompt em uma sessão do Security Copilot.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global |
Governo dos EUA L4 |
US Government L5 (DOD) |
China operada pela 21Vianet |
| ✅ |
❌ |
❌ |
❌ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão |
Permissões menos privilegiadas |
Permissões com privilégios mais elevados |
| Delegado (conta corporativa ou de estudante) |
SecurityCopilotWorkspaces.ReadWrite.All |
Indisponível. |
| Delegado (conta pessoal da Microsoft) |
Sem suporte. |
Sem suporte. |
| Application |
SecurityCopilotWorkspaces.ReadWrite.All |
Indisponível. |
Importante
Para acesso delegado usando contas corporativas ou de estudante, o usuário conectado deve receber uma função do Microsoft Security Copilot com suporte.
O Colaborador do Security Copilot é a função com menos privilégios com suporte para esta operação.
Solicitação HTTP
POST /security/securityCopilot/workspaces/{workspaceId}/sessions/{sessionId}/prompts
| Nome |
Descrição |
| Autorização |
{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type |
application/json. Obrigatório. |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON do objeto microsoft.graph.security.securityCopilot.prompt .
Você pode especificar as propriedades a seguir ao criar um prompt.
| Propriedade |
Tipo |
Descrição |
| type |
microsoft.graph.security.securityCopilot.promptType |
O tipo de prompts de entrada. Os valores possíveis são: unknown, context, prompt, skill, feedback, unknownFutureValue.
Apenas prompt tem suporte no momento. |
| conteúdo |
Cadeia de caracteres |
Texto de entrada quando usado com tipo prompt para avaliação. Necessário para avaliação de IA. |
Resposta
Se for bem-sucedido, esse método retornará um código de 201 Created resposta e um objeto microsoft.graph.security.securityCopilot.prompt no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/beta/security/securityCopilot/workspaces/default/sessions/ecdfb9b3-58f5-457f-a18c-4a477890b252/prompts
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.security.securityCopilot.prompt",
"type": "prompt",
"content": "who am I",
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models.Security.SecurityCopilot;
var requestBody = new Prompt
{
OdataType = "#microsoft.graph.security.securityCopilot.prompt",
Type = PromptType.Prompt,
Content = "who am I",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Security.SecurityCopilot.Workspaces["{workspace-id}"].Sessions["{session-id}"].Prompts.PostAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphmodelssecuritysecuritycopilot "github.com/microsoftgraph/msgraph-beta-sdk-go/models/security/securitycopilot"
//other-imports
)
requestBody := graphmodelssecuritysecuritycopilot.NewPrompt()
type := graphmodels.PROMPT_PROMPTTYPE
requestBody.SetType(&type)
content := "who am I"
requestBody.SetContent(&content)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
prompts, err := graphClient.Security().SecurityCopilot().Workspaces().ByWorkspaceId("workspace-id").Sessions().BySessionId("session-id").Prompts().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.beta.models.security.securitycopilot.Prompt prompt = new com.microsoft.graph.beta.models.security.securitycopilot.Prompt();
prompt.setOdataType("#microsoft.graph.security.securityCopilot.prompt");
prompt.setType(com.microsoft.graph.beta.models.security.securitycopilot.PromptType.Prompt);
prompt.setContent("who am I");
com.microsoft.graph.models.security.securitycopilot.Prompt result = graphClient.security().securityCopilot().workspaces().byWorkspaceId("{workspace-id}").sessions().bySessionId("{session-id}").prompts().post(prompt);
const options = {
authProvider,
};
const client = Client.init(options);
const prompt = {
'@odata.type': '#microsoft.graph.security.securityCopilot.prompt',
type: 'prompt',
content: 'who am I',
};
await client.api('/security/securityCopilot/workspaces/default/sessions/ecdfb9b3-58f5-457f-a18c-4a477890b252/prompts')
.version('beta')
.post(prompt);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\Security\SecurityCopilot\Prompt;
use Microsoft\Graph\Beta\Generated\Models\Security\SecurityCopilot\PromptType;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new Prompt();
$requestBody->setOdataType('#microsoft.graph.security.securityCopilot.prompt');
$requestBody->setType(new PromptType('prompt'));
$requestBody->setContent('who am I');
$result = $graphServiceClient->security()->securityCopilot()->workspaces()->byWorkspaceId('workspace-id')->sessions()->bySessionId('session-id')->prompts()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Security
$params = @{
"@odata.type" = "#microsoft.graph.security.securityCopilot.prompt"
type = "prompt"
content = "who am I"
}
New-MgBetaSecurityCopilotWorkspaceSessionPrompt -WorkspaceId $workspaceId -SessionId $sessionId -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.security.security_copilot.prompt import Prompt
from msgraph_beta.generated.models.prompt_type import PromptType
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = Prompt(
odata_type = "#microsoft.graph.security.securityCopilot.prompt",
type = PromptType.Prompt,
content = "who am I",
)
result = await graph_client.security.security_copilot.workspaces.by_workspace_id('workspace-id').sessions.by_session_id('session-id').prompts.post(request_body)
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#security/securityCopilot/workspaces('default')/sessions('ecdfb9b3-58f5-457f-a18c-4a477890b252')/prompts/$entity",
"id": "76a9b8c6-6656-4ef4-a4c7-7ed07fb93e01",
"type": "prompt",
"createdDateTime": "2025-10-22T20:12:13.759634Z",
"lastModifiedDateTime": "2025-10-22T20:12:13.759634Z",
"skillName": null,
"content": "who am I",
"inputs": {
"keyValuePairs": []
},
"skillInputDescriptors": []
}