microsoft-foundry.rest.security.o-auth2-auth
Agent Invocations
Create an agent invocation
POST
/agents/{agent_name}/endpoint/protocols/invocations
Creates an invocation for the specified agent version.
Parametri del percorso
agent_name
string
necessario
The name of the agent.
Parametri di query
agent_session_id
string
Optional session ID returned by the session CRUD APIs to reuse an existing sandbox. If not provided, a new session ID will be auto-generated.
api-version
string
necessario
The API version to use for this operation.
Parametri di intestazione
x-ms-user-identity
string
Opaque per-user identity string used to scope endpoint-scoped data to a specific end user. The caller must have the agents/endpoints/UserIdentityImpersonation/action RBAC permission.
Corpo della richiesta
The request body.
Content-Type: */*
Risposte
The request has succeeded.
Intestazioni
x-agent-invocation-id
string
necessario
Unique identifier for this invocation.
x-agent-session-id
string
necessario
Session ID for this invocation. Returns the provided session ID or an auto-generated one if not provided in the request.
Corpo
Content-Type: */*
Richiedi
POST /agents/{agent_name}/endpoint/protocols/invocations HTTP/1.1Response
Status: 200
Content-Type: */*Status: 4XX
Content-Type: application/jsonStatus: 5XX
Content-Type: application/json