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.
Parametry ścieżki
agent_name
string
wymagane
The name of the agent.
Parametry zapytań
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
wymagane
The API version to use for this operation.
Parametry nagłówka
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.
Treść żądania
The request body.
Content-Type: */*
Odpowiedzi
The request has succeeded.
Nagłówki
x-agent-invocation-id
string
wymagane
Unique identifier for this invocation.
x-agent-session-id
string
wymagane
Session ID for this invocation. Returns the provided session ID or an auto-generated one if not provided in the request.
Treść
Content-Type: */*
Żądanie
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