Skip to content

generativeaiagentruntime.oracle.com/v1beta1

Back to API Reference

APIVersion: generativeaiagentruntime.oracle.com/v1beta1

This content is generated from the checked-in CRD schemas in config/crd/bases/. If a description is missing or incorrect, fix the source comments or generator inputs and rerun make generate manifests; do not hand-edit config/crd/bases/*.yaml.

Packages

No customer-visible package currently exposes generativeaiagentruntime.oracle.com/v1beta1.

Resources

Kind Scope Sample Packages
Session Namespaced Sample -

Session

Manage OCI Generative AI Agent Runtime sessions.

  • Plural: sessions
  • Scope: Namespaced
  • APIVersion: generativeaiagentruntime.oracle.com/v1beta1
  • Sample: Sample (config/samples/generativeaiagentruntime_v1beta1_session.yaml)
  • Packages: Not currently exposed by a customer-visible package.

Spec

SessionSpec defines the desired state of Session.

Field Description Type Required Default Enum
agentEndpointId The OCID of the agent endpoint that scopes this session. Required for create, reread, update, and delete requests. string Yes - -
description An optional description of the session. string No - -
displayName The name of the session. A session names doesn't have to be unique and you can change the session name later. string No - -

Status

SessionStatus defines the observed state of Session.

Field Description Type Required Default Enum
agentEndpointId The bound agent endpoint ID used to address this session. string No - -
description A description of the session. string No - -
displayName A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. string No - -
id A unique ID for the session. This ID is immutable on creation. string No - -
sessionId The bound session identifier used together with agentEndpointId for reread, update, and delete requests. string No - -
status - object Yes - -
timeCreated The date and time that the session started in the format of an RFC3339 datetime string. string No - -
timeUpdated The date and time that the session was last updated in the format of an RFC3339 datetime string. string No - -
welcomeMessage A greeting message that the you receive when you start of a session. string No - -

Status.status

Back to Session status

Field Description Type Required Default Enum
async Async is the canonical controller-owned async contract. Resource-local legacy work-request fields may remain as compatibility mirrors while follow-on migrations land, but new async state should project here first. object No - -
conditions - list[object] No - -
createdAt - string (date-time) No - -
deletedAt - string (date-time) No - -
message - string No - -
ocid - string No - -
opcRequestId OpcRequestID is the latest non-empty OCI request ID from a mutating OCI response or surfaced OCI service error that materially contributed to the current shared status projection. Headerless follow-up observations keep the last non-empty value intact. string No - -
reason - string No - -
requestedAt - string (date-time) No - -
updatedAt - string (date-time) No - -

Status.status.async

Back to Session status

Async is the canonical controller-owned async contract. Resource-local legacy work-request fields may remain as compatibility mirrors while follow-on migrations land, but new async state should project here first.

Field Description Type Required Default Enum
current - object No - -

Status.status.async.current

Back to Session status

Field Description Type Required Default Enum
message - string No - -
normalizedClass - string Yes - attention, canceled, failed, pending, succeeded, unknown
percentComplete - number No - -
phase - string Yes - create, delete, update
rawOperationType - string No - -
rawStatus - string No - -
source - string Yes - lifecycle, none, workrequest
updatedAt - string (date-time) Yes - -
workRequestId - string No - -

Status.status.conditions[]

Back to Session status

Field Description Type Required Default Enum
lastTransitionTime - string (date-time) No - -
message - string No - -
reason - string No - -
status - string Yes - -
type - string Yes - -