oci 2.149.0__py3-none-any.whl → 2.149.1__py3-none-any.whl

oci/generative_ai_agent/models/human_input_config.py

@@ -0,0 +1,70 @@
+# 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 HumanInputConfig(object):
+    """
+    Human Input Configuration for an AgentEndpoint.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new HumanInputConfig object with values from keyword arguments.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param should_enable_human_input:
+            The value to assign to the should_enable_human_input property of this HumanInputConfig.
+        :type should_enable_human_input: bool
+
+        """
+        self.swagger_types = {
+            'should_enable_human_input': 'bool'
+        }
+        self.attribute_map = {
+            'should_enable_human_input': 'shouldEnableHumanInput'
+        }
+        self._should_enable_human_input = None
+
+    @property
+    def should_enable_human_input(self):
+        """
+        **[Required]** Gets the should_enable_human_input of this HumanInputConfig.
+        The Agent will request for human input for disambiguation or additional information gathering if this is enabled.
+
+
+        :return: The should_enable_human_input of this HumanInputConfig.
+        :rtype: bool
+        """
+        return self._should_enable_human_input
+
+    @should_enable_human_input.setter
+    def should_enable_human_input(self, should_enable_human_input):
+        """
+        Sets the should_enable_human_input of this HumanInputConfig.
+        The Agent will request for human input for disambiguation or additional information gathering if this is enabled.
+
+
+        :param should_enable_human_input: The should_enable_human_input of this HumanInputConfig.
+        :type: bool
+        """
+        self._should_enable_human_input = should_enable_human_input
+
+    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/models/idcs_secret.py

@@ -23,7 +23,8 @@ class IdcsSecret(SecretDetail):
 
         :param type:
             The value to assign to the type property of this IdcsSecret.
-            Allowed values for this property are: "IDCS_SECRET", "BASIC_AUTH_SECRET"
+            Allowed values for this property are: "IDCS_SECRET", "BASIC_AUTH_SECRET", 'UNKNOWN_ENUM_VALUE'.
+            Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.
         :type type: str
 
         :param idcs_url:

oci/generative_ai_agent/models/inline_input_location.py

@@ -0,0 +1,80 @@
+# 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 .input_location import InputLocation
+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 InlineInputLocation(InputLocation):
+    """
+    The details of inline input location.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new InlineInputLocation object with values from keyword arguments. The default value of the :py:attr:`~oci.generative_ai_agent.models.InlineInputLocation.input_location_type` attribute
+        of this class is ``INLINE`` and it should not be changed.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param input_location_type:
+            The value to assign to the input_location_type property of this InlineInputLocation.
+            Allowed values for this property are: "INLINE", "OBJECT_STORAGE_PREFIX"
+        :type input_location_type: str
+
+        :param content:
+            The value to assign to the content property of this InlineInputLocation.
+        :type content: str
+
+        """
+        self.swagger_types = {
+            'input_location_type': 'str',
+            'content': 'str'
+        }
+        self.attribute_map = {
+            'input_location_type': 'inputLocationType',
+            'content': 'content'
+        }
+        self._input_location_type = None
+        self._content = None
+        self._input_location_type = 'INLINE'
+
+    @property
+    def content(self):
+        """
+        Gets the content of this InlineInputLocation.
+        Inline content as input.
+
+
+        :return: The content of this InlineInputLocation.
+        :rtype: str
+        """
+        return self._content
+
+    @content.setter
+    def content(self, content):
+        """
+        Sets the content of this InlineInputLocation.
+        Inline content as input.
+
+
+        :param content: The content of this InlineInputLocation.
+        :type: str
+        """
+        self._content = content
+
+    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/models/input_location.py

@@ -0,0 +1,113 @@
+# 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 InputLocation(object):
+    """
+    The input location definition.
+    """
+
+    #: A constant which can be used with the input_location_type property of a InputLocation.
+    #: This constant has a value of "INLINE"
+    INPUT_LOCATION_TYPE_INLINE = "INLINE"
+
+    #: A constant which can be used with the input_location_type property of a InputLocation.
+    #: This constant has a value of "OBJECT_STORAGE_PREFIX"
+    INPUT_LOCATION_TYPE_OBJECT_STORAGE_PREFIX = "OBJECT_STORAGE_PREFIX"
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new InputLocation object with values from keyword arguments. This class has the following subclasses and if you are using this class as input
+        to a service operations then you should favor using a subclass over the base class:
+
+        * :class:`~oci.generative_ai_agent.models.ObjectStorageInputLocation`
+        * :class:`~oci.generative_ai_agent.models.InlineInputLocation`
+
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param input_location_type:
+            The value to assign to the input_location_type property of this InputLocation.
+            Allowed values for this property are: "INLINE", "OBJECT_STORAGE_PREFIX", 'UNKNOWN_ENUM_VALUE'.
+            Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.
+        :type input_location_type: str
+
+        """
+        self.swagger_types = {
+            'input_location_type': 'str'
+        }
+        self.attribute_map = {
+            'input_location_type': 'inputLocationType'
+        }
+        self._input_location_type = None
+
+    @staticmethod
+    def get_subtype(object_dictionary):
+        """
+        Given the hash representation of a subtype of this class,
+        use the info in the hash to return the class of the subtype.
+        """
+        type = object_dictionary['inputLocationType']
+
+        if type == 'OBJECT_STORAGE_PREFIX':
+            return 'ObjectStorageInputLocation'
+
+        if type == 'INLINE':
+            return 'InlineInputLocation'
+        else:
+            return 'InputLocation'
+
+    @property
+    def input_location_type(self):
+        """
+        **[Required]** Gets the input_location_type of this InputLocation.
+        Type of InputLocation.
+        The allowed values are:
+        - `INLINE`: The input location is inline.
+        - `OBJECT_STORAGE_PREFIX`: The input location is object storage.
+
+        Allowed values for this property are: "INLINE", "OBJECT_STORAGE_PREFIX", 'UNKNOWN_ENUM_VALUE'.
+        Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.
+
+
+        :return: The input_location_type of this InputLocation.
+        :rtype: str
+        """
+        return self._input_location_type
+
+    @input_location_type.setter
+    def input_location_type(self, input_location_type):
+        """
+        Sets the input_location_type of this InputLocation.
+        Type of InputLocation.
+        The allowed values are:
+        - `INLINE`: The input location is inline.
+        - `OBJECT_STORAGE_PREFIX`: The input location is object storage.
+
+
+        :param input_location_type: The input_location_type of this InputLocation.
+        :type: str
+        """
+        allowed_values = ["INLINE", "OBJECT_STORAGE_PREFIX"]
+        if not value_allowed_none_or_none_sentinel(input_location_type, allowed_values):
+            input_location_type = 'UNKNOWN_ENUM_VALUE'
+        self._input_location_type = input_location_type
+
+    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/models/knowledge_base_config.py

@@ -0,0 +1,74 @@
+# 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 KnowledgeBaseConfig(object):
+    """
+    The KnowledgeBase configuration this RAG Tool uses.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new KnowledgeBaseConfig object with values from keyword arguments.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param knowledge_base_id:
+            The value to assign to the knowledge_base_id property of this KnowledgeBaseConfig.
+        :type knowledge_base_id: str
+
+        """
+        self.swagger_types = {
+            'knowledge_base_id': 'str'
+        }
+        self.attribute_map = {
+            'knowledge_base_id': 'knowledgeBaseId'
+        }
+        self._knowledge_base_id = None
+
+    @property
+    def knowledge_base_id(self):
+        """
+        **[Required]** Gets the knowledge_base_id of this KnowledgeBaseConfig.
+        The `OCID`__ of the knowledgeBase this RAG Tool uses
+
+        __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
+
+
+        :return: The knowledge_base_id of this KnowledgeBaseConfig.
+        :rtype: str
+        """
+        return self._knowledge_base_id
+
+    @knowledge_base_id.setter
+    def knowledge_base_id(self, knowledge_base_id):
+        """
+        Sets the knowledge_base_id of this KnowledgeBaseConfig.
+        The `OCID`__ of the knowledgeBase this RAG Tool uses
+
+        __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
+
+
+        :param knowledge_base_id: The knowledge_base_id of this KnowledgeBaseConfig.
+        :type: str
+        """
+        self._knowledge_base_id = knowledge_base_id
+
+    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/models/llm_config.py

@@ -0,0 +1,66 @@
+# 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 LlmConfig(object):
+    """
+    Configuration to Agent LLM.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new LlmConfig object with values from keyword arguments.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param routing_llm_customization:
+            The value to assign to the routing_llm_customization property of this LlmConfig.
+        :type routing_llm_customization: oci.generative_ai_agent.models.LlmCustomization
+
+        """
+        self.swagger_types = {
+            'routing_llm_customization': 'LlmCustomization'
+        }
+        self.attribute_map = {
+            'routing_llm_customization': 'routingLlmCustomization'
+        }
+        self._routing_llm_customization = None
+
+    @property
+    def routing_llm_customization(self):
+        """
+        Gets the routing_llm_customization of this LlmConfig.
+
+        :return: The routing_llm_customization of this LlmConfig.
+        :rtype: oci.generative_ai_agent.models.LlmCustomization
+        """
+        return self._routing_llm_customization
+
+    @routing_llm_customization.setter
+    def routing_llm_customization(self, routing_llm_customization):
+        """
+        Sets the routing_llm_customization of this LlmConfig.
+
+        :param routing_llm_customization: The routing_llm_customization of this LlmConfig.
+        :type: oci.generative_ai_agent.models.LlmCustomization
+        """
+        self._routing_llm_customization = routing_llm_customization
+
+    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/models/llm_customization.py

@@ -0,0 +1,70 @@
+# 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 LlmCustomization(object):
+    """
+    Configuration to customize LLM.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new LlmCustomization object with values from keyword arguments.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param instruction:
+            The value to assign to the instruction property of this LlmCustomization.
+        :type instruction: str
+
+        """
+        self.swagger_types = {
+            'instruction': 'str'
+        }
+        self.attribute_map = {
+            'instruction': 'instruction'
+        }
+        self._instruction = None
+
+    @property
+    def instruction(self):
+        """
+        Gets the instruction of this LlmCustomization.
+        If specified, the default instruction is replaced with provided instruction.
+
+
+        :return: The instruction of this LlmCustomization.
+        :rtype: str
+        """
+        return self._instruction
+
+    @instruction.setter
+    def instruction(self, instruction):
+        """
+        Sets the instruction of this LlmCustomization.
+        If specified, the default instruction is replaced with provided instruction.
+
+
+        :param instruction: The instruction of this LlmCustomization.
+        :type: str
+        """
+        self._instruction = instruction
+
+    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/models/object_storage_input_location.py

@@ -0,0 +1,142 @@
+# 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 .input_location import InputLocation
+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 ObjectStorageInputLocation(InputLocation):
+    """
+    The details of OCI Object Storage object.
+    """
+
+    def __init__(self, **kwargs):
+        """
+        Initializes a new ObjectStorageInputLocation object with values from keyword arguments. The default value of the :py:attr:`~oci.generative_ai_agent.models.ObjectStorageInputLocation.input_location_type` attribute
+        of this class is ``OBJECT_STORAGE_PREFIX`` and it should not be changed.
+        The following keyword arguments are supported (corresponding to the getters/setters of this class):
+
+        :param input_location_type:
+            The value to assign to the input_location_type property of this ObjectStorageInputLocation.
+            Allowed values for this property are: "INLINE", "OBJECT_STORAGE_PREFIX"
+        :type input_location_type: str
+
+        :param namespace_name:
+            The value to assign to the namespace_name property of this ObjectStorageInputLocation.
+        :type namespace_name: str
+
+        :param bucket_name:
+            The value to assign to the bucket_name property of this ObjectStorageInputLocation.
+        :type bucket_name: str
+
+        :param prefix:
+            The value to assign to the prefix property of this ObjectStorageInputLocation.
+        :type prefix: str
+
+        """
+        self.swagger_types = {
+            'input_location_type': 'str',
+            'namespace_name': 'str',
+            'bucket_name': 'str',
+            'prefix': 'str'
+        }
+        self.attribute_map = {
+            'input_location_type': 'inputLocationType',
+            'namespace_name': 'namespaceName',
+            'bucket_name': 'bucketName',
+            'prefix': 'prefix'
+        }
+        self._input_location_type = None
+        self._namespace_name = None
+        self._bucket_name = None
+        self._prefix = None
+        self._input_location_type = 'OBJECT_STORAGE_PREFIX'
+
+    @property
+    def namespace_name(self):
+        """
+        **[Required]** Gets the namespace_name of this ObjectStorageInputLocation.
+        The namespace name of an object.
+
+
+        :return: The namespace_name of this ObjectStorageInputLocation.
+        :rtype: str
+        """
+        return self._namespace_name
+
+    @namespace_name.setter
+    def namespace_name(self, namespace_name):
+        """
+        Sets the namespace_name of this ObjectStorageInputLocation.
+        The namespace name of an object.
+
+
+        :param namespace_name: The namespace_name of this ObjectStorageInputLocation.
+        :type: str
+        """
+        self._namespace_name = namespace_name
+
+    @property
+    def bucket_name(self):
+        """
+        **[Required]** Gets the bucket_name of this ObjectStorageInputLocation.
+        The bucket name of an object.
+
+
+        :return: The bucket_name of this ObjectStorageInputLocation.
+        :rtype: str
+        """
+        return self._bucket_name
+
+    @bucket_name.setter
+    def bucket_name(self, bucket_name):
+        """
+        Sets the bucket_name of this ObjectStorageInputLocation.
+        The bucket name of an object.
+
+
+        :param bucket_name: The bucket_name of this ObjectStorageInputLocation.
+        :type: str
+        """
+        self._bucket_name = bucket_name
+
+    @property
+    def prefix(self):
+        """
+        Gets the prefix of this ObjectStorageInputLocation.
+        The prefix of file object(s) or folder prefix.
+
+
+        :return: The prefix of this ObjectStorageInputLocation.
+        :rtype: str
+        """
+        return self._prefix
+
+    @prefix.setter
+    def prefix(self, prefix):
+        """
+        Sets the prefix of this ObjectStorageInputLocation.
+        The prefix of file object(s) or folder prefix.
+
+
+        :param prefix: The prefix of this ObjectStorageInputLocation.
+        :type: str
+        """
+        self._prefix = prefix
+
+    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/models/object_storage_prefix.py

@@ -99,7 +99,7 @@ class ObjectStoragePrefix(object):
     def prefix(self):
         """
         Gets the prefix of this ObjectStoragePrefix.
-        The name of the object (file) or prefix (folder).
+        The prefix of file object(s) or folder prefix.
 
 
         :return: The prefix of this ObjectStoragePrefix.
@@ -111,7 +111,7 @@ class ObjectStoragePrefix(object):
     def prefix(self, prefix):
         """
         Sets the prefix of this ObjectStoragePrefix.
-        The name of the object (file) or prefix (folder).
+        The prefix of file object(s) or folder prefix.
 
 
         :param prefix: The prefix of this ObjectStoragePrefix.