oci 2.153.0__py3-none-any.whl → 2.154.1__py3-none-any.whl

oci/generative_ai_agent_runtime/models/execution_trace.py

@@ -0,0 +1,146 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20240531
+
+from .trace import Trace
+from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel  # noqa: F401
+from oci.decorators import init_model_state_from_kwargs
+
+
+@init_model_state_from_kwargs
+class ExecutionTrace(Trace):
+    """
+    Contains trace information related to execution of tool.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new ExecutionTrace object with values from keyword arguments. The default value of the :py:attr:`~oci.generative_ai_agent_runtime.models.ExecutionTrace.trace_type` attribute
+        of this class is ``EXECUTION_TRACE`` and it should not be changed.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param key:
+            The value to assign to the key property of this ExecutionTrace.
+        :type key: str
+
+        :param parent_key:
+            The value to assign to the parent_key property of this ExecutionTrace.
+        :type parent_key: str
+
+        :param source:
+            The value to assign to the source property of this ExecutionTrace.
+        :type source: oci.generative_ai_agent_runtime.models.SourceDetails
+
+        :param time_created:
+            The value to assign to the time_created property of this ExecutionTrace.
+        :type time_created: datetime
+
+        :param time_finished:
+            The value to assign to the time_finished property of this ExecutionTrace.
+        :type time_finished: datetime
+
+        :param trace_type:
+            The value to assign to the trace_type property of this ExecutionTrace.
+            Allowed values for this property are: "ERROR_TRACE", "RETRIEVAL_TRACE", "GENERATION_TRACE", "TOOL_INVOCATION_TRACE", "PLANNING_TRACE", "EXECUTION_TRACE"
+        :type trace_type: str
+
+        :param input:
+            The value to assign to the input property of this ExecutionTrace.
+        :type input: str
+
+        :param output:
+            The value to assign to the output property of this ExecutionTrace.
+        :type output: str
+
+        """
+        self.swagger_types = {
+            'key': 'str',
+            'parent_key': 'str',
+            'source': 'SourceDetails',
+            'time_created': 'datetime',
+            'time_finished': 'datetime',
+            'trace_type': 'str',
+            'input': 'str',
+            'output': 'str'
+        }
+        self.attribute_map = {
+            'key': 'key',
+            'parent_key': 'parentKey',
+            'source': 'source',
+            'time_created': 'timeCreated',
+            'time_finished': 'timeFinished',
+            'trace_type': 'traceType',
+            'input': 'input',
+            'output': 'output'
+        }
+        self._key = None
+        self._parent_key = None
+        self._source = None
+        self._time_created = None
+        self._time_finished = None
+        self._trace_type = None
+        self._input = None
+        self._output = None
+        self._trace_type = 'EXECUTION_TRACE'
+
+    @property
+    def input(self):
+        """
+        Gets the input of this ExecutionTrace.
+        Input data.
+
+
+        :return: The input of this ExecutionTrace.
+        :rtype: str
+        """
+        return self._input
+
+    @input.setter
+    def input(self, input):
+        """
+        Sets the input of this ExecutionTrace.
+        Input data.
+
+
+        :param input: The input of this ExecutionTrace.
+        :type: str
+        """
+        self._input = input
+
+    @property
+    def output(self):
+        """
+        Gets the output of this ExecutionTrace.
+        Output data.
+
+
+        :return: The output of this ExecutionTrace.
+        :rtype: str
+        """
+        return self._output
+
+    @output.setter
+    def output(self, output):
+        """
+        Sets the output of this ExecutionTrace.
+        Output data.
+
+
+        :param output: The output of this ExecutionTrace.
+        :type: str
+        """
+        self._output = output
+
+    def __repr__(self):
+        return formatted_flat_dict(self)
+
+    def __eq__(self, other):
+        if other is None:
+            return False
+
+        return self.__dict__ == other.__dict__
+
+    def __ne__(self, other):
+        return not self == other

oci/generative_ai_agent_runtime/models/generation_trace.py

@@ -21,33 +21,75 @@ class GenerationTrace(Trace):
         of this class is ``GENERATION_TRACE`` and it should not be changed.
         The following keyword arguments are supported (corresponding to the getters/setters of this class):
 
+        :param key:
+            The value to assign to the key property of this GenerationTrace.
+        :type key: str
+
+        :param parent_key:
+            The value to assign to the parent_key property of this GenerationTrace.
+        :type parent_key: str
+
+        :param source:
+            The value to assign to the source property of this GenerationTrace.
+        :type source: oci.generative_ai_agent_runtime.models.SourceDetails
+
         :param time_created:
             The value to assign to the time_created property of this GenerationTrace.
         :type time_created: datetime
 
+        :param time_finished:
+            The value to assign to the time_finished property of this GenerationTrace.
+        :type time_finished: datetime
+
         :param trace_type:
             The value to assign to the trace_type property of this GenerationTrace.
-            Allowed values for this property are: "ERROR_TRACE", "RETRIEVAL_TRACE", "GENERATION_TRACE"
+            Allowed values for this property are: "ERROR_TRACE", "RETRIEVAL_TRACE", "GENERATION_TRACE", "TOOL_INVOCATION_TRACE", "PLANNING_TRACE", "EXECUTION_TRACE"
         :type trace_type: str
 
         :param generation:
             The value to assign to the generation property of this GenerationTrace.
         :type generation: str
 
+        :param input:
+            The value to assign to the input property of this GenerationTrace.
+        :type input: str
+
+        :param usage:
+            The value to assign to the usage property of this GenerationTrace.
+        :type usage: list[oci.generative_ai_agent_runtime.models.Usage]
+
         """
         self.swagger_types = {
+            'key': 'str',
+            'parent_key': 'str',
+            'source': 'SourceDetails',
             'time_created': 'datetime',
+            'time_finished': 'datetime',
             'trace_type': 'str',
-            'generation': 'str'
+            'generation': 'str',
+            'input': 'str',
+            'usage': 'list[Usage]'
         }
         self.attribute_map = {
+            'key': 'key',
+            'parent_key': 'parentKey',
+            'source': 'source',
             'time_created': 'timeCreated',
+            'time_finished': 'timeFinished',
             'trace_type': 'traceType',
-            'generation': 'generation'
+            'generation': 'generation',
+            'input': 'input',
+            'usage': 'usage'
         }
+        self._key = None
+        self._parent_key = None
+        self._source = None
         self._time_created = None
+        self._time_finished = None
         self._trace_type = None
         self._generation = None
+        self._input = None
+        self._usage = None
         self._trace_type = 'GENERATION_TRACE'
 
     @property
@@ -74,6 +116,54 @@ class GenerationTrace(Trace):
         """
         self._generation = generation
 
+    @property
+    def input(self):
+        """
+        Gets the input of this GenerationTrace.
+        The input to the generation operation.
+
+
+        :return: The input of this GenerationTrace.
+        :rtype: str
+        """
+        return self._input
+
+    @input.setter
+    def input(self, input):
+        """
+        Sets the input of this GenerationTrace.
+        The input to the generation operation.
+
+
+        :param input: The input of this GenerationTrace.
+        :type: str
+        """
+        self._input = input
+
+    @property
+    def usage(self):
+        """
+        Gets the usage of this GenerationTrace.
+        Details of model and its usage.
+
+
+        :return: The usage of this GenerationTrace.
+        :rtype: list[oci.generative_ai_agent_runtime.models.Usage]
+        """
+        return self._usage
+
+    @usage.setter
+    def usage(self, usage):
+        """
+        Sets the usage of this GenerationTrace.
+        Details of model and its usage.
+
+
+        :param usage: The usage of this GenerationTrace.
+        :type: list[oci.generative_ai_agent_runtime.models.Usage]
+        """
+        self._usage = usage
+
     def __repr__(self):
         return formatted_flat_dict(self)
 

oci/generative_ai_agent_runtime/models/human_approval_required_action.py

@@ -0,0 +1,135 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20240531
+
+from .required_action import RequiredAction
+from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel  # noqa: F401
+from oci.decorators import init_model_state_from_kwargs
+
+
+@init_model_state_from_kwargs
+class HumanApprovalRequiredAction(RequiredAction):
+    """
+    An object describing human confirmation of tool execution that is required from the user.
+    """
+
+    #: A constant which can be used with the options property of a HumanApprovalRequiredAction.
+    #: This constant has a value of "APPROVE"
+    OPTIONS_APPROVE = "APPROVE"
+
+    #: A constant which can be used with the options property of a HumanApprovalRequiredAction.
+    #: This constant has a value of "DENY"
+    OPTIONS_DENY = "DENY"
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new HumanApprovalRequiredAction object with values from keyword arguments. The default value of the :py:attr:`~oci.generative_ai_agent_runtime.models.HumanApprovalRequiredAction.required_action_type` attribute
+        of this class is ``HUMAN_APPROVAL_REQUIRED_ACTION`` and it should not be changed.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param action_id:
+            The value to assign to the action_id property of this HumanApprovalRequiredAction.
+        :type action_id: str
+
+        :param required_action_type:
+            The value to assign to the required_action_type property of this HumanApprovalRequiredAction.
+            Allowed values for this property are: "HUMAN_APPROVAL_REQUIRED_ACTION", "FUNCTION_CALLING_REQUIRED_ACTION", 'UNKNOWN_ENUM_VALUE'.
+            Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.
+        :type required_action_type: str
+
+        :param message:
+            The value to assign to the message property of this HumanApprovalRequiredAction.
+        :type message: str
+
+        :param options:
+            The value to assign to the options property of this HumanApprovalRequiredAction.
+            Allowed values for items in this list are: "APPROVE", "DENY", 'UNKNOWN_ENUM_VALUE'.
+            Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.
+        :type options: list[str]
+
+        """
+        self.swagger_types = {
+            'action_id': 'str',
+            'required_action_type': 'str',
+            'message': 'str',
+            'options': 'list[str]'
+        }
+        self.attribute_map = {
+            'action_id': 'actionId',
+            'required_action_type': 'requiredActionType',
+            'message': 'message',
+            'options': 'options'
+        }
+        self._action_id = None
+        self._required_action_type = None
+        self._message = None
+        self._options = None
+        self._required_action_type = 'HUMAN_APPROVAL_REQUIRED_ACTION'
+
+    @property
+    def message(self):
+        """
+        **[Required]** Gets the message of this HumanApprovalRequiredAction.
+        Message accompanying the human input request asking for approval or denial of a tool execution.
+
+
+        :return: The message of this HumanApprovalRequiredAction.
+        :rtype: str
+        """
+        return self._message
+
+    @message.setter
+    def message(self, message):
+        """
+        Sets the message of this HumanApprovalRequiredAction.
+        Message accompanying the human input request asking for approval or denial of a tool execution.
+
+
+        :param message: The message of this HumanApprovalRequiredAction.
+        :type: str
+        """
+        self._message = message
+
+    @property
+    def options(self):
+        """
+        **[Required]** Gets the options of this HumanApprovalRequiredAction.
+        The options presented to the user approving and denying execution of the tool.
+
+        Allowed values for items in this list are: "APPROVE", "DENY", 'UNKNOWN_ENUM_VALUE'.
+        Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.
+
+
+        :return: The options of this HumanApprovalRequiredAction.
+        :rtype: list[str]
+        """
+        return self._options
+
+    @options.setter
+    def options(self, options):
+        """
+        Sets the options of this HumanApprovalRequiredAction.
+        The options presented to the user approving and denying execution of the tool.
+
+
+        :param options: The options of this HumanApprovalRequiredAction.
+        :type: list[str]
+        """
+        allowed_values = ["APPROVE", "DENY"]
+        if options:
+            options[:] = ['UNKNOWN_ENUM_VALUE' if not value_allowed_none_or_none_sentinel(x, allowed_values) else x for x in options]
+        self._options = options
+
+    def __repr__(self):
+        return formatted_flat_dict(self)
+
+    def __eq__(self, other):
+        if other is None:
+            return False
+
+        return self.__dict__ == other.__dict__
+
+    def __ne__(self, other):
+        return not self == other

oci/generative_ai_agent_runtime/models/model_details.py

@@ -0,0 +1,128 @@
+# coding: utf-8
+# Copyright (c) 2016, 2025, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20240531
+
+
+from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel  # noqa: F401
+from oci.decorators import init_model_state_from_kwargs
+
+
+@init_model_state_from_kwargs
+class ModelDetails(object):
+    """
+    Model details.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new ModelDetails object with values from keyword arguments.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param model_name:
+            The value to assign to the model_name property of this ModelDetails.
+        :type model_name: str
+
+        :param model_version:
+            The value to assign to the model_version property of this ModelDetails.
+        :type model_version: str
+
+        :param model_params:
+            The value to assign to the model_params property of this ModelDetails.
+        :type model_params: oci.generative_ai_agent_runtime.models.ModelParams
+
+        """
+        self.swagger_types = {
+            'model_name': 'str',
+            'model_version': 'str',
+            'model_params': 'ModelParams'
+        }
+        self.attribute_map = {
+            'model_name': 'modelName',
+            'model_version': 'modelVersion',
+            'model_params': 'modelParams'
+        }
+        self._model_name = None
+        self._model_version = None
+        self._model_params = None
+
+    @property
+    def model_name(self):
+        """
+        Gets the model_name of this ModelDetails.
+        Name of the model.
+
+
+        :return: The model_name of this ModelDetails.
+        :rtype: str
+        """
+        return self._model_name
+
+    @model_name.setter
+    def model_name(self, model_name):
+        """
+        Sets the model_name of this ModelDetails.
+        Name of the model.
+
+
+        :param model_name: The model_name of this ModelDetails.
+        :type: str
+        """
+        self._model_name = model_name
+
+    @property
+    def model_version(self):
+        """
+        Gets the model_version of this ModelDetails.
+        Version of the model.
+
+
+        :return: The model_version of this ModelDetails.
+        :rtype: str
+        """
+        return self._model_version
+
+    @model_version.setter
+    def model_version(self, model_version):
+        """
+        Sets the model_version of this ModelDetails.
+        Version of the model.
+
+
+        :param model_version: The model_version of this ModelDetails.
+        :type: str
+        """
+        self._model_version = model_version
+
+    @property
+    def model_params(self):
+        """
+        Gets the model_params of this ModelDetails.
+
+        :return: The model_params of this ModelDetails.
+        :rtype: oci.generative_ai_agent_runtime.models.ModelParams
+        """
+        return self._model_params
+
+    @model_params.setter
+    def model_params(self, model_params):
+        """
+        Sets the model_params of this ModelDetails.
+
+        :param model_params: The model_params of this ModelDetails.
+        :type: oci.generative_ai_agent_runtime.models.ModelParams
+        """
+        self._model_params = model_params
+
+    def __repr__(self):
+        return formatted_flat_dict(self)
+
+    def __eq__(self, other):
+        if other is None:
+            return False
+
+        return self.__dict__ == other.__dict__
+
+    def __ne__(self, other):
+        return not self == other