HEX
Server: Apache
System: Linux scp1.abinfocom.com 5.4.0-216-generic #236-Ubuntu SMP Fri Apr 11 19:53:21 UTC 2025 x86_64
User: confeduphaar (1010)
PHP: 8.1.33
Disabled: exec,passthru,shell_exec,system
Upload Files
File: //lib/mysqlsh/lib/python3.8/site-packages/oci/generative_ai_inference/models/cohere_message.py
# 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: 20231130


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 CohereMessage(object):
    """
    A message that represents a single chat dialog.
    """

    #: A constant which can be used with the role property of a CohereMessage.
    #: This constant has a value of "CHATBOT"
    ROLE_CHATBOT = "CHATBOT"

    #: A constant which can be used with the role property of a CohereMessage.
    #: This constant has a value of "USER"
    ROLE_USER = "USER"

    #: A constant which can be used with the role property of a CohereMessage.
    #: This constant has a value of "SYSTEM"
    ROLE_SYSTEM = "SYSTEM"

    #: A constant which can be used with the role property of a CohereMessage.
    #: This constant has a value of "TOOL"
    ROLE_TOOL = "TOOL"

    def __init__(self, **kwargs):
        """
        Initializes a new CohereMessage 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_inference.models.CohereChatBotMessage`
        * :class:`~oci.generative_ai_inference.models.CohereSystemMessage`
        * :class:`~oci.generative_ai_inference.models.CohereToolMessage`
        * :class:`~oci.generative_ai_inference.models.CohereUserMessage`

        The following keyword arguments are supported (corresponding to the getters/setters of this class):

        :param role:
            The value to assign to the role property of this CohereMessage.
            Allowed values for this property are: "CHATBOT", "USER", "SYSTEM", "TOOL", 'UNKNOWN_ENUM_VALUE'.
            Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.
        :type role: str

        """
        self.swagger_types = {
            'role': 'str'
        }
        self.attribute_map = {
            'role': 'role'
        }
        self._role = 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['role']

        if type == 'CHATBOT':
            return 'CohereChatBotMessage'

        if type == 'SYSTEM':
            return 'CohereSystemMessage'

        if type == 'TOOL':
            return 'CohereToolMessage'

        if type == 'USER':
            return 'CohereUserMessage'
        else:
            return 'CohereMessage'

    @property
    def role(self):
        """
        **[Required]** Gets the role of this CohereMessage.
        To identify who the message is coming from, a role is associated to each message.

        Allowed values for this property are: "CHATBOT", "USER", "SYSTEM", "TOOL", 'UNKNOWN_ENUM_VALUE'.
        Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.


        :return: The role of this CohereMessage.
        :rtype: str
        """
        return self._role

    @role.setter
    def role(self, role):
        """
        Sets the role of this CohereMessage.
        To identify who the message is coming from, a role is associated to each message.


        :param role: The role of this CohereMessage.
        :type: str
        """
        allowed_values = ["CHATBOT", "USER", "SYSTEM", "TOOL"]
        if not value_allowed_none_or_none_sentinel(role, allowed_values):
            role = 'UNKNOWN_ENUM_VALUE'
        self._role = role

    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