BetaAgentsOperations Class

Creates a new session for an agent endpoint. The endpoint resolves the backing agent version from version_indicator and enforces session ownership using the provided isolation key for session-mutating operations.

async create_session(agent_name: str, body: ~collections.abc.MutableMapping[str, ~typing.Any] | ~typing.IO[bytes] = <object object>, *, isolation_key: str, version_indicator: ~azure.ai.projects.models._models.VersionIndicator = <object object>, agent_session_id: str | None = None, **kwargs: ~typing.Any) -> AgentSessionResource

Parameters

Keyword-Only Parameters

Returns

Exceptions

Deletes a session synchronously. Returns 204 No Content when the session is deleted or does not exist.

async delete_session(agent_name: str, session_id: str, *, isolation_key: str, **kwargs: Any) -> None

Parameters

Keyword-Only Parameters

Returns

Exceptions

Delete a file or directory from the session sandbox. If recursive is false (default) and the target is a non-empty directory, the API returns 409 Conflict.

async delete_session_file(agent_name: str, agent_session_id: str, *, path: str, recursive: bool | None = None, **kwargs: Any) -> None

Parameters

Keyword-Only Parameters

Returns

Exceptions

Download a file from the session sandbox as a binary stream.

async download_session_file(agent_name: str, agent_session_id: str, *, path: str, **kwargs: Any) -> AsyncIterator[bytes]

Parameters

Keyword-Only Parameters

Returns

Exceptions

Retrieves a session by ID.

async get_session(agent_name: str, session_id: str, **kwargs: Any) -> AgentSessionResource

Parameters

Returns

Exceptions

List files and directories at a given path in the session sandbox. Returns only the immediate children of the specified directory (non-recursive).

async get_session_files(agent_name: str, agent_session_id: str, *, path: str, **kwargs: Any) -> SessionDirectoryListResponse

Parameters

Keyword-Only Parameters

Returns

Exceptions

Streams console logs (stdout / stderr) for a specific hosted agent session as a Server-Sent Events (SSE) stream.

Each SSE frame contains:

• event: always "log"

• data: a plain-text log line (currently JSON-formatted, but the schema is not contractual and may include additional keys or change format over time; clients should treat it as an opaque string)

Example SSE frames:

   event: log
   data: {"timestamp":"2026-03-10T09:33:17.121Z","stream":"stdout","message":"Starting FoundryCBAgent server on port 8088"}

   event: log
   data: {"timestamp":"2026-03-10T09:33:17.130Z","stream":"stderr","message":"INFO: Application startup complete."}

   event: log
   data: {"timestamp":"2026-03-10T09:34:52.714Z","stream":"status","message":"Successfully connected to container"}

   event: log
   data: {"timestamp":"2026-03-10T09:35:52.714Z","stream":"status","message":"No logs since last 60 seconds"}

The stream remains open until the client disconnects or the server terminates the connection. Clients should handle reconnection as needed.

async get_session_log_stream(agent_name: str, agent_version: str, session_id: str, **kwargs: Any) -> SessionLogEvent

Parameters

Returns

Exceptions

Returns a list of sessions for the specified agent.

list_sessions(agent_name: str, *, limit: int | None = None, order: str | PageOrder | None = None, before: str | None = None, **kwargs: Any) -> AsyncItemPaged[AgentSessionResource]

Parameters

Keyword-Only Parameters

Returns

Exceptions

Updates an agent endpoint.

async patch_agent_details(agent_name: str, body: ~collections.abc.MutableMapping[str, ~typing.Any] | ~typing.IO[bytes] = <object object>, *, agent_endpoint: ~azure.ai.projects.models._models.AgentEndpoint | None = None, agent_card: ~azure.ai.projects.models._models.AgentCard | None = None, **kwargs: ~typing.Any) -> AgentDetails

Parameters

Keyword-Only Parameters

Returns

Exceptions

Upload a file to the session sandbox.

Accepts either a bytes buffer or a local file path (str). When a file path is provided the file is read from disk and its contents are forwarded to the service. Maximum file size is 50 MB. Uploads exceeding this limit return 413 Payload Too Large.

async upload_session_file(agent_name: str, session_id: str, content_or_file_path: bytes | str, *, path: str, **kwargs: Any) -> SessionFileWriteResponse

Parameters

Keyword-Only Parameters

Returns

Exceptions