assistantv2

type AgentAvailabilityMessage struct {
	// The text of the message.
	Message *string `json:"message,omitempty"`
}

type AssistantV2 struct {
	Service *core.BaseService

	// Release date of the API version you want to use. Specify dates in YYYY-MM-DD format. The current version is
	// `2021-11-27`.
	Version *string
}

type AssistantV2Options struct {
	ServiceName   string
	URL           string
	Authenticator core.Authenticator

	// Release date of the API version you want to use. Specify dates in YYYY-MM-DD format. The current version is
	// `2021-11-27`.
	Version *string `validate:"required"`
}

type BulkClassifyOptions struct {
	// Unique identifier of the skill. To find the skill ID in the Watson Assistant user interface, open the skill settings
	// and click **API Details**.
	SkillID *string `json:"skill_id" validate:"required,ne="`

	// An array of input utterances to classify.
	Input []BulkClassifyUtterance `json:"input,omitempty"`

	// Allows users to set headers on API requests
	Headers map[string]string
}

type BulkClassifyOutput struct {
	// The user input utterance to classify.
	Input *BulkClassifyUtterance `json:"input,omitempty"`

	// An array of entities identified in the utterance.
	Entities []RuntimeEntity `json:"entities,omitempty"`

	// An array of intents recognized in the utterance.
	Intents []RuntimeIntent `json:"intents,omitempty"`
}

type BulkClassifyResponse struct {
	// An array of objects that contain classification information for the submitted input utterances.
	Output []BulkClassifyOutput `json:"output,omitempty"`
}

type BulkClassifyUtterance struct {
	// The text of the input utterance.
	Text *string `json:"text" validate:"required"`
}

type CaptureGroup struct {
	// A recognized capture group for the entity.
	Group *string `json:"group" validate:"required"`

	// Zero-based character offsets that indicate where the entity value begins and ends in the input text.
	Location []int64 `json:"location,omitempty"`
}

type ChannelTransferInfo struct {
	// An object specifying target channels available for the transfer. Each property of this object represents an
	// available transfer target. Currently, the only supported property is **chat**, representing the web chat
	// integration.
	Target *ChannelTransferTarget `json:"target" validate:"required"`
}

type ChannelTransferTarget struct {
	// Information for transferring to the web chat integration.
	Chat *ChannelTransferTargetChat `json:"chat,omitempty"`
}

type ChannelTransferTargetChat struct {
	// The URL of the target web chat.
	URL *string `json:"url,omitempty"`
}

type CreateSessionOptions struct {
	// Unique identifier of the assistant. To find the assistant ID in the Watson Assistant user interface, open the
	// assistant settings and click **API Details**. For information about creating assistants, see the
	// [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-assistant-add#assistant-add-task).
	//
	// **Note:** Currently, the v2 API does not support creating assistants.
	AssistantID *string `json:"assistant_id" validate:"required,ne="`

	// Allows users to set headers on API requests
	Headers map[string]string
}

type DeleteSessionOptions struct {
	// Unique identifier of the assistant. To find the assistant ID in the Watson Assistant user interface, open the
	// assistant settings and click **API Details**. For information about creating assistants, see the
	// [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-assistant-add#assistant-add-task).
	//
	// **Note:** Currently, the v2 API does not support creating assistants.
	AssistantID *string `json:"assistant_id" validate:"required,ne="`

	// Unique identifier of the session.
	SessionID *string `json:"session_id" validate:"required,ne="`

	// Allows users to set headers on API requests
	Headers map[string]string
}

type DeleteUserDataOptions struct {
	// The customer ID for which all data is to be deleted.
	CustomerID *string `json:"customer_id" validate:"required"`

	// Allows users to set headers on API requests
	Headers map[string]string
}

type DialogLogMessage struct {
	// The severity of the log message.
	Level *string `json:"level" validate:"required"`

	// The text of the log message.
	Message *string `json:"message" validate:"required"`

	// A code that indicates the category to which the error message belongs.
	Code *string `json:"code" validate:"required"`

	// An object that identifies the dialog element that generated the error message.
	Source LogMessageSourceIntf `json:"source,omitempty"`
}

type DialogNodeAction struct {
	// The name of the action.
	Name *string `json:"name" validate:"required"`

	// The type of action to invoke.
	Type *string `json:"type,omitempty"`

	// A map of key/value pairs to be provided to the action.
	Parameters map[string]interface{} `json:"parameters,omitempty"`

	// The location in the dialog context where the result of the action is stored.
	ResultVariable *string `json:"result_variable" validate:"required"`

	// The name of the context variable that the client application will use to pass in credentials for the action.
	Credentials *string `json:"credentials,omitempty"`
}

type DialogNodeOutputConnectToAgentTransferInfo struct {
	Target map[string]map[string]interface{} `json:"target,omitempty"`
}

type DialogNodeOutputOptionsElement struct {
	// The user-facing label for the option.
	Label *string `json:"label" validate:"required"`

	// An object defining the message input to be sent to the assistant if the user selects the corresponding option.
	Value *DialogNodeOutputOptionsElementValue `json:"value" validate:"required"`
}

type DialogNodeOutputOptionsElementValue struct {
	// An input object that includes the input text.
	Input *MessageInput `json:"input,omitempty"`
}

type DialogNodeVisited struct {
	// A dialog node that was triggered during processing of the input message.
	DialogNode *string `json:"dialog_node,omitempty"`

	// The title of the dialog node.
	Title *string `json:"title,omitempty"`

	// The conditions that trigger the dialog node.
	Conditions *string `json:"conditions,omitempty"`
}

type DialogSuggestion struct {
	// The user-facing label for the suggestion. This label is taken from the **title** or **user_label** property of the
	// corresponding dialog node, depending on the disambiguation options.
	Label *string `json:"label" validate:"required"`

	// An object defining the message input to be sent to the assistant if the user selects the corresponding
	// disambiguation option.
	Value *DialogSuggestionValue `json:"value" validate:"required"`

	// The dialog output that will be returned from the Watson Assistant service if the user selects the corresponding
	// option.
	Output map[string]interface{} `json:"output,omitempty"`
}

type DialogSuggestionValue struct {
	// An input object that includes the input text.
	Input *MessageInput `json:"input,omitempty"`
}

type ListLogsOptions struct {
	// Unique identifier of the assistant. To find the assistant ID in the Watson Assistant user interface, open the
	// assistant settings and click **API Details**. For information about creating assistants, see the
	// [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-assistant-add#assistant-add-task).
	//
	// **Note:** Currently, the v2 API does not support creating assistants.
	AssistantID *string `json:"assistant_id" validate:"required,ne="`

	// How to sort the returned log events. You can sort by **request_timestamp**. To reverse the sort order, prefix the
	// parameter value with a minus sign (`-`).
	Sort *string `json:"sort,omitempty"`

	// A cacheable parameter that limits the results to those matching the specified filter. For more information, see the
	// [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-filter-reference#filter-reference).
	Filter *string `json:"filter,omitempty"`

	// The number of records to return in each page of results.
	PageLimit *int64 `json:"page_limit,omitempty"`

	// A token identifying the page of results to retrieve.
	Cursor *string `json:"cursor,omitempty"`

	// Allows users to set headers on API requests
	Headers map[string]string
}

type Log struct {
	// A unique identifier for the logged event.
	LogID *string `json:"log_id" validate:"required"`

	// A stateful message request formatted for the Watson Assistant service.
	Request *MessageRequest `json:"request" validate:"required"`

	// A response from the Watson Assistant service.
	Response *MessageResponse `json:"response" validate:"required"`

	// Unique identifier of the assistant.
	AssistantID *string `json:"assistant_id" validate:"required"`

	// The ID of the session the message was part of.
	SessionID *string `json:"session_id" validate:"required"`

	// The unique identifier of the skill that responded to the message.
	SkillID *string `json:"skill_id" validate:"required"`

	// The name of the snapshot (dialog skill version) that responded to the message (for example, `draft`).
	Snapshot *string `json:"snapshot" validate:"required"`

	// The timestamp for receipt of the message.
	RequestTimestamp *string `json:"request_timestamp" validate:"required"`

	// The timestamp for the system response to the message.
	ResponseTimestamp *string `json:"response_timestamp" validate:"required"`

	// The language of the assistant to which the message request was made.
	Language *string `json:"language" validate:"required"`

	// The customer ID specified for the message, if any.
	CustomerID *string `json:"customer_id,omitempty"`
}

type LogCollection struct {
	// An array of objects describing log events.
	Logs []Log `json:"logs" validate:"required"`

	// The pagination data for the returned objects.
	Pagination *LogPagination `json:"pagination" validate:"required"`
}

type LogMessageSource struct {
	// A string that indicates the type of dialog element that generated the error message.
	Type *string `json:"type,omitempty"`

	// The unique identifier of the dialog node that generated the error message.
	DialogNode *string `json:"dialog_node,omitempty"`

	// The unique identifier of the action that generated the error message.
	Action *string `json:"action,omitempty"`

	// The unique identifier of the step that generated the error message.
	Step *string `json:"step,omitempty"`

	// The unique identifier of the handler that generated the error message.
	Handler *string `json:"handler,omitempty"`
}

type LogMessageSourceAction struct {
	// A string that indicates the type of dialog element that generated the error message.
	Type *string `json:"type" validate:"required"`

	// The unique identifier of the action that generated the error message.
	Action *string `json:"action" validate:"required"`
}

type LogMessageSourceDialogNode struct {
	// A string that indicates the type of dialog element that generated the error message.
	Type *string `json:"type" validate:"required"`

	// The unique identifier of the dialog node that generated the error message.
	DialogNode *string `json:"dialog_node" validate:"required"`
}

type LogMessageSourceHandler struct {
	// A string that indicates the type of dialog element that generated the error message.
	Type *string `json:"type" validate:"required"`

	// The unique identifier of the action that generated the error message.
	Action *string `json:"action" validate:"required"`

	// The unique identifier of the step that generated the error message.
	Step *string `json:"step,omitempty"`

	// The unique identifier of the handler that generated the error message.
	Handler *string `json:"handler" validate:"required"`
}

type LogMessageSourceIntf interface {
	// contains filtered or unexported methods
}

type LogMessageSourceStep struct {
	// A string that indicates the type of dialog element that generated the error message.
	Type *string `json:"type" validate:"required"`

	// The unique identifier of the action that generated the error message.
	Action *string `json:"action" validate:"required"`

	// The unique identifier of the step that generated the error message.
	Step *string `json:"step" validate:"required"`
}

type LogPagination struct {
	// The URL that will return the next page of results, if any.
	NextURL *string `json:"next_url,omitempty"`

	// Reserved for future use.
	Matched *int64 `json:"matched,omitempty"`

	// A token identifying the next page of results.
	NextCursor *string `json:"next_cursor,omitempty"`
}

type MessageContext struct {
	// Session context data that is shared by all skills used by the assistant.
	Global *MessageContextGlobal `json:"global,omitempty"`

	// Information specific to particular skills used by the assistant.
	//
	// **Note:** Currently, only a single child property is supported, containing variables that apply to the dialog skill
	// used by the assistant.
	Skills map[string]MessageContextSkill `json:"skills,omitempty"`

	// An object containing context data that is specific to particular integrations. For more information, see the
	// [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-dialog-integrations).
	Integrations interface{} `json:"integrations,omitempty"`
}

type MessageContextGlobal struct {
	// Built-in system properties that apply to all skills used by the assistant.
	System *MessageContextGlobalSystem `json:"system,omitempty"`

	// The session ID.
	SessionID *string `json:"session_id,omitempty"`
}

type MessageContextGlobalStateless struct {
	// Built-in system properties that apply to all skills used by the assistant.
	System *MessageContextGlobalSystem `json:"system,omitempty"`

	// The unique identifier of the session.
	SessionID *string `json:"session_id,omitempty"`
}

type MessageContextGlobalSystem struct {
	// The user time zone. The assistant uses the time zone to correctly resolve relative time references.
	Timezone *string `json:"timezone,omitempty"`

	// A string value that identifies the user who is interacting with the assistant. The client must provide a unique
	// identifier for each individual end user who accesses the application. For user-based plans, this user ID is used to
	// identify unique users for billing purposes. This string cannot contain carriage return, newline, or tab characters.
	// If no value is specified in the input, **user_id** is automatically set to the value of
	// **context.global.session_id**.
	//
	// **Note:** This property is the same as the **user_id** property at the root of the message body. If **user_id** is
	// specified in both locations in a message request, the value specified at the root is used.
	UserID *string `json:"user_id,omitempty"`

	// A counter that is automatically incremented with each turn of the conversation. A value of 1 indicates that this is
	// the the first turn of a new conversation, which can affect the behavior of some skills (for example, triggering the
	// start node of a dialog).
	TurnCount *int64 `json:"turn_count,omitempty"`

	// The language code for localization in the user input. The specified locale overrides the default for the assistant,
	// and is used for interpreting entity values in user input such as date values. For example, `04/03/2018` might be
	// interpreted either as April 3 or March 4, depending on the locale.
	//
	//  This property is included only if the new system entities are enabled for the skill.
	Locale *string `json:"locale,omitempty"`

	// The base time for interpreting any relative time mentions in the user input. The specified time overrides the
	// current server time, and is used to calculate times mentioned in relative terms such as `now` or `tomorrow`. This
	// can be useful for simulating past or future times for testing purposes, or when analyzing documents such as news
	// articles.
	//
	// This value must be a UTC time value formatted according to ISO 8601 (for example, `2021-06-26T12:00:00Z` for noon
	// UTC on 26 June 2021).
	//
	// This property is included only if the new system entities are enabled for the skill.
	ReferenceTime *string `json:"reference_time,omitempty"`

	// The time at which the session started. With the stateful `message` method, the start time is always present, and is
	// set by the service based on the time the session was created. With the stateless `message` method, the start time is
	// set by the service in the response to the first message, and should be returned as part of the context with each
	// subsequent message in the session.
	//
	// This value is a UTC time value formatted according to ISO 8601 (for example, `2021-06-26T12:00:00Z` for noon UTC on
	// 26 June 2021).
	SessionStartTime *string `json:"session_start_time,omitempty"`

	// An encoded string that represents the configuration state of the assistant at the beginning of the conversation. If
	// you are using the stateless `message` method, save this value and then send it in the context of the subsequent
	// message request to avoid disruptions if there are configuration changes during the conversation (such as a change to
	// a skill the assistant uses).
	State *string `json:"state,omitempty"`

	// For internal use only.
	SkipUserInput *bool `json:"skip_user_input,omitempty"`
}

type MessageContextSkill struct {
	// Arbitrary variables that can be read and written by a particular skill.
	UserDefined map[string]interface{} `json:"user_defined,omitempty"`

	// System context data used by the skill.
	System *MessageContextSkillSystem `json:"system,omitempty"`
}

type MessageContextSkillSystem struct {
	// An encoded string that represents the current conversation state. By saving this value and then sending it in the
	// context of a subsequent message request, you can return to an earlier point in the conversation. If you are using
	// stateful sessions, you can also use a stored state value to restore a paused conversation whose session is expired.
	State *string `json:"state,omitempty"`
	// contains filtered or unexported fields
}

type MessageContextStateless struct {
	// Session context data that is shared by all skills used by the assistant.
	Global *MessageContextGlobalStateless `json:"global,omitempty"`

	// Information specific to particular skills used by the assistant.
	//
	// **Note:** Currently, only a single child property is supported, containing variables that apply to the dialog skill
	// used by the assistant.
	Skills map[string]MessageContextSkill `json:"skills,omitempty"`

	// An object containing context data that is specific to particular integrations. For more information, see the
	// [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-dialog-integrations).
	Integrations interface{} `json:"integrations,omitempty"`
}

type MessageInput struct {
	// The type of the message:
	//
	// - `text`: The user input is processed normally by the assistant.
	// - `search`: Only search results are returned. (Any dialog or actions skill is bypassed.)
	//
	// **Note:** A `search` message results in an error if no search skill is configured for the assistant.
	MessageType *string `json:"message_type,omitempty"`

	// The text of the user input. This string cannot contain carriage return, newline, or tab characters.
	Text *string `json:"text,omitempty"`

	// Intents to use when evaluating the user input. Include intents from the previous response to continue using those
	// intents rather than trying to recognize intents in the new input.
	Intents []RuntimeIntent `json:"intents,omitempty"`

	// Entities to use when evaluating the message. Include entities from the previous response to continue using those
	// entities rather than detecting entities in the new input.
	Entities []RuntimeEntity `json:"entities,omitempty"`

	// For internal use only.
	SuggestionID *string `json:"suggestion_id,omitempty"`

	// An array of multimedia attachments to be sent with the message.
	//
	// **Note:** Attachments are not processed by the assistant itself, but can be sent to external services by webhooks.
	Attachments []MessageInputAttachment `json:"attachments,omitempty"`

	// Optional properties that control how the assistant responds.
	Options *MessageInputOptions `json:"options,omitempty"`
}

type MessageInputAttachment struct {
	// The URL of the media file.
	URL *string `json:"url" validate:"required"`

	// The media content type (such as a MIME type) of the attachment.
	MediaType *string `json:"media_type,omitempty"`
}

type MessageInputOptions struct {
	// Whether to restart dialog processing at the root of the dialog, regardless of any previously visited nodes.
	// **Note:** This does not affect `turn_count` or any other context variables.
	Restart *bool `json:"restart,omitempty"`

	// Whether to return more than one intent. Set to `true` to return all matching intents.
	AlternateIntents *bool `json:"alternate_intents,omitempty"`

	// Spelling correction options for the message. Any options specified on an individual message override the settings
	// configured for the skill.
	Spelling *MessageInputOptionsSpelling `json:"spelling,omitempty"`

	// Whether to return additional diagnostic information. Set to `true` to return additional information in the
	// `output.debug` property. If you also specify **return_context**=`true`, the returned skill context includes the
	// `system.state` property.
	Debug *bool `json:"debug,omitempty"`

	// Whether to return session context with the response. If you specify `true`, the response includes the `context`
	// property. If you also specify **debug**=`true`, the returned skill context includes the `system.state` property.
	ReturnContext *bool `json:"return_context,omitempty"`

	// Whether to return session context, including full conversation state. If you specify `true`, the response includes
	// the `context` property, and the skill context includes the `system.state` property.
	//
	// **Note:** If **export**=`true`, the context is returned regardless of the value of **return_context**.
	Export *bool `json:"export,omitempty"`
}

type MessageInputOptionsSpelling struct {
	// Whether to use spelling correction when processing the input. If spelling correction is used and **auto_correct** is
	// `true`, any spelling corrections are automatically applied to the user input. If **auto_correct** is `false`, any
	// suggested corrections are returned in the **output.spelling** property.
	//
	// This property overrides the value of the **spelling_suggestions** property in the workspace settings for the skill.
	Suggestions *bool `json:"suggestions,omitempty"`

	// Whether to use autocorrection when processing the input. If this property is `true`, any corrections are
	// automatically applied to the user input, and the original text is returned in the **output.spelling** property of
	// the message response. This property overrides the value of the **spelling_auto_correct** property in the workspace
	// settings for the skill.
	AutoCorrect *bool `json:"auto_correct,omitempty"`
}

type MessageInputOptionsStateless struct {
	// Whether to restart dialog processing at the root of the dialog, regardless of any previously visited nodes.
	// **Note:** This does not affect `turn_count` or any other context variables.
	Restart *bool `json:"restart,omitempty"`

	// Whether to return more than one intent. Set to `true` to return all matching intents.
	AlternateIntents *bool `json:"alternate_intents,omitempty"`

	// Spelling correction options for the message. Any options specified on an individual message override the settings
	// configured for the skill.
	Spelling *MessageInputOptionsSpelling `json:"spelling,omitempty"`

	// Whether to return additional diagnostic information. Set to `true` to return additional information in the
	// `output.debug` property.
	Debug *bool `json:"debug,omitempty"`
}

type MessageInputStateless struct {
	// The type of the message:
	//
	// - `text`: The user input is processed normally by the assistant.
	// - `search`: Only search results are returned. (Any dialog or actions skill is bypassed.)
	//
	// **Note:** A `search` message results in an error if no search skill is configured for the assistant.
	MessageType *string `json:"message_type,omitempty"`

	// The text of the user input. This string cannot contain carriage return, newline, or tab characters.
	Text *string `json:"text,omitempty"`

	// Intents to use when evaluating the user input. Include intents from the previous response to continue using those
	// intents rather than trying to recognize intents in the new input.
	Intents []RuntimeIntent `json:"intents,omitempty"`

	// Entities to use when evaluating the message. Include entities from the previous response to continue using those
	// entities rather than detecting entities in the new input.
	Entities []RuntimeEntity `json:"entities,omitempty"`

	// For internal use only.
	SuggestionID *string `json:"suggestion_id,omitempty"`

	// An array of multimedia attachments to be sent with the message.
	//
	// **Note:** Attachments are not processed by the assistant itself, but can be sent to external services by webhooks.
	Attachments []MessageInputAttachment `json:"attachments,omitempty"`

	// Optional properties that control how the assistant responds.
	Options *MessageInputOptionsStateless `json:"options,omitempty"`
}

type MessageOptions struct {
	// Unique identifier of the assistant. To find the assistant ID in the Watson Assistant user interface, open the
	// assistant settings and click **API Details**. For information about creating assistants, see the
	// [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-assistant-add#assistant-add-task).
	//
	// **Note:** Currently, the v2 API does not support creating assistants.
	AssistantID *string `json:"assistant_id" validate:"required,ne="`

	// Unique identifier of the session.
	SessionID *string `json:"session_id" validate:"required,ne="`

	// An input object that includes the input text.
	Input *MessageInput `json:"input,omitempty"`

	// Context data for the conversation. You can use this property to set or modify context variables, which can also be
	// accessed by dialog nodes. The context is stored by the assistant on a per-session basis.
	//
	// **Note:** The total size of the context data stored for a stateful session cannot exceed 100KB.
	Context *MessageContext `json:"context,omitempty"`

	// A string value that identifies the user who is interacting with the assistant. The client must provide a unique
	// identifier for each individual end user who accesses the application. For user-based plans, this user ID is used to
	// identify unique users for billing purposes. This string cannot contain carriage return, newline, or tab characters.
	// If no value is specified in the input, **user_id** is automatically set to the value of
	// **context.global.session_id**.
	//
	// **Note:** This property is the same as the **user_id** property in the global system context. If **user_id** is
	// specified in both locations, the value specified at the root is used.
	UserID *string `json:"user_id,omitempty"`

	// Allows users to set headers on API requests
	Headers map[string]string
}

type MessageOutput struct {
	// Output intended for any channel. It is the responsibility of the client application to implement the supported
	// response types.
	Generic []RuntimeResponseGenericIntf `json:"generic,omitempty"`

	// An array of intents recognized in the user input, sorted in descending order of confidence.
	Intents []RuntimeIntent `json:"intents,omitempty"`

	// An array of entities identified in the user input.
	Entities []RuntimeEntity `json:"entities,omitempty"`

	// An array of objects describing any actions requested by the dialog node.
	Actions []DialogNodeAction `json:"actions,omitempty"`

	// Additional detailed information about a message response and how it was generated.
	Debug *MessageOutputDebug `json:"debug,omitempty"`

	// An object containing any custom properties included in the response. This object includes any arbitrary properties
	// defined in the dialog JSON editor as part of the dialog node output.
	UserDefined map[string]interface{} `json:"user_defined,omitempty"`

	// Properties describing any spelling corrections in the user input that was received.
	Spelling *MessageOutputSpelling `json:"spelling,omitempty"`
}

type MessageOutputDebug struct {
	// An array of objects containing detailed diagnostic information about dialog nodes that were triggered during
	// processing of the input message.
	NodesVisited []DialogNodeVisited `json:"nodes_visited,omitempty"`

	// An array of up to 50 messages logged with the request.
	LogMessages []DialogLogMessage `json:"log_messages,omitempty"`

	// Assistant sets this to true when this message response concludes or interrupts a dialog.
	BranchExited *bool `json:"branch_exited,omitempty"`

	// When `branch_exited` is set to `true` by the assistant, the `branch_exited_reason` specifies whether the dialog
	// completed by itself or got interrupted.
	BranchExitedReason *string `json:"branch_exited_reason,omitempty"`
}

type MessageOutputSpelling struct {
	// The user input text that was used to generate the response. If spelling autocorrection is enabled, this text
	// reflects any spelling corrections that were applied.
	Text *string `json:"text,omitempty"`

	// The original user input text. This property is returned only if autocorrection is enabled and the user input was
	// corrected.
	OriginalText *string `json:"original_text,omitempty"`

	// Any suggested corrections of the input text. This property is returned only if spelling correction is enabled and
	// autocorrection is disabled.
	SuggestedText *string `json:"suggested_text,omitempty"`
}

type MessageRequest struct {
	// An input object that includes the input text.
	Input *MessageInput `json:"input,omitempty"`

	// Context data for the conversation. You can use this property to set or modify context variables, which can also be
	// accessed by dialog nodes. The context is stored by the assistant on a per-session basis.
	//
	// **Note:** The total size of the context data stored for a stateful session cannot exceed 100KB.
	Context *MessageContext `json:"context,omitempty"`

	// A string value that identifies the user who is interacting with the assistant. The client must provide a unique
	// identifier for each individual end user who accesses the application. For user-based plans, this user ID is used to
	// identify unique users for billing purposes. This string cannot contain carriage return, newline, or tab characters.
	// If no value is specified in the input, **user_id** is automatically set to the value of
	// **context.global.session_id**.
	//
	// **Note:** This property is the same as the **user_id** property in the global system context. If **user_id** is
	// specified in both locations, the value specified at the root is used.
	UserID *string `json:"user_id,omitempty"`
}

type MessageResponse struct {
	// Assistant output to be rendered or processed by the client.
	Output *MessageOutput `json:"output" validate:"required"`

	// Context data for the conversation. You can use this property to access context variables. The context is stored by
	// the assistant on a per-session basis.
	//
	// **Note:** The context is included in message responses only if **return_context**=`true` in the message request.
	// Full context is always included in logs.
	Context *MessageContext `json:"context,omitempty"`

	// A string value that identifies the user who is interacting with the assistant. The client must provide a unique
	// identifier for each individual end user who accesses the application. For user-based plans, this user ID is used to
	// identify unique users for billing purposes. This string cannot contain carriage return, newline, or tab characters.
	// If no value is specified in the input, **user_id** is automatically set to the value of
	// **context.global.session_id**.
	//
	// **Note:** This property is the same as the **user_id** property in the global system context.
	UserID *string `json:"user_id" validate:"required"`
}

type MessageResponseStateless struct {
	// Assistant output to be rendered or processed by the client.
	Output *MessageOutput `json:"output" validate:"required"`

	// Context data for the conversation. You can use this property to access context variables. The context is not stored
	// by the assistant; to maintain session state, include the context from the response in the next message.
	Context *MessageContextStateless `json:"context" validate:"required"`

	// A string value that identifies the user who is interacting with the assistant. The client must provide a unique
	// identifier for each individual end user who accesses the application. For user-based plans, this user ID is used to
	// identify unique users for billing purposes. This string cannot contain carriage return, newline, or tab characters.
	// If no value is specified in the input, **user_id** is automatically set to the value of
	// **context.global.session_id**.
	//
	// **Note:** This property is the same as the **user_id** property in the global system context.
	UserID *string `json:"user_id,omitempty"`
}

type MessageStatelessOptions struct {
	// Unique identifier of the assistant. To find the assistant ID in the Watson Assistant user interface, open the
	// assistant settings and click **API Details**. For information about creating assistants, see the
	// [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-assistant-add#assistant-add-task).
	//
	// **Note:** Currently, the v2 API does not support creating assistants.
	AssistantID *string `json:"assistant_id" validate:"required,ne="`

	// An input object that includes the input text.
	Input *MessageInputStateless `json:"input,omitempty"`

	// Context data for the conversation. You can use this property to set or modify context variables, which can also be
	// accessed by dialog nodes. The context is not stored by the assistant. To maintain session state, include the context
	// from the previous response.
	//
	// **Note:** The total size of the context data for a stateless session cannot exceed 250KB.
	Context *MessageContextStateless `json:"context,omitempty"`

	// A string value that identifies the user who is interacting with the assistant. The client must provide a unique
	// identifier for each individual end user who accesses the application. For user-based plans, this user ID is used to
	// identify unique users for billing purposes. This string cannot contain carriage return, newline, or tab characters.
	// If no value is specified in the input, **user_id** is automatically set to the value of
	// **context.global.session_id**.
	//
	// **Note:** This property is the same as the **user_id** property in the global system context. If **user_id** is
	// specified in both locations in a message request, the value specified at the root is used.
	UserID *string `json:"user_id,omitempty"`

	// Allows users to set headers on API requests
	Headers map[string]string
}

type ResponseGenericChannel struct {
	// A channel for which the response is intended.
	Channel *string `json:"channel,omitempty"`
}

type RuntimeEntity struct {
	// An entity detected in the input.
	Entity *string `json:"entity" validate:"required"`

	// An array of zero-based character offsets that indicate where the detected entity values begin and end in the input
	// text.
	Location []int64 `json:"location,omitempty"`

	// The term in the input text that was recognized as an entity value.
	Value *string `json:"value" validate:"required"`

	// A decimal percentage that represents Watson's confidence in the recognized entity.
	Confidence *float64 `json:"confidence,omitempty"`

	// The recognized capture groups for the entity, as defined by the entity pattern.
	Groups []CaptureGroup `json:"groups,omitempty"`

	// An object containing detailed information about the entity recognized in the user input. This property is included
	// only if the new system entities are enabled for the skill.
	//
	// For more information about how the new system entities are interpreted, see the
	// [documentation](https://cloud.ibm.com/docs/assistant?topic=assistant-beta-system-entities).
	Interpretation *RuntimeEntityInterpretation `json:"interpretation,omitempty"`

	// An array of possible alternative values that the user might have intended instead of the value returned in the
	// **value** property. This property is returned only for `@sys-time` and `@sys-date` entities when the user's input is
	// ambiguous.
	//
	// This property is included only if the new system entities are enabled for the skill.
	Alternatives []RuntimeEntityAlternative `json:"alternatives,omitempty"`

	// An object describing the role played by a system entity that is specifies the beginning or end of a range recognized
	// in the user input. This property is included only if the new system entities are enabled for the skill.
	Role *RuntimeEntityRole `json:"role,omitempty"`
}

type RuntimeEntityAlternative struct {
	// The entity value that was recognized in the user input.
	Value *string `json:"value,omitempty"`

	// A decimal percentage that represents Watson's confidence in the recognized entity.
	Confidence *float64 `json:"confidence,omitempty"`
}

type RuntimeEntityInterpretation struct {
	// The calendar used to represent a recognized date (for example, `Gregorian`).
	CalendarType *string `json:"calendar_type,omitempty"`

	// A unique identifier used to associate a recognized time and date. If the user input contains a date and time that
	// are mentioned together (for example, `Today at 5`, the same **datetime_link** value is returned for both the
	// `@sys-date` and `@sys-time` entities).
	DatetimeLink *string `json:"datetime_link,omitempty"`

	// A locale-specific holiday name (such as `thanksgiving` or `christmas`). This property is included when a `@sys-date`
	// entity is recognized based on a holiday name in the user input.
	Festival *string `json:"festival,omitempty"`

	// The precision or duration of a time range specified by a recognized `@sys-time` or `@sys-date` entity.
	Granularity *string `json:"granularity,omitempty"`

	// A unique identifier used to associate multiple recognized `@sys-date`, `@sys-time`, or `@sys-number` entities that
	// are recognized as a range of values in the user's input (for example, `from July 4 until July 14` or `from 20 to
	// 25`).
	RangeLink *string `json:"range_link,omitempty"`

	// The word in the user input that indicates that a `sys-date` or `sys-time` entity is part of an implied range where
	// only one date or time is specified (for example, `since` or `until`).
	RangeModifier *string `json:"range_modifier,omitempty"`

	// A recognized mention of a relative day, represented numerically as an offset from the current date (for example,
	// `-1` for `yesterday` or `10` for `in ten days`).
	RelativeDay *float64 `json:"relative_day,omitempty"`

	// A recognized mention of a relative month, represented numerically as an offset from the current month (for example,
	// `1` for `next month` or `-3` for `three months ago`).
	RelativeMonth *float64 `json:"relative_month,omitempty"`

	// A recognized mention of a relative week, represented numerically as an offset from the current week (for example,
	// `2` for `in two weeks` or `-1` for `last week).
	RelativeWeek *float64 `json:"relative_week,omitempty"`

	// A recognized mention of a relative date range for a weekend, represented numerically as an offset from the current
	// weekend (for example, `0` for `this weekend` or `-1` for `last weekend`).
	RelativeWeekend *float64 `json:"relative_weekend,omitempty"`

	// A recognized mention of a relative year, represented numerically as an offset from the current year (for example,
	// `1` for `next year` or `-5` for `five years ago`).
	RelativeYear *float64 `json:"relative_year,omitempty"`

	// A recognized mention of a specific date, represented numerically as the date within the month (for example, `30` for
	// `June 30`.).
	SpecificDay *float64 `json:"specific_day,omitempty"`

	// A recognized mention of a specific day of the week as a lowercase string (for example, `monday`).
	SpecificDayOfWeek *string `json:"specific_day_of_week,omitempty"`

	// A recognized mention of a specific month, represented numerically (for example, `7` for `July`).
	SpecificMonth *float64 `json:"specific_month,omitempty"`

	// A recognized mention of a specific quarter, represented numerically (for example, `3` for `the third quarter`).
	SpecificQuarter *float64 `json:"specific_quarter,omitempty"`

	// A recognized mention of a specific year (for example, `2016`).
	SpecificYear *float64 `json:"specific_year,omitempty"`

	// A recognized numeric value, represented as an integer or double.
	NumericValue *float64 `json:"numeric_value,omitempty"`

	// The type of numeric value recognized in the user input (`integer` or `rational`).
	Subtype *string `json:"subtype,omitempty"`

	// A recognized term for a time that was mentioned as a part of the day in the user's input (for example, `morning` or
	// `afternoon`).
	PartOfDay *string `json:"part_of_day,omitempty"`

	// A recognized mention of a relative hour, represented numerically as an offset from the current hour (for example,
	// `3` for `in three hours` or `-1` for `an hour ago`).
	RelativeHour *float64 `json:"relative_hour,omitempty"`

	// A recognized mention of a relative time, represented numerically as an offset in minutes from the current time (for
	// example, `5` for `in five minutes` or `-15` for `fifteen minutes ago`).
	RelativeMinute *float64 `json:"relative_minute,omitempty"`

	// A recognized mention of a relative time, represented numerically as an offset in seconds from the current time (for
	// example, `10` for `in ten seconds` or `-30` for `thirty seconds ago`).
	RelativeSecond *float64 `json:"relative_second,omitempty"`

	// A recognized specific hour mentioned as part of a time value (for example, `10` for `10:15 AM`.).
	SpecificHour *float64 `json:"specific_hour,omitempty"`

	// A recognized specific minute mentioned as part of a time value (for example, `15` for `10:15 AM`.).
	SpecificMinute *float64 `json:"specific_minute,omitempty"`

	// A recognized specific second mentioned as part of a time value (for example, `30` for `10:15:30 AM`.).
	SpecificSecond *float64 `json:"specific_second,omitempty"`

	// A recognized time zone mentioned as part of a time value (for example, `EST`).
	Timezone *string `json:"timezone,omitempty"`
}

type RuntimeEntityRole struct {
	// The relationship of the entity to the range.
	Type *string `json:"type,omitempty"`
}

type RuntimeIntent struct {
	// The name of the recognized intent.
	Intent *string `json:"intent" validate:"required"`

	// A decimal percentage that represents Watson's confidence in the intent.
	Confidence *float64 `json:"confidence" validate:"required"`
}

type RuntimeResponseGeneric struct {
	// The type of response returned by the dialog node. The specified response type must be supported by the client
	// application or channel.
	ResponseType *string `json:"response_type,omitempty"`

	// The text of the response.
	Text *string `json:"text,omitempty"`

	// An array of objects specifying channels for which the response is intended. If **channels** is present, the response
	// is intended for a built-in integration and should not be handled by an API client.
	Channels []ResponseGenericChannel `json:"channels,omitempty"`

	// How long to pause, in milliseconds.
	Time *int64 `json:"time,omitempty"`

	// Whether to send a "user is typing" event during the pause.
	Typing *bool `json:"typing,omitempty"`

	// The `https:` URL of the image.
	Source *string `json:"source,omitempty"`

	// The title to show before the response.
	Title *string `json:"title,omitempty"`

	// The description to show with the the response.
	Description *string `json:"description,omitempty"`

	// Descriptive text that can be used for screen readers or other situations where the image cannot be seen.
	AltText *string `json:"alt_text,omitempty"`

	// The preferred type of control to display.
	Preference *string `json:"preference,omitempty"`

	// An array of objects describing the options from which the user can choose.
	Options []DialogNodeOutputOptionsElement `json:"options,omitempty"`

	// A message to be sent to the human agent who will be taking over the conversation.
	MessageToHumanAgent *string `json:"message_to_human_agent,omitempty"`

	// An optional message to be displayed to the user to indicate that the conversation will be transferred to the next
	// available agent.
	AgentAvailable *AgentAvailabilityMessage `json:"agent_available,omitempty"`

	// An optional message to be displayed to the user to indicate that no online agent is available to take over the
	// conversation.
	AgentUnavailable *AgentAvailabilityMessage `json:"agent_unavailable,omitempty"`

	// Routing or other contextual information to be used by target service desk systems.
	TransferInfo *DialogNodeOutputConnectToAgentTransferInfo `json:"transfer_info,omitempty"`

	// A label identifying the topic of the conversation, derived from the **title** property of the relevant node or the
	// **topic** property of the dialog node response.
	Topic *string `json:"topic,omitempty"`

	// An array of objects describing the possible matching dialog nodes from which the user can choose.
	Suggestions []DialogSuggestion `json:"suggestions,omitempty"`

	// The message to display to the user when initiating a channel transfer.
	MessageToUser *string `json:"message_to_user,omitempty"`

	// The title or introductory text to show before the response. This text is defined in the search skill configuration.
	Header *string `json:"header,omitempty"`

	// An array of objects that contains the search results to be displayed in the initial response to the user.
	PrimaryResults []SearchResult `json:"primary_results,omitempty"`

	// An array of objects that contains additional search results that can be displayed to the user upon request.
	AdditionalResults []SearchResult `json:"additional_results,omitempty"`

	// An object containing any properties for the user-defined response type.
	UserDefined map[string]interface{} `json:"user_defined,omitempty"`

	// For internal use only.
	ChannelOptions interface{} `json:"channel_options,omitempty"`

	// The URL of an image that shows a preview of the embedded content.
	ImageURL *string `json:"image_url,omitempty"`
}

type RuntimeResponseGenericIntf interface {
	// contains filtered or unexported methods
}

type RuntimeResponseGenericRuntimeResponseTypeAudio struct {
	// The type of response returned by the dialog node. The specified response type must be supported by the client
	// application or channel.
	ResponseType *string `json:"response_type" validate:"required"`

	// The `https:` URL of the audio clip.
	Source *string `json:"source" validate:"required"`

	// The title or introductory text to show before the response.
	Title *string `json:"title,omitempty"`

	// The description to show with the the response.
	Description *string `json:"description,omitempty"`

	// An array of objects specifying channels for which the response is intended. If **channels** is present, the response
	// is intended for a built-in integration and should not be handled by an API client.
	Channels []ResponseGenericChannel `json:"channels,omitempty"`

	// For internal use only.
	ChannelOptions interface{} `json:"channel_options,omitempty"`

	// Descriptive text that can be used for screen readers or other situations where the audio player cannot be seen.
	AltText *string `json:"alt_text,omitempty"`
}

type RuntimeResponseGenericRuntimeResponseTypeChannelTransfer struct {
	// The type of response returned by the dialog node. The specified response type must be supported by the client
	// application or channel.
	ResponseType *string `json:"response_type" validate:"required"`

	// The message to display to the user when initiating a channel transfer.
	MessageToUser *string `json:"message_to_user" validate:"required"`

	// Information used by an integration to transfer the conversation to a different channel.
	TransferInfo *ChannelTransferInfo `json:"transfer_info" validate:"required"`

	// An array of objects specifying channels for which the response is intended. If **channels** is present, the response
	// is intended for a built-in integration and should not be handled by an API client.
	Channels []ResponseGenericChannel `json:"channels,omitempty"`
}

type RuntimeResponseGenericRuntimeResponseTypeConnectToAgent struct {
	// The type of response returned by the dialog node. The specified response type must be supported by the client
	// application or channel.
	ResponseType *string `json:"response_type" validate:"required"`

	// A message to be sent to the human agent who will be taking over the conversation.
	MessageToHumanAgent *string `json:"message_to_human_agent,omitempty"`

	// An optional message to be displayed to the user to indicate that the conversation will be transferred to the next
	// available agent.
	AgentAvailable *AgentAvailabilityMessage `json:"agent_available,omitempty"`

	// An optional message to be displayed to the user to indicate that no online agent is available to take over the
	// conversation.
	AgentUnavailable *AgentAvailabilityMessage `json:"agent_unavailable,omitempty"`

	// Routing or other contextual information to be used by target service desk systems.
	TransferInfo *DialogNodeOutputConnectToAgentTransferInfo `json:"transfer_info,omitempty"`

	// A label identifying the topic of the conversation, derived from the **title** property of the relevant node or the
	// **topic** property of the dialog node response.
	Topic *string `json:"topic,omitempty"`

	// An array of objects specifying channels for which the response is intended. If **channels** is present, the response
	// is intended for a built-in integration and should not be handled by an API client.
	Channels []ResponseGenericChannel `json:"channels,omitempty"`
}

type RuntimeResponseGenericRuntimeResponseTypeIframe struct {
	// The type of response returned by the dialog node. The specified response type must be supported by the client
	// application or channel.
	ResponseType *string `json:"response_type" validate:"required"`

	// The `https:` URL of the embeddable content.
	Source *string `json:"source" validate:"required"`

	// The title or introductory text to show before the response.
	Title *string `json:"title,omitempty"`

	// The description to show with the the response.
	Description *string `json:"description,omitempty"`

	// The URL of an image that shows a preview of the embedded content.
	ImageURL *string `json:"image_url,omitempty"`

	// An array of objects specifying channels for which the response is intended. If **channels** is present, the response
	// is intended for a built-in integration and should not be handled by an API client.
	Channels []ResponseGenericChannel `json:"channels,omitempty"`
}

type RuntimeResponseGenericRuntimeResponseTypeImage struct {
	// The type of response returned by the dialog node. The specified response type must be supported by the client
	// application or channel.
	ResponseType *string `json:"response_type" validate:"required"`

	// The `https:` URL of the image.
	Source *string `json:"source" validate:"required"`

	// The title to show before the response.
	Title *string `json:"title,omitempty"`

	// The description to show with the the response.
	Description *string `json:"description,omitempty"`

	// An array of objects specifying channels for which the response is intended. If **channels** is present, the response
	// is intended for a built-in integration and should not be handled by an API client.
	Channels []ResponseGenericChannel `json:"channels,omitempty"`

	// Descriptive text that can be used for screen readers or other situations where the image cannot be seen.
	AltText *string `json:"alt_text,omitempty"`
}

type RuntimeResponseGenericRuntimeResponseTypeOption struct {
	// The type of response returned by the dialog node. The specified response type must be supported by the client
	// application or channel.
	ResponseType *string `json:"response_type" validate:"required"`

	// The title or introductory text to show before the response.
	Title *string `json:"title" validate:"required"`

	// The description to show with the the response.
	Description *string `json:"description,omitempty"`

	// The preferred type of control to display.
	Preference *string `json:"preference,omitempty"`

	// An array of objects describing the options from which the user can choose.
	Options []DialogNodeOutputOptionsElement `json:"options" validate:"required"`

	// An array of objects specifying channels for which the response is intended. If **channels** is present, the response
	// is intended for a built-in integration and should not be handled by an API client.
	Channels []ResponseGenericChannel `json:"channels,omitempty"`
}

type RuntimeResponseGenericRuntimeResponseTypePause struct {
	// The type of response returned by the dialog node. The specified response type must be supported by the client
	// application or channel.
	ResponseType *string `json:"response_type" validate:"required"`

	// How long to pause, in milliseconds.
	Time *int64 `json:"time" validate:"required"`

	// Whether to send a "user is typing" event during the pause.
	Typing *bool `json:"typing,omitempty"`

	// An array of objects specifying channels for which the response is intended. If **channels** is present, the response
	// is intended for a built-in integration and should not be handled by an API client.
	Channels []ResponseGenericChannel `json:"channels,omitempty"`
}

type RuntimeResponseGenericRuntimeResponseTypeSearch struct {
	// The type of response returned by the dialog node. The specified response type must be supported by the client
	// application or channel.
	ResponseType *string `json:"response_type" validate:"required"`

	// The title or introductory text to show before the response. This text is defined in the search skill configuration.
	Header *string `json:"header" validate:"required"`

	// An array of objects that contains the search results to be displayed in the initial response to the user.
	PrimaryResults []SearchResult `json:"primary_results" validate:"required"`

	// An array of objects that contains additional search results that can be displayed to the user upon request.
	AdditionalResults []SearchResult `json:"additional_results" validate:"required"`

	// An array of objects specifying channels for which the response is intended. If **channels** is present, the response
	// is intended for a built-in integration and should not be handled by an API client.
	Channels []ResponseGenericChannel `json:"channels,omitempty"`
}

type RuntimeResponseGenericRuntimeResponseTypeSuggestion struct {
	// The type of response returned by the dialog node. The specified response type must be supported by the client
	// application or channel.
	ResponseType *string `json:"response_type" validate:"required"`

	// The title or introductory text to show before the response.
	Title *string `json:"title" validate:"required"`

	// An array of objects describing the possible matching dialog nodes from which the user can choose.
	Suggestions []DialogSuggestion `json:"suggestions" validate:"required"`

	// An array of objects specifying channels for which the response is intended. If **channels** is present, the response
	// is intended for a built-in integration and should not be handled by an API client.
	Channels []ResponseGenericChannel `json:"channels,omitempty"`
}

type RuntimeResponseGenericRuntimeResponseTypeText struct {
	// The type of response returned by the dialog node. The specified response type must be supported by the client
	// application or channel.
	ResponseType *string `json:"response_type" validate:"required"`

	// The text of the response.
	Text *string `json:"text" validate:"required"`

	// An array of objects specifying channels for which the response is intended. If **channels** is present, the response
	// is intended for a built-in integration and should not be handled by an API client.
	Channels []ResponseGenericChannel `json:"channels,omitempty"`
}

type RuntimeResponseGenericRuntimeResponseTypeUserDefined struct {
	// The type of response returned by the dialog node. The specified response type must be supported by the client
	// application or channel.
	ResponseType *string `json:"response_type" validate:"required"`

	// An object containing any properties for the user-defined response type.
	UserDefined map[string]interface{} `json:"user_defined" validate:"required"`

	// An array of objects specifying channels for which the response is intended. If **channels** is present, the response
	// is intended for a built-in integration and should not be handled by an API client.
	Channels []ResponseGenericChannel `json:"channels,omitempty"`
}

type RuntimeResponseGenericRuntimeResponseTypeVideo struct {
	// The type of response returned by the dialog node. The specified response type must be supported by the client
	// application or channel.
	ResponseType *string `json:"response_type" validate:"required"`

	// The `https:` URL of the video.
	Source *string `json:"source" validate:"required"`

	// The title or introductory text to show before the response.
	Title *string `json:"title,omitempty"`

	// The description to show with the the response.
	Description *string `json:"description,omitempty"`

	// An array of objects specifying channels for which the response is intended. If **channels** is present, the response
	// is intended for a built-in integration and should not be handled by an API client.
	Channels []ResponseGenericChannel `json:"channels,omitempty"`

	// For internal use only.
	ChannelOptions interface{} `json:"channel_options,omitempty"`

	// Descriptive text that can be used for screen readers or other situations where the video cannot be seen.
	AltText *string `json:"alt_text,omitempty"`
}

type SearchResult struct {
	// The unique identifier of the document in the Discovery service collection.
	//
	// This property is included in responses from search skills, which are available only to Plus or Enterprise plan
	// users.
	ID *string `json:"id" validate:"required"`

	// An object containing search result metadata from the Discovery service.
	ResultMetadata *SearchResultMetadata `json:"result_metadata" validate:"required"`

	// A description of the search result. This is taken from an abstract, summary, or highlight field in the Discovery
	// service response, as specified in the search skill configuration.
	Body *string `json:"body,omitempty"`

	// The title of the search result. This is taken from a title or name field in the Discovery service response, as
	// specified in the search skill configuration.
	Title *string `json:"title,omitempty"`

	// The URL of the original data object in its native data source.
	URL *string `json:"url,omitempty"`

	// An object containing segments of text from search results with query-matching text highlighted using HTML `<em>`
	// tags.
	Highlight *SearchResultHighlight `json:"highlight,omitempty"`

	// An array specifying segments of text within the result that were identified as direct answers to the search query.
	// Currently, only the single answer with the highest confidence (if any) is returned.
	//
	// **Note:** This property uses the answer finding beta feature, and is available only if the search skill is connected
	// to a Discovery v2 service instance.
	Answers []SearchResultAnswer `json:"answers,omitempty"`
}

type SearchResultAnswer struct {
	// The text of the answer.
	Text *string `json:"text" validate:"required"`

	// The confidence score for the answer, as returned by the Discovery service.
	Confidence *float64 `json:"confidence" validate:"required"`
}

type SearchResultHighlight struct {
	// An array of strings containing segments taken from body text in the search results, with query-matching substrings
	// highlighted.
	Body []string `json:"body,omitempty"`

	// An array of strings containing segments taken from title text in the search results, with query-matching substrings
	// highlighted.
	Title []string `json:"title,omitempty"`

	// An array of strings containing segments taken from URLs in the search results, with query-matching substrings
	// highlighted.
	URL []string `json:"url,omitempty"`
	// contains filtered or unexported fields
}

type SearchResultMetadata struct {
	// The confidence score for the given result, as returned by the Discovery service.
	Confidence *float64 `json:"confidence,omitempty"`

	// An unbounded measure of the relevance of a particular result, dependent on the query and matching document. A higher
	// score indicates a greater match to the query parameters.
	Score *float64 `json:"score,omitempty"`
}

type SessionResponse struct {
	// The session ID.
	SessionID *string `json:"session_id" validate:"required"`
}