Skip to content

ChatSyncInput

Source code in docs_src/capo_qbusiness/types/chat_sync_input.py
class ChatSyncInput(TypedDict, closed=True):
    application_id: "capo_qbusiness.types.application_id.ApplicationId"
    """<p>The identifier of the Amazon Q Business application linked to the Amazon Q Business conversation.</p>"""
    user_id: NotRequired["capo_qbusiness.types.user_id.UserId"]
    """<p>The identifier of the user attached to the chat input.</p>"""
    user_groups: NotRequired["capo_qbusiness.types.user_groups.UserGroups"]
    """<p>The group names that a user associated with the chat input belongs to.</p>"""
    user_message: NotRequired["capo_qbusiness.types.user_message.UserMessage"]
    """<p>A end user message in a conversation.</p>"""
    attachments: NotRequired["capo_qbusiness.types.attachments_input.AttachmentsInput"]
    """<p>A list of files uploaded directly during chat. You can upload a maximum of 5 files of upto 10 MB each.</p>"""
    action_execution: NotRequired[
        "capo_qbusiness.types.action_execution.ActionExecution"
    ]
    """<p>A request from an end user to perform an Amazon Q Business plugin action.</p>"""
    auth_challenge_response: NotRequired[
        "capo_qbusiness.types.auth_challenge_response.AuthChallengeResponse"
    ]
    """<p>An authentication verification event response by a third party authentication server to Amazon Q Business.</p>"""
    conversation_id: NotRequired["capo_qbusiness.types.conversation_id.ConversationId"]
    """<p>The identifier of the Amazon Q Business conversation.</p>"""
    parent_message_id: NotRequired["capo_qbusiness.types.message_id.MessageId"]
    """<p>The identifier of the previous system message in a conversation.</p>"""
    attribute_filter: NotRequired[
        "capo_qbusiness.types.attribute_filter.AttributeFilter"
    ]
    """<p>Enables filtering of Amazon Q Business web experience responses based on document attributes or metadata fields.</p>"""
    chat_mode: NotRequired["capo_qbusiness.types.chat_mode.ChatMode"]
    """<p>The <code>chatMode</code> parameter determines the chat modes available to Amazon Q Business users:</p> <ul> <li> <p> <code>RETRIEVAL_MODE</code> - If you choose this mode, Amazon Q generates responses solely from the data sources connected and indexed by the application. If an answer is not found in the data sources or there are no data sources available, Amazon Q will respond with a "<i>No Answer Found</i>" message, unless LLM knowledge has been enabled. In that case, Amazon Q will generate a response from the LLM knowledge</p> </li> <li> <p> <code>CREATOR_MODE</code> - By selecting this mode, you can choose to generate responses only from the LLM knowledge. You can also attach files and have Amazon Q generate a response based on the data in those files. If the attached files do not contain an answer for the query, Amazon Q will automatically fall back to generating a response from the LLM knowledge.</p> </li> <li> <p> <code>PLUGIN_MODE</code> - By selecting this mode, users can choose to use plugins in chat to get their responses.</p> </li> </ul> <note> <p>If none of the modes are selected, Amazon Q will only respond using the information from the attached files.</p> </note> <p>For more information, see <a href="https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/guardrails.html">Admin controls and guardrails</a>, <a href="https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/plugins.html">Plugins</a>, and <a href="https://docs.aws.amazon.com/amazonq/latest/business-use-dg/using-web-experience.html#chat-source-scope">Response sources</a>.</p>"""
    chat_mode_configuration: NotRequired[
        "capo_qbusiness.types.chat_mode_configuration.ChatModeConfiguration"
    ]
    """<p>The chat mode configuration for an Amazon Q Business application.</p>"""
    client_token: NotRequired["capo_qbusiness.types.client_token.ClientToken"]
    """<p>A token that you provide to identify a chat request.</p>"""

action_execution instance-attribute

action_execution: NotRequired[ActionExecution]

A request from an end user to perform an Amazon Q Business plugin action.

application_id instance-attribute

application_id: ApplicationId

The identifier of the Amazon Q Business application linked to the Amazon Q Business conversation.

attachments instance-attribute

attachments: NotRequired[AttachmentsInput]

A list of files uploaded directly during chat. You can upload a maximum of 5 files of upto 10 MB each.

attribute_filter instance-attribute

attribute_filter: NotRequired[AttributeFilter]

Enables filtering of Amazon Q Business web experience responses based on document attributes or metadata fields.

auth_challenge_response instance-attribute

auth_challenge_response: NotRequired[AuthChallengeResponse]

An authentication verification event response by a third party authentication server to Amazon Q Business.

chat_mode instance-attribute

chat_mode: NotRequired[ChatMode]

The chatMode parameter determines the chat modes available to Amazon Q Business users:

  • RETRIEVAL_MODE - If you choose this mode, Amazon Q generates responses solely from the data sources connected and indexed by the application. If an answer is not found in the data sources or there are no data sources available, Amazon Q will respond with a "No Answer Found" message, unless LLM knowledge has been enabled. In that case, Amazon Q will generate a response from the LLM knowledge

  • CREATOR_MODE - By selecting this mode, you can choose to generate responses only from the LLM knowledge. You can also attach files and have Amazon Q generate a response based on the data in those files. If the attached files do not contain an answer for the query, Amazon Q will automatically fall back to generating a response from the LLM knowledge.

  • PLUGIN_MODE - By selecting this mode, users can choose to use plugins in chat to get their responses.

If none of the modes are selected, Amazon Q will only respond using the information from the attached files.

For more information, see Admin controls and guardrails, Plugins, and Response sources.

chat_mode_configuration instance-attribute

chat_mode_configuration: NotRequired[ChatModeConfiguration]

The chat mode configuration for an Amazon Q Business application.

client_token instance-attribute

client_token: NotRequired[ClientToken]

A token that you provide to identify a chat request.

conversation_id instance-attribute

conversation_id: NotRequired[ConversationId]

The identifier of the Amazon Q Business conversation.

parent_message_id instance-attribute

parent_message_id: NotRequired[MessageId]

The identifier of the previous system message in a conversation.

user_groups instance-attribute

user_groups: NotRequired[UserGroups]

The group names that a user associated with the chat input belongs to.

user_id instance-attribute

user_id: NotRequired[UserId]

The identifier of the user attached to the chat input.

user_message instance-attribute

user_message: NotRequired[UserMessage]

A end user message in a conversation.