...

Package generativeaiagentruntime

import "github.com/oracle/oci-go-sdk/generativeaiagentruntime"
Overview
Index

Overview ▾

Index ▾

func GetMessageRoleEnumStringValues() []string
func GetSourceLocationSourceLocationTypeEnumStringValues() []string
func GetTraceTraceTypeEnumStringValues() []string
type ChatDetails
    func (m ChatDetails) String() string
    func (m ChatDetails) ValidateEnumValue() (bool, error)
type ChatRequest
    func (request ChatRequest) BinaryRequestBody() (*common.OCIReadSeekCloser, bool)
    func (request ChatRequest) HTTPRequest(method, path string, binaryRequestBody *common.OCIReadSeekCloser, extraHeaders map[string]string) (http.Request, error)
    func (request ChatRequest) RetryPolicy() *common.RetryPolicy
    func (request ChatRequest) String() string
    func (request ChatRequest) ValidateEnumValue() (bool, error)
type ChatResponse
    func (response ChatResponse) HTTPResponse() *http.Response
    func (response ChatResponse) String() string
type ChatResult
    func (m ChatResult) String() string
    func (m *ChatResult) UnmarshalJSON(data []byte) (e error)
    func (m ChatResult) ValidateEnumValue() (bool, error)
type Citation
    func (m Citation) String() string
    func (m *Citation) UnmarshalJSON(data []byte) (e error)
    func (m Citation) ValidateEnumValue() (bool, error)
type CreateSessionDetails
    func (m CreateSessionDetails) String() string
    func (m CreateSessionDetails) ValidateEnumValue() (bool, error)
type CreateSessionRequest
    func (request CreateSessionRequest) BinaryRequestBody() (*common.OCIReadSeekCloser, bool)
    func (request CreateSessionRequest) HTTPRequest(method, path string, binaryRequestBody *common.OCIReadSeekCloser, extraHeaders map[string]string) (http.Request, error)
    func (request CreateSessionRequest) RetryPolicy() *common.RetryPolicy
    func (request CreateSessionRequest) String() string
    func (request CreateSessionRequest) ValidateEnumValue() (bool, error)
type CreateSessionResponse
    func (response CreateSessionResponse) HTTPResponse() *http.Response
    func (response CreateSessionResponse) String() string
type DeleteSessionRequest
    func (request DeleteSessionRequest) BinaryRequestBody() (*common.OCIReadSeekCloser, bool)
    func (request DeleteSessionRequest) HTTPRequest(method, path string, binaryRequestBody *common.OCIReadSeekCloser, extraHeaders map[string]string) (http.Request, error)
    func (request DeleteSessionRequest) RetryPolicy() *common.RetryPolicy
    func (request DeleteSessionRequest) String() string
    func (request DeleteSessionRequest) ValidateEnumValue() (bool, error)
type DeleteSessionResponse
    func (response DeleteSessionResponse) HTTPResponse() *http.Response
    func (response DeleteSessionResponse) String() string
type ErrorTrace
    func (m ErrorTrace) GetTimeCreated() *common.SDKTime
    func (m ErrorTrace) MarshalJSON() (buff []byte, e error)
    func (m ErrorTrace) String() string
    func (m ErrorTrace) ValidateEnumValue() (bool, error)
type GenerationTrace
    func (m GenerationTrace) GetTimeCreated() *common.SDKTime
    func (m GenerationTrace) MarshalJSON() (buff []byte, e error)
    func (m GenerationTrace) String() string
    func (m GenerationTrace) ValidateEnumValue() (bool, error)
type GenerativeAiAgentRuntimeClient
    func NewGenerativeAiAgentRuntimeClientWithConfigurationProvider(configProvider common.ConfigurationProvider) (client GenerativeAiAgentRuntimeClient, err error)
    func NewGenerativeAiAgentRuntimeClientWithOboToken(configProvider common.ConfigurationProvider, oboToken string) (client GenerativeAiAgentRuntimeClient, err error)
    func (client GenerativeAiAgentRuntimeClient) Chat(ctx context.Context, request ChatRequest) (response ChatResponse, err error)
    func (client *GenerativeAiAgentRuntimeClient) ConfigurationProvider() *common.ConfigurationProvider
    func (client GenerativeAiAgentRuntimeClient) CreateSession(ctx context.Context, request CreateSessionRequest) (response CreateSessionResponse, err error)
    func (client GenerativeAiAgentRuntimeClient) DeleteSession(ctx context.Context, request DeleteSessionRequest) (response DeleteSessionResponse, err error)
    func (client GenerativeAiAgentRuntimeClient) GetSession(ctx context.Context, request GetSessionRequest) (response GetSessionResponse, err error)
    func (client *GenerativeAiAgentRuntimeClient) SetRegion(region string)
    func (client GenerativeAiAgentRuntimeClient) UpdateSession(ctx context.Context, request UpdateSessionRequest) (response UpdateSessionResponse, err error)
type GetSessionRequest
    func (request GetSessionRequest) BinaryRequestBody() (*common.OCIReadSeekCloser, bool)
    func (request GetSessionRequest) HTTPRequest(method, path string, binaryRequestBody *common.OCIReadSeekCloser, extraHeaders map[string]string) (http.Request, error)
    func (request GetSessionRequest) RetryPolicy() *common.RetryPolicy
    func (request GetSessionRequest) String() string
    func (request GetSessionRequest) ValidateEnumValue() (bool, error)
type GetSessionResponse
    func (response GetSessionResponse) HTTPResponse() *http.Response
    func (response GetSessionResponse) String() string
type Message
    func (m Message) String() string
    func (m Message) ValidateEnumValue() (bool, error)
type MessageContent
    func (m MessageContent) String() string
    func (m MessageContent) ValidateEnumValue() (bool, error)
type MessageRoleEnum
    func GetMappingMessageRoleEnum(val string) (MessageRoleEnum, bool)
    func GetMessageRoleEnumValues() []MessageRoleEnum
type OciDatabaseSourceLocation
    func (m OciDatabaseSourceLocation) MarshalJSON() (buff []byte, e error)
    func (m OciDatabaseSourceLocation) String() string
    func (m OciDatabaseSourceLocation) ValidateEnumValue() (bool, error)
type OciObjectStorageSourceLocation
    func (m OciObjectStorageSourceLocation) MarshalJSON() (buff []byte, e error)
    func (m OciObjectStorageSourceLocation) String() string
    func (m OciObjectStorageSourceLocation) ValidateEnumValue() (bool, error)
type OciOpenSearchSourceLocation
    func (m OciOpenSearchSourceLocation) MarshalJSON() (buff []byte, e error)
    func (m OciOpenSearchSourceLocation) String() string
    func (m OciOpenSearchSourceLocation) ValidateEnumValue() (bool, error)
type RetrievalTrace
    func (m RetrievalTrace) GetTimeCreated() *common.SDKTime
    func (m RetrievalTrace) MarshalJSON() (buff []byte, e error)
    func (m RetrievalTrace) String() string
    func (m RetrievalTrace) ValidateEnumValue() (bool, error)
type Session
    func (m Session) String() string
    func (m Session) ValidateEnumValue() (bool, error)
type SourceLocation
type SourceLocationSourceLocationTypeEnum
    func GetMappingSourceLocationSourceLocationTypeEnum(val string) (SourceLocationSourceLocationTypeEnum, bool)
    func GetSourceLocationSourceLocationTypeEnumValues() []SourceLocationSourceLocationTypeEnum
type Trace
type TraceTraceTypeEnum
    func GetMappingTraceTraceTypeEnum(val string) (TraceTraceTypeEnum, bool)
    func GetTraceTraceTypeEnumValues() []TraceTraceTypeEnum
type UpdateSessionDetails
    func (m UpdateSessionDetails) String() string
    func (m UpdateSessionDetails) ValidateEnumValue() (bool, error)
type UpdateSessionRequest
    func (request UpdateSessionRequest) BinaryRequestBody() (*common.OCIReadSeekCloser, bool)
    func (request UpdateSessionRequest) HTTPRequest(method, path string, binaryRequestBody *common.OCIReadSeekCloser, extraHeaders map[string]string) (http.Request, error)
    func (request UpdateSessionRequest) RetryPolicy() *common.RetryPolicy
    func (request UpdateSessionRequest) String() string
    func (request UpdateSessionRequest) ValidateEnumValue() (bool, error)
type UpdateSessionResponse
    func (response UpdateSessionResponse) HTTPResponse() *http.Response
    func (response UpdateSessionResponse) String() string

Package files

chat_details.go chat_request_response.go chat_result.go citation.go create_session_details.go create_session_request_response.go delete_session_request_response.go error_trace.go generation_trace.go generativeaiagentruntime_client.go get_session_request_response.go message.go message_content.go oci_database_source_location.go oci_object_storage_source_location.go oci_open_search_source_location.go retrieval_trace.go session.go source_location.go trace.go update_session_details.go update_session_request_response.go

func GetMessageRoleEnumStringValues

func GetMessageRoleEnumStringValues() []string

GetMessageRoleEnumStringValues Enumerates the set of values in String for MessageRoleEnum

func GetSourceLocationSourceLocationTypeEnumStringValues

func GetSourceLocationSourceLocationTypeEnumStringValues() []string

GetSourceLocationSourceLocationTypeEnumStringValues Enumerates the set of values in String for SourceLocationSourceLocationTypeEnum

func GetTraceTraceTypeEnumStringValues

func GetTraceTraceTypeEnumStringValues() []string

GetTraceTraceTypeEnumStringValues Enumerates the set of values in String for TraceTraceTypeEnum

type ChatDetails

ChatDetails Chat details.

type ChatDetails struct {

    // The input user message content for the chat.
    UserMessage *string `mandatory:"true" json:"userMessage"`

    // Whether to stream the response.
    ShouldStream *bool `mandatory:"false" json:"shouldStream"`

    // Optional sessionId. If not provided, will chat without any prior context.
    SessionId *string `mandatory:"false" json:"sessionId"`
}

func (ChatDetails) String

func (m ChatDetails) String() string

func (ChatDetails) ValidateEnumValue

func (m ChatDetails) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type ChatRequest

ChatRequest wrapper for the Chat operation

See also

Click https://docs.cloud.oracle.com/en-us/iaas/tools/go-sdk-examples/65.75.0/generativeaiagentruntime/Chat.go.html to see an example of how to use ChatRequest.

type ChatRequest struct {

    // A unique ID for the endpoint.
    AgentEndpointId *string `mandatory:"true" contributesTo:"path" name:"agentEndpointId"`

    // Input for chat.
    ChatDetails `contributesTo:"body"`

    // The client request ID for tracing.
    OpcRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-request-id"`

    // For optimistic concurrency control. In the PUT or DELETE call
    // for a resource, set the `if-match` parameter to the value of the
    // etag from a previous GET or POST response for that resource.
    // The resource will be updated or deleted only if the etag you
    // provide matches the resource's current etag value.
    IfMatch *string `mandatory:"false" contributesTo:"header" name:"if-match"`

    // A token that uniquely identifies a request so it can be retried in case of a timeout or
    // server error without risk of executing that same action again. Retry tokens expire after 24
    // hours, but can be invalidated before then due to conflicting operations. For example, if a resource
    // has been deleted and purged from the system, then a retry of the original creation request
    // might be rejected.
    OpcRetryToken *string `mandatory:"false" contributesTo:"header" name:"opc-retry-token"`

    // Metadata about the request. This information will not be transmitted to the service, but
    // represents information that the SDK will consume to drive retry behavior.
    RequestMetadata common.RequestMetadata
}

func (ChatRequest) BinaryRequestBody

func (request ChatRequest) BinaryRequestBody() (*common.OCIReadSeekCloser, bool)

BinaryRequestBody implements the OCIRequest interface

func (ChatRequest) HTTPRequest

func (request ChatRequest) HTTPRequest(method, path string, binaryRequestBody *common.OCIReadSeekCloser, extraHeaders map[string]string) (http.Request, error)

HTTPRequest implements the OCIRequest interface

func (ChatRequest) RetryPolicy

func (request ChatRequest) RetryPolicy() *common.RetryPolicy

RetryPolicy implements the OCIRetryableRequest interface. This retrieves the specified retry policy.

func (ChatRequest) String

func (request ChatRequest) String() string

func (ChatRequest) ValidateEnumValue

func (request ChatRequest) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type ChatResponse

ChatResponse wrapper for the Chat operation

type ChatResponse struct {

    // The underlying http response
    RawResponse *http.Response

    // The ChatResult instance
    ChatResult `presentIn:"body"`

    // Unique Oracle-assigned identifier for the request. If you need to contact
    // Oracle about a particular request, please provide the request ID.
    OpcRequestId *string `presentIn:"header" name:"opc-request-id"`
}

func (ChatResponse) HTTPResponse

func (response ChatResponse) HTTPResponse() *http.Response

HTTPResponse implements the OCIResponse interface

func (ChatResponse) String

func (response ChatResponse) String() string

type ChatResult

ChatResult The response of a chat request.

type ChatResult struct {
    Message *Message `mandatory:"false" json:"message"`

    // The trace that displays the internal progression, such as reasoning and actions during an execution.
    Traces []Trace `mandatory:"false" json:"traces"`
}

func (ChatResult) String

func (m ChatResult) String() string

func (*ChatResult) UnmarshalJSON

func (m *ChatResult) UnmarshalJSON(data []byte) (e error)

UnmarshalJSON unmarshals from json

func (ChatResult) ValidateEnumValue

func (m ChatResult) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type Citation

Citation The citation displays the location of source text that is the agent uses to create the responses.

type Citation struct {

    // The text that's the source for the agent's response.
    SourceText *string `mandatory:"false" json:"sourceText"`

    SourceLocation SourceLocation `mandatory:"false" json:"sourceLocation"`
}

func (Citation) String

func (m Citation) String() string

func (*Citation) UnmarshalJSON

func (m *Citation) UnmarshalJSON(data []byte) (e error)

UnmarshalJSON unmarshals from json

func (Citation) ValidateEnumValue

func (m Citation) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type CreateSessionDetails

CreateSessionDetails Information about the new session.

type CreateSessionDetails struct {

    // The name of the session. A session names doesn't have to be unique and you can change the session name later.
    DisplayName *string `mandatory:"false" json:"displayName"`

    // An optional description of the session.
    Description *string `mandatory:"false" json:"description"`
}

func (CreateSessionDetails) String

func (m CreateSessionDetails) String() string

func (CreateSessionDetails) ValidateEnumValue

func (m CreateSessionDetails) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type CreateSessionRequest

CreateSessionRequest wrapper for the CreateSession operation

See also

Click https://docs.cloud.oracle.com/en-us/iaas/tools/go-sdk-examples/65.75.0/generativeaiagentruntime/CreateSession.go.html to see an example of how to use CreateSessionRequest.

type CreateSessionRequest struct {

    // Details for the new agent session.
    CreateSessionDetails `contributesTo:"body"`

    // A unique ID for the endpoint.
    AgentEndpointId *string `mandatory:"true" contributesTo:"path" name:"agentEndpointId"`

    // A token that uniquely identifies a request so it can be retried in case of a timeout or
    // server error without risk of executing that same action again. Retry tokens expire after 24
    // hours, but can be invalidated before then due to conflicting operations. For example, if a resource
    // has been deleted and purged from the system, then a retry of the original creation request
    // might be rejected.
    OpcRetryToken *string `mandatory:"false" contributesTo:"header" name:"opc-retry-token"`

    // The client request ID for tracing.
    OpcRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-request-id"`

    // Metadata about the request. This information will not be transmitted to the service, but
    // represents information that the SDK will consume to drive retry behavior.
    RequestMetadata common.RequestMetadata
}

func (CreateSessionRequest) BinaryRequestBody

func (request CreateSessionRequest) BinaryRequestBody() (*common.OCIReadSeekCloser, bool)

BinaryRequestBody implements the OCIRequest interface

func (CreateSessionRequest) HTTPRequest

func (request CreateSessionRequest) HTTPRequest(method, path string, binaryRequestBody *common.OCIReadSeekCloser, extraHeaders map[string]string) (http.Request, error)

HTTPRequest implements the OCIRequest interface

func (CreateSessionRequest) RetryPolicy

func (request CreateSessionRequest) RetryPolicy() *common.RetryPolicy

RetryPolicy implements the OCIRetryableRequest interface. This retrieves the specified retry policy.

func (CreateSessionRequest) String

func (request CreateSessionRequest) String() string

func (CreateSessionRequest) ValidateEnumValue

func (request CreateSessionRequest) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type CreateSessionResponse

CreateSessionResponse wrapper for the CreateSession operation

type CreateSessionResponse struct {

    // The underlying http response
    RawResponse *http.Response

    // The Session instance
    Session `presentIn:"body"`

    // For optimistic concurrency control. See `if-match`.
    Etag *string `presentIn:"header" name:"etag"`

    // Unique Oracle-assigned identifier for the request. If you need to contact
    // Oracle about a particular request, please provide the request ID.
    OpcRequestId *string `presentIn:"header" name:"opc-request-id"`
}

func (CreateSessionResponse) HTTPResponse

func (response CreateSessionResponse) HTTPResponse() *http.Response

HTTPResponse implements the OCIResponse interface

func (CreateSessionResponse) String

func (response CreateSessionResponse) String() string

type DeleteSessionRequest

DeleteSessionRequest wrapper for the DeleteSession operation

See also

Click https://docs.cloud.oracle.com/en-us/iaas/tools/go-sdk-examples/65.75.0/generativeaiagentruntime/DeleteSession.go.html to see an example of how to use DeleteSessionRequest.

type DeleteSessionRequest struct {

    // A unique ID for the endpoint.
    AgentEndpointId *string `mandatory:"true" contributesTo:"path" name:"agentEndpointId"`

    // A unique ID for the session.
    SessionId *string `mandatory:"true" contributesTo:"path" name:"sessionId"`

    // For optimistic concurrency control. In the PUT or DELETE call
    // for a resource, set the `if-match` parameter to the value of the
    // etag from a previous GET or POST response for that resource.
    // The resource will be updated or deleted only if the etag you
    // provide matches the resource's current etag value.
    IfMatch *string `mandatory:"false" contributesTo:"header" name:"if-match"`

    // The client request ID for tracing.
    OpcRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-request-id"`

    // Metadata about the request. This information will not be transmitted to the service, but
    // represents information that the SDK will consume to drive retry behavior.
    RequestMetadata common.RequestMetadata
}

func (DeleteSessionRequest) BinaryRequestBody

func (request DeleteSessionRequest) BinaryRequestBody() (*common.OCIReadSeekCloser, bool)

BinaryRequestBody implements the OCIRequest interface

func (DeleteSessionRequest) HTTPRequest

func (request DeleteSessionRequest) HTTPRequest(method, path string, binaryRequestBody *common.OCIReadSeekCloser, extraHeaders map[string]string) (http.Request, error)

HTTPRequest implements the OCIRequest interface

func (DeleteSessionRequest) RetryPolicy

func (request DeleteSessionRequest) RetryPolicy() *common.RetryPolicy

RetryPolicy implements the OCIRetryableRequest interface. This retrieves the specified retry policy.

func (DeleteSessionRequest) String

func (request DeleteSessionRequest) String() string

func (DeleteSessionRequest) ValidateEnumValue

func (request DeleteSessionRequest) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type DeleteSessionResponse

DeleteSessionResponse wrapper for the DeleteSession operation

type DeleteSessionResponse struct {

    // The underlying http response
    RawResponse *http.Response

    // Unique Oracle-assigned identifier for the request. If you need to contact
    // Oracle about a particular request, please provide the request ID.
    OpcRequestId *string `presentIn:"header" name:"opc-request-id"`
}

func (DeleteSessionResponse) HTTPResponse

func (response DeleteSessionResponse) HTTPResponse() *http.Response

HTTPResponse implements the OCIResponse interface

func (DeleteSessionResponse) String

func (response DeleteSessionResponse) String() string

type ErrorTrace

ErrorTrace The trace information about the error.

type ErrorTrace struct {

    // The date and time that the trace was created in the format of an RFC3339 datetime string.
    TimeCreated *common.SDKTime `mandatory:"false" json:"timeCreated"`

    // The error message in this trace.
    ErrorMessage *string `mandatory:"false" json:"errorMessage"`
}

func (ErrorTrace) GetTimeCreated

func (m ErrorTrace) GetTimeCreated() *common.SDKTime

GetTimeCreated returns TimeCreated

func (ErrorTrace) MarshalJSON

func (m ErrorTrace) MarshalJSON() (buff []byte, e error)

MarshalJSON marshals to json representation

func (ErrorTrace) String

func (m ErrorTrace) String() string

func (ErrorTrace) ValidateEnumValue

func (m ErrorTrace) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type GenerationTrace

GenerationTrace The trace information about the generated response.

type GenerationTrace struct {

    // The date and time that the trace was created in the format of an RFC3339 datetime string.
    TimeCreated *common.SDKTime `mandatory:"false" json:"timeCreated"`

    // The generated response that's returned to the user.
    Generation *string `mandatory:"false" json:"generation"`
}

func (GenerationTrace) GetTimeCreated

func (m GenerationTrace) GetTimeCreated() *common.SDKTime

GetTimeCreated returns TimeCreated

func (GenerationTrace) MarshalJSON

func (m GenerationTrace) MarshalJSON() (buff []byte, e error)

MarshalJSON marshals to json representation

func (GenerationTrace) String

func (m GenerationTrace) String() string

func (GenerationTrace) ValidateEnumValue

func (m GenerationTrace) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type GenerativeAiAgentRuntimeClient

GenerativeAiAgentRuntimeClient a client for GenerativeAiAgentRuntime

type GenerativeAiAgentRuntimeClient struct {
    common.BaseClient
    // contains filtered or unexported fields
}

func NewGenerativeAiAgentRuntimeClientWithConfigurationProvider

func NewGenerativeAiAgentRuntimeClientWithConfigurationProvider(configProvider common.ConfigurationProvider) (client GenerativeAiAgentRuntimeClient, err error)

NewGenerativeAiAgentRuntimeClientWithConfigurationProvider Creates a new default GenerativeAiAgentRuntime client with the given configuration provider. the configuration provider will be used for the default signer as well as reading the region

func NewGenerativeAiAgentRuntimeClientWithOboToken

func NewGenerativeAiAgentRuntimeClientWithOboToken(configProvider common.ConfigurationProvider, oboToken string) (client GenerativeAiAgentRuntimeClient, err error)

NewGenerativeAiAgentRuntimeClientWithOboToken Creates a new default GenerativeAiAgentRuntime client with the given configuration provider. The obotoken will be added to default headers and signed; the configuration provider will be used for the signer

as well as reading the region

func (GenerativeAiAgentRuntimeClient) Chat

func (client GenerativeAiAgentRuntimeClient) Chat(ctx context.Context, request ChatRequest) (response ChatResponse, err error)

Chat Chat on endpoint with provided messages.

See also

Click https://docs.cloud.oracle.com/en-us/iaas/tools/go-sdk-examples/65.75.0/generativeaiagentruntime/Chat.go.html to see an example of how to use Chat API. A default retry strategy applies to this operation Chat()

func (*GenerativeAiAgentRuntimeClient) ConfigurationProvider

func (client *GenerativeAiAgentRuntimeClient) ConfigurationProvider() *common.ConfigurationProvider

ConfigurationProvider the ConfigurationProvider used in this client, or null if none set

func (GenerativeAiAgentRuntimeClient) CreateSession

func (client GenerativeAiAgentRuntimeClient) CreateSession(ctx context.Context, request CreateSessionRequest) (response CreateSessionResponse, err error)

CreateSession A session represents an interactive conversation initiated by a user through an API to engage with an agent. It involves a series of exchanges where the user sends queries or prompts, and the agent responds with relevant information, actions, or assistance based on the user's input. The session persists for the duration of the interaction, maintaining context and continuity to provide coherent and meaningful responses throughout the conversation.Creates an agent session. Use this API to create an agent session.

See also

Click https://docs.cloud.oracle.com/en-us/iaas/tools/go-sdk-examples/65.75.0/generativeaiagentruntime/CreateSession.go.html to see an example of how to use CreateSession API. A default retry strategy applies to this operation CreateSession()

func (GenerativeAiAgentRuntimeClient) DeleteSession

func (client GenerativeAiAgentRuntimeClient) DeleteSession(ctx context.Context, request DeleteSessionRequest) (response DeleteSessionResponse, err error)

DeleteSession Delete a session and all its associated information.

See also

Click https://docs.cloud.oracle.com/en-us/iaas/tools/go-sdk-examples/65.75.0/generativeaiagentruntime/DeleteSession.go.html to see an example of how to use DeleteSession API. A default retry strategy applies to this operation DeleteSession()

func (GenerativeAiAgentRuntimeClient) GetSession

func (client GenerativeAiAgentRuntimeClient) GetSession(ctx context.Context, request GetSessionRequest) (response GetSessionResponse, err error)

GetSession Return the session resource identified by the session ID.

See also

Click https://docs.cloud.oracle.com/en-us/iaas/tools/go-sdk-examples/65.75.0/generativeaiagentruntime/GetSession.go.html to see an example of how to use GetSession API. A default retry strategy applies to this operation GetSession()

func (*GenerativeAiAgentRuntimeClient) SetRegion

func (client *GenerativeAiAgentRuntimeClient) SetRegion(region string)

SetRegion overrides the region of this client.

func (GenerativeAiAgentRuntimeClient) UpdateSession

func (client GenerativeAiAgentRuntimeClient) UpdateSession(ctx context.Context, request UpdateSessionRequest) (response UpdateSessionResponse, err error)

UpdateSession Update session metadata, including but not limited to description, tags.

See also

Click https://docs.cloud.oracle.com/en-us/iaas/tools/go-sdk-examples/65.75.0/generativeaiagentruntime/UpdateSession.go.html to see an example of how to use UpdateSession API. A default retry strategy applies to this operation UpdateSession()

type GetSessionRequest

GetSessionRequest wrapper for the GetSession operation

See also

Click https://docs.cloud.oracle.com/en-us/iaas/tools/go-sdk-examples/65.75.0/generativeaiagentruntime/GetSession.go.html to see an example of how to use GetSessionRequest.

type GetSessionRequest struct {

    // A unique ID for the endpoint.
    AgentEndpointId *string `mandatory:"true" contributesTo:"path" name:"agentEndpointId"`

    // A unique ID for the session.
    SessionId *string `mandatory:"true" contributesTo:"path" name:"sessionId"`

    // The client request ID for tracing.
    OpcRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-request-id"`

    // Metadata about the request. This information will not be transmitted to the service, but
    // represents information that the SDK will consume to drive retry behavior.
    RequestMetadata common.RequestMetadata
}

func (GetSessionRequest) BinaryRequestBody

func (request GetSessionRequest) BinaryRequestBody() (*common.OCIReadSeekCloser, bool)

BinaryRequestBody implements the OCIRequest interface

func (GetSessionRequest) HTTPRequest

func (request GetSessionRequest) HTTPRequest(method, path string, binaryRequestBody *common.OCIReadSeekCloser, extraHeaders map[string]string) (http.Request, error)

HTTPRequest implements the OCIRequest interface

func (GetSessionRequest) RetryPolicy

func (request GetSessionRequest) RetryPolicy() *common.RetryPolicy

RetryPolicy implements the OCIRetryableRequest interface. This retrieves the specified retry policy.

func (GetSessionRequest) String

func (request GetSessionRequest) String() string

func (GetSessionRequest) ValidateEnumValue

func (request GetSessionRequest) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type GetSessionResponse

GetSessionResponse wrapper for the GetSession operation

type GetSessionResponse struct {

    // The underlying http response
    RawResponse *http.Response

    // The Session instance
    Session `presentIn:"body"`

    // For optimistic concurrency control. See `if-match`.
    Etag *string `presentIn:"header" name:"etag"`

    // Unique Oracle-assigned identifier for the request. If you need to contact
    // Oracle about a particular request, please provide the request ID.
    OpcRequestId *string `presentIn:"header" name:"opc-request-id"`
}

func (GetSessionResponse) HTTPResponse

func (response GetSessionResponse) HTTPResponse() *http.Response

HTTPResponse implements the OCIResponse interface

func (GetSessionResponse) String

func (response GetSessionResponse) String() string

type Message

Message The Message resource generated by the agent.

type Message struct {

    // The role of the sender of this message.
    Role MessageRoleEnum `mandatory:"true" json:"role"`

    Content *MessageContent `mandatory:"true" json:"content"`

    // The date and time that the message was created in the format of an RFC3339 datetime string.
    TimeCreated *common.SDKTime `mandatory:"false" json:"timeCreated"`
}

func (Message) String

func (m Message) String() string

func (Message) ValidateEnumValue

func (m Message) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type MessageContent

MessageContent The content of the message.

type MessageContent struct {

    // The content of the message.
    Text *string `mandatory:"true" json:"text"`

    // Citations to data sources used for generating an agent's message.
    Citations []Citation `mandatory:"false" json:"citations"`
}

func (MessageContent) String

func (m MessageContent) String() string

func (MessageContent) ValidateEnumValue

func (m MessageContent) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type MessageRoleEnum

MessageRoleEnum Enum with underlying type: string

type MessageRoleEnum string

Set of constants representing the allowable values for MessageRoleEnum

const (
    MessageRoleUser  MessageRoleEnum = "USER"
    MessageRoleAgent MessageRoleEnum = "AGENT"
)

func GetMappingMessageRoleEnum

func GetMappingMessageRoleEnum(val string) (MessageRoleEnum, bool)

GetMappingMessageRoleEnum performs case Insensitive comparison on enum value and return the desired enum

func GetMessageRoleEnumValues

func GetMessageRoleEnumValues() []MessageRoleEnum

GetMessageRoleEnumValues Enumerates the set of values for MessageRoleEnum

type OciDatabaseSourceLocation

OciDatabaseSourceLocation The location of the OCI Database that the agent will use.

type OciDatabaseSourceLocation struct {

    // The OCID of the OCI Database Tools Connection (https://docs.cloud.oracle.com/iaas/database-tools/home.htm).
    Id *string `mandatory:"false" json:"id"`

    // The name of the function that returns source text.
    FunctionName *string `mandatory:"false" json:"functionName"`

    // The URL of the retrieved document, if available.
    Url *string `mandatory:"false" json:"url"`
}

func (OciDatabaseSourceLocation) MarshalJSON

func (m OciDatabaseSourceLocation) MarshalJSON() (buff []byte, e error)

MarshalJSON marshals to json representation

func (OciDatabaseSourceLocation) String

func (m OciDatabaseSourceLocation) String() string

func (OciDatabaseSourceLocation) ValidateEnumValue

func (m OciDatabaseSourceLocation) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type OciObjectStorageSourceLocation

OciObjectStorageSourceLocation The OCI Object Storage that contains the data files.

type OciObjectStorageSourceLocation struct {

    // The URL of the OCI Object Storage data source.
    Url *string `mandatory:"false" json:"url"`
}

func (OciObjectStorageSourceLocation) MarshalJSON

func (m OciObjectStorageSourceLocation) MarshalJSON() (buff []byte, e error)

MarshalJSON marshals to json representation

func (OciObjectStorageSourceLocation) String

func (m OciObjectStorageSourceLocation) String() string

func (OciObjectStorageSourceLocation) ValidateEnumValue

func (m OciObjectStorageSourceLocation) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type OciOpenSearchSourceLocation

OciOpenSearchSourceLocation The location of the OCI Search with OpenSearch that the agent will use.

type OciOpenSearchSourceLocation struct {

    // The OCID of the OCI OpenSearch cluster.
    Id *string `mandatory:"false" json:"id"`

    // The name of the index in OpenSearch that contains the source text.
    IndexName *string `mandatory:"false" json:"indexName"`

    // The URL of the retrieved document, if available.
    Url *string `mandatory:"false" json:"url"`
}

func (OciOpenSearchSourceLocation) MarshalJSON

func (m OciOpenSearchSourceLocation) MarshalJSON() (buff []byte, e error)

MarshalJSON marshals to json representation

func (OciOpenSearchSourceLocation) String

func (m OciOpenSearchSourceLocation) String() string

func (OciOpenSearchSourceLocation) ValidateEnumValue

func (m OciOpenSearchSourceLocation) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type RetrievalTrace

RetrievalTrace The trace that displays the retrieval information.

type RetrievalTrace struct {

    // The date and time that the trace was created in the format of an RFC3339 datetime string.
    TimeCreated *common.SDKTime `mandatory:"false" json:"timeCreated"`

    // The agent's search string for getting the displayed information.
    RetrievalInput *string `mandatory:"false" json:"retrievalInput"`

    // A list of citations retrieved from data sources.
    Citations []Citation `mandatory:"false" json:"citations"`
}

func (RetrievalTrace) GetTimeCreated

func (m RetrievalTrace) GetTimeCreated() *common.SDKTime

GetTimeCreated returns TimeCreated

func (RetrievalTrace) MarshalJSON

func (m RetrievalTrace) MarshalJSON() (buff []byte, e error)

MarshalJSON marshals to json representation

func (RetrievalTrace) String

func (m RetrievalTrace) String() string

func (RetrievalTrace) ValidateEnumValue

func (m RetrievalTrace) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type Session

Session A session represents an interactive conversation initiated by a user through an API to engage with an agent. It involves a series of exchanges where the user sends queries or prompts, and the agent responds with relevant information, actions, or assistance based on the user's input. The session persists for the duration of the interaction, maintaining context and continuity to provide coherent and meaningful responses throughout the conversation.

type Session struct {

    // A unique ID for the session. This ID is immutable on creation.
    Id *string `mandatory:"true" json:"id"`

    // The date and time that the session started in the format of an RFC3339 datetime string.
    TimeCreated *common.SDKTime `mandatory:"true" json:"timeCreated"`

    // A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    DisplayName *string `mandatory:"false" json:"displayName"`

    // A description of the session.
    Description *string `mandatory:"false" json:"description"`

    // A greeting message that the you receive when you start of a session.
    WelcomeMessage *string `mandatory:"false" json:"welcomeMessage"`

    // The date and time that the session was last updated in the format of an RFC3339 datetime string.
    TimeUpdated *common.SDKTime `mandatory:"false" json:"timeUpdated"`
}

func (Session) String

func (m Session) String() string

func (Session) ValidateEnumValue

func (m Session) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type SourceLocation

SourceLocation The location of the data files that the agent will use.

type SourceLocation interface {
}

type SourceLocationSourceLocationTypeEnum

SourceLocationSourceLocationTypeEnum Enum with underlying type: string

type SourceLocationSourceLocationTypeEnum string

Set of constants representing the allowable values for SourceLocationSourceLocationTypeEnum

const (
    SourceLocationSourceLocationTypeObjectStorage SourceLocationSourceLocationTypeEnum = "OCI_OBJECT_STORAGE"
    SourceLocationSourceLocationTypeOpenSearch    SourceLocationSourceLocationTypeEnum = "OCI_OPEN_SEARCH"
    SourceLocationSourceLocationTypeDatabase      SourceLocationSourceLocationTypeEnum = "OCI_DATABASE"
)

func GetMappingSourceLocationSourceLocationTypeEnum

func GetMappingSourceLocationSourceLocationTypeEnum(val string) (SourceLocationSourceLocationTypeEnum, bool)

GetMappingSourceLocationSourceLocationTypeEnum performs case Insensitive comparison on enum value and return the desired enum

func GetSourceLocationSourceLocationTypeEnumValues

func GetSourceLocationSourceLocationTypeEnumValues() []SourceLocationSourceLocationTypeEnum

GetSourceLocationSourceLocationTypeEnumValues Enumerates the set of values for SourceLocationSourceLocationTypeEnum

type Trace

Trace The trace that displays the internal progression, such as reasoning and actions during an execution.

type Trace interface {

    // The date and time that the trace was created in the format of an RFC3339 datetime string.
    GetTimeCreated() *common.SDKTime
}

type TraceTraceTypeEnum

TraceTraceTypeEnum Enum with underlying type: string

type TraceTraceTypeEnum string

Set of constants representing the allowable values for TraceTraceTypeEnum

const (
    TraceTraceTypeErrorTrace      TraceTraceTypeEnum = "ERROR_TRACE"
    TraceTraceTypeRetrievalTrace  TraceTraceTypeEnum = "RETRIEVAL_TRACE"
    TraceTraceTypeGenerationTrace TraceTraceTypeEnum = "GENERATION_TRACE"
)

func GetMappingTraceTraceTypeEnum

func GetMappingTraceTraceTypeEnum(val string) (TraceTraceTypeEnum, bool)

GetMappingTraceTraceTypeEnum performs case Insensitive comparison on enum value and return the desired enum

func GetTraceTraceTypeEnumValues

func GetTraceTraceTypeEnumValues() []TraceTraceTypeEnum

GetTraceTraceTypeEnumValues Enumerates the set of values for TraceTraceTypeEnum

type UpdateSessionDetails

UpdateSessionDetails Information about the updated session.

type UpdateSessionDetails struct {

    // The name of the session. A session names doesn't have to be unique and you can change the session name later.
    DisplayName *string `mandatory:"false" json:"displayName"`

    // A description of the session.
    Description *string `mandatory:"false" json:"description"`
}

func (UpdateSessionDetails) String

func (m UpdateSessionDetails) String() string

func (UpdateSessionDetails) ValidateEnumValue

func (m UpdateSessionDetails) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type UpdateSessionRequest

UpdateSessionRequest wrapper for the UpdateSession operation

See also

Click https://docs.cloud.oracle.com/en-us/iaas/tools/go-sdk-examples/65.75.0/generativeaiagentruntime/UpdateSession.go.html to see an example of how to use UpdateSessionRequest.

type UpdateSessionRequest struct {

    // A unique ID for the endpoint.
    AgentEndpointId *string `mandatory:"true" contributesTo:"path" name:"agentEndpointId"`

    // A unique ID for the session.
    SessionId *string `mandatory:"true" contributesTo:"path" name:"sessionId"`

    // Details to update an agent session.
    UpdateSessionDetails `contributesTo:"body"`

    // For optimistic concurrency control. In the PUT or DELETE call
    // for a resource, set the `if-match` parameter to the value of the
    // etag from a previous GET or POST response for that resource.
    // The resource will be updated or deleted only if the etag you
    // provide matches the resource's current etag value.
    IfMatch *string `mandatory:"false" contributesTo:"header" name:"if-match"`

    // The client request ID for tracing.
    OpcRequestId *string `mandatory:"false" contributesTo:"header" name:"opc-request-id"`

    // Metadata about the request. This information will not be transmitted to the service, but
    // represents information that the SDK will consume to drive retry behavior.
    RequestMetadata common.RequestMetadata
}

func (UpdateSessionRequest) BinaryRequestBody

func (request UpdateSessionRequest) BinaryRequestBody() (*common.OCIReadSeekCloser, bool)

BinaryRequestBody implements the OCIRequest interface

func (UpdateSessionRequest) HTTPRequest

func (request UpdateSessionRequest) HTTPRequest(method, path string, binaryRequestBody *common.OCIReadSeekCloser, extraHeaders map[string]string) (http.Request, error)

HTTPRequest implements the OCIRequest interface

func (UpdateSessionRequest) RetryPolicy

func (request UpdateSessionRequest) RetryPolicy() *common.RetryPolicy

RetryPolicy implements the OCIRetryableRequest interface. This retrieves the specified retry policy.

func (UpdateSessionRequest) String

func (request UpdateSessionRequest) String() string

func (UpdateSessionRequest) ValidateEnumValue

func (request UpdateSessionRequest) ValidateEnumValue() (bool, error)

ValidateEnumValue returns an error when providing an unsupported enum value This function is being called during constructing API request process Not recommended for calling this function directly

type UpdateSessionResponse

UpdateSessionResponse wrapper for the UpdateSession operation

type UpdateSessionResponse struct {

    // The underlying http response
    RawResponse *http.Response

    // The Session instance
    Session `presentIn:"body"`

    // For optimistic concurrency control. See `if-match`.
    Etag *string `presentIn:"header" name:"etag"`

    // Unique Oracle-assigned identifier for the request. If you need to contact
    // Oracle about a particular request, please provide the request ID.
    OpcRequestId *string `presentIn:"header" name:"opc-request-id"`
}

func (UpdateSessionResponse) HTTPResponse

func (response UpdateSessionResponse) HTTPResponse() *http.Response

HTTPResponse implements the OCIResponse interface

func (UpdateSessionResponse) String

func (response UpdateSessionResponse) String() string