メインコンテンツまでスキップ

Update a chatbot

PUT 

/bv/aisk/v1/chatbots/{chatbot.id}

This API is used to update a chatbot resource.


It'll return a 404/NotFound error if any requested resource is not found.

Request

Path Parameters

    chatbot.id stringrequired

    Output only. The uuid of the chatbot resource.

Body

required
    chatbot object

    Required. The chatbot resource to be updated.

    name string

    Required. The display name of the chatbot.

    setting object

    Required. The language model setting of the chatbot.

    model stringrequired

    Possible values: [MODEL_LITE]

    Required.

    character_role string

    Optional.

    character_description string

    Optional.

    creativity floatrequired

    Required.

    response_length objectrequired

    Required. The response length setting of the chatbot.

    enabled boolean

    Optional. Indicates to enable the custom limit response length.

    input int32

    Optional. Required if enabled the custom limit.

    output int32

    Optional. Required if enabled the custom limit.

    appearance object

    Required. The appearance setting of the chatbot.

    enabled boolean

    Optional. Indicates to enable the customization appearance setting.

    setting object

    Optional. Required if enabled the customization appearance setting.

    profile objectrequired

    Required.

    image objectrequired

    Required.

    id stringrequired

    Required. The uuid of the file image.

    display_name stringrequired

    Required.

    message objectrequired

    Required.

    welcome stringrequired

    Required.

    placeholder stringrequired

    Required.

    theme string

    Possible values: [CHATBOT_THEME_DARK, CHATBOT_THEME_LIGHT]

    Optional.

    color objectrequired

    Required.

    user_message stringrequired

    Required.

    widget stringrequired

    Required.

    reference object

    Required. The reference setting of the chatbot.

    kb_selection boolean

    Optional. Indicates the user is able to select which knowledge bases should be used in the chat.

    display_citation boolean

    Optional. Indicates the user can see the citation of the answer that is from which source.

    player object

    Optional. The player setting of the playable citation.

    domain string

    Optional. The BYO domain of the player.

    domain_control object

    Optional. Specify the domains that will be allowed to embed the iframe.

    enabled boolean

    Optional. Enable domain control.

    domains string[]

    Optional. The list of domains that will be allowed to embed the iframe.

    rate_limit object

    Required. The rate limit setting of the chatbot.

    enabled boolean

    Optional. Indicates to enable the rate limit setting.

    setting object

    Optional. Required if enabled the rate limit setting.

    limit int32required

    Required. Indicates the number of messages to throttle the chatbot. It should be set up together with duration to throttle the chatbot at the number of limit messages in a specified duration.

    duration stringrequired

    Required. Indicates the specified duration to throttle the chatbot. It should be set up together with limit to throttle the chatbot at the number of limit messages in a specified duration.

    Example: 1s, 1m

    throttle_message stringrequired

    Required. Indicates the response of the message when the chatbot is being throttled.

    vary_by string

    Possible values: [RATE_LIMIT_VARY_BY_IP, RATE_LIMIT_VARY_BY_DEVICE_ID]

    Optional. Indicates to vary rate limiting chatbot by the selected mode if provided.

    quota_limit object

    Required. The quota limit setting of the chatbot.

    enabled boolean

    Optional. Indicates to enable the quota limit setting.

    setting object

    Optional. Indicates to enable the quota limit setting.

    limit int32required

    Required. Indicates the number of quota messages to limit the chatbot.

    reset stringrequired

    Possible values: [QUOTA_LIMIT_RESET_DAILY]

    Required. Indicates when the quota will be reset.

Responses

A successful response.

Schema
    chatbot object
    id string

    Output only. The uuid of the chatbot resource.

    name stringrequired

    Required. The display name of the chatbot.

    status string

    Possible values: [CHATBOT_STATUS_TRAINING, CHATBOT_STATUS_READY, CHATBOT_STATUS_FAILED]

    Output only. The status of the chatbot.

    setting objectrequired

    Required. The language model setting of the chatbot.

    model stringrequired

    Possible values: [MODEL_LITE]

    Required.

    character_role string

    Optional.

    character_description string

    Optional.

    creativity floatrequired

    Required.

    response_length objectrequired

    Required. The response length setting of the chatbot.

    enabled boolean

    Optional. Indicates to enable the custom limit response length.

    input int32

    Optional. Required if enabled the custom limit.

    output int32

    Optional. Required if enabled the custom limit.

    appearance objectrequired

    Required. The appearance setting of the chatbot.

    enabled boolean

    Optional. Indicates to enable the customization appearance setting.

    setting object

    Optional. Required if enabled the customization appearance setting.

    profile objectrequired

    Required.

    image objectrequired

    Required.

    id stringrequired

    Required. The uuid of the file image.

    url string

    Output only. The image URL to be rendered.

    name string

    Output only. The name of the image.

    display_name stringrequired

    Required.

    message objectrequired

    Required.

    welcome stringrequired

    Required.

    placeholder stringrequired

    Required.

    theme string

    Possible values: [CHATBOT_THEME_DARK, CHATBOT_THEME_LIGHT]

    Optional.

    color objectrequired

    Required.

    user_message stringrequired

    Required.

    widget stringrequired

    Required.

    reference objectrequired

    Required. The reference setting of the chatbot.

    kb_selection boolean

    Optional. Indicates the user is able to select which knowledge bases should be used in the chat.

    display_citation boolean

    Optional. Indicates the user can see the citation of the answer that is from which source.

    player object

    Optional. The player setting of the playable citation.

    domain string

    Optional. The BYO domain of the player.

    domain_control object

    Optional. Specify the domains that will be allowed to embed the iframe.

    enabled boolean

    Optional. Enable domain control.

    domains string[]

    Optional. The list of domains that will be allowed to embed the iframe.

    character_count int64

    Output only. The number of characters of this chatbot used.

    rate_limit objectrequired

    Required. The rate limit setting of the chatbot.

    enabled boolean

    Optional. Indicates to enable the rate limit setting.

    setting object

    Optional. Required if enabled the rate limit setting.

    limit int32required

    Required. Indicates the number of messages to throttle the chatbot. It should be set up together with duration to throttle the chatbot at the number of limit messages in a specified duration.

    duration stringrequired

    Required. Indicates the specified duration to throttle the chatbot. It should be set up together with limit to throttle the chatbot at the number of limit messages in a specified duration.

    Example: 1s, 1m

    throttle_message stringrequired

    Required. Indicates the response of the message when the chatbot is being throttled.

    vary_by string

    Possible values: [RATE_LIMIT_VARY_BY_IP, RATE_LIMIT_VARY_BY_DEVICE_ID]

    Optional. Indicates to vary rate limiting chatbot by the selected mode if provided.

    quota_limit objectrequired

    Required. The quota limit setting of the chatbot.

    enabled boolean

    Optional. Indicates to enable the quota limit setting.

    setting object

    Optional. Indicates to enable the quota limit setting.

    limit int32required

    Required. Indicates the number of quota messages to limit the chatbot.

    reset stringrequired

    Possible values: [QUOTA_LIMIT_RESET_DAILY]

    Required. Indicates when the quota will be reset.

    created_at date-time

    Output only. The time that the chatbot created.

    updated_at date-time

    Output only. The time that the chatbot last updated.

Loading...