Agent Invocations

Create an agent invocation

POST /agents/{agent_name}/endpoint/protocols/invocations

Creates an invocation for the specified agent version.

Path parameters

agent_name string required

The name of the agent.

Query parameters

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 required

The API version to use for this operation.

Header parameters

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.

Request Body

The request body.

Content-Type: */*

Responses

The request has succeeded.

Headers

x-agent-invocation-id string required

Unique identifier for this invocation.

x-agent-session-id string required

Session ID for this invocation. Returns the provided session ID or an auto-generated one if not provided in the request.

Body

Content-Type: */*