Class Fulfillment (0.52.0)

public final class Fulfillment extends GeneratedMessageV3 implements FulfillmentOrBuilder

A fulfillment can do one or more of the following actions at the same time:

  • Generate rich message responses.
  • Set parameter values.
  • Call the webhook.

    Fulfillments can be called at various stages in the Page or Form lifecycle. For example, when a DetectIntentRequest drives a session to enter a new page, the page's entry fulfillment can add a static response to the QueryResult in the returning DetectIntentResponse, call the webhook (for example, to load user data from a database), or both.

Protobuf type google.cloud.dialogflow.cx.v3beta1.Fulfillment

Static Fields

ADVANCED_SETTINGS_FIELD_NUMBER

public static final int ADVANCED_SETTINGS_FIELD_NUMBER
Field Value
TypeDescription
int

CONDITIONAL_CASES_FIELD_NUMBER

public static final int CONDITIONAL_CASES_FIELD_NUMBER
Field Value
TypeDescription
int

ENABLE_GENERATIVE_FALLBACK_FIELD_NUMBER

public static final int ENABLE_GENERATIVE_FALLBACK_FIELD_NUMBER
Field Value
TypeDescription
int

MESSAGES_FIELD_NUMBER

public static final int MESSAGES_FIELD_NUMBER
Field Value
TypeDescription
int

RETURN_PARTIAL_RESPONSES_FIELD_NUMBER

public static final int RETURN_PARTIAL_RESPONSES_FIELD_NUMBER
Field Value
TypeDescription
int

SET_PARAMETER_ACTIONS_FIELD_NUMBER

public static final int SET_PARAMETER_ACTIONS_FIELD_NUMBER
Field Value
TypeDescription
int

TAG_FIELD_NUMBER

public static final int TAG_FIELD_NUMBER
Field Value
TypeDescription
int

WEBHOOK_FIELD_NUMBER

public static final int WEBHOOK_FIELD_NUMBER
Field Value
TypeDescription
int

Static Methods

getDefaultInstance()

public static Fulfillment getDefaultInstance()
Returns
TypeDescription
Fulfillment

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

newBuilder()

public static Fulfillment.Builder newBuilder()
Returns
TypeDescription
Fulfillment.Builder

newBuilder(Fulfillment prototype)

public static Fulfillment.Builder newBuilder(Fulfillment prototype)
Parameter
NameDescription
prototypeFulfillment
Returns
TypeDescription
Fulfillment.Builder

parseDelimitedFrom(InputStream input)

public static Fulfillment parseDelimitedFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
Fulfillment
Exceptions
TypeDescription
IOException

parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static Fulfillment parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Fulfillment
Exceptions
TypeDescription
IOException

parseFrom(byte[] data)

public static Fulfillment parseFrom(byte[] data)
Parameter
NameDescription
databyte[]
Returns
TypeDescription
Fulfillment
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)

public static Fulfillment parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
databyte[]
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Fulfillment
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data)

public static Fulfillment parseFrom(ByteString data)
Parameter
NameDescription
dataByteString
Returns
TypeDescription
Fulfillment
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)

public static Fulfillment parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteString
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Fulfillment
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(CodedInputStream input)

public static Fulfillment parseFrom(CodedInputStream input)
Parameter
NameDescription
inputCodedInputStream
Returns
TypeDescription
Fulfillment
Exceptions
TypeDescription
IOException

parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public static Fulfillment parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Fulfillment
Exceptions
TypeDescription
IOException

parseFrom(InputStream input)

public static Fulfillment parseFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
Fulfillment
Exceptions
TypeDescription
IOException

parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static Fulfillment parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Fulfillment
Exceptions
TypeDescription
IOException

parseFrom(ByteBuffer data)

public static Fulfillment parseFrom(ByteBuffer data)
Parameter
NameDescription
dataByteBuffer
Returns
TypeDescription
Fulfillment
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)

public static Fulfillment parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteBuffer
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
Fulfillment
Exceptions
TypeDescription
InvalidProtocolBufferException

parser()

public static Parser<Fulfillment> parser()
Returns
TypeDescription
Parser<Fulfillment>

Methods

equals(Object obj)

public boolean equals(Object obj)
Parameter
NameDescription
objObject
Returns
TypeDescription
boolean
Overrides

getAdvancedSettings()

public AdvancedSettings getAdvancedSettings()

Hierarchical advanced settings for this fulfillment. The settings exposed at the lower level overrides the settings exposed at the higher level.

.google.cloud.dialogflow.cx.v3beta1.AdvancedSettings advanced_settings = 7;

Returns
TypeDescription
AdvancedSettings

The advancedSettings.

getAdvancedSettingsOrBuilder()

public AdvancedSettingsOrBuilder getAdvancedSettingsOrBuilder()

Hierarchical advanced settings for this fulfillment. The settings exposed at the lower level overrides the settings exposed at the higher level.

.google.cloud.dialogflow.cx.v3beta1.AdvancedSettings advanced_settings = 7;

Returns
TypeDescription
AdvancedSettingsOrBuilder

getConditionalCases(int index)

public Fulfillment.ConditionalCases getConditionalCases(int index)

Conditional cases for this fulfillment.

repeated .google.cloud.dialogflow.cx.v3beta1.Fulfillment.ConditionalCases conditional_cases = 5;

Parameter
NameDescription
indexint
Returns
TypeDescription
Fulfillment.ConditionalCases

getConditionalCasesCount()

public int getConditionalCasesCount()

Conditional cases for this fulfillment.

repeated .google.cloud.dialogflow.cx.v3beta1.Fulfillment.ConditionalCases conditional_cases = 5;

Returns
TypeDescription
int

getConditionalCasesList()

public List<Fulfillment.ConditionalCases> getConditionalCasesList()

Conditional cases for this fulfillment.

repeated .google.cloud.dialogflow.cx.v3beta1.Fulfillment.ConditionalCases conditional_cases = 5;

Returns
TypeDescription
List<ConditionalCases>

getConditionalCasesOrBuilder(int index)

public Fulfillment.ConditionalCasesOrBuilder getConditionalCasesOrBuilder(int index)

Conditional cases for this fulfillment.

repeated .google.cloud.dialogflow.cx.v3beta1.Fulfillment.ConditionalCases conditional_cases = 5;

Parameter
NameDescription
indexint
Returns
TypeDescription
Fulfillment.ConditionalCasesOrBuilder

getConditionalCasesOrBuilderList()

public List<? extends Fulfillment.ConditionalCasesOrBuilder> getConditionalCasesOrBuilderList()

Conditional cases for this fulfillment.

repeated .google.cloud.dialogflow.cx.v3beta1.Fulfillment.ConditionalCases conditional_cases = 5;

Returns
TypeDescription
List<? extends com.google.cloud.dialogflow.cx.v3beta1.Fulfillment.ConditionalCasesOrBuilder>

getDefaultInstanceForType()

public Fulfillment getDefaultInstanceForType()
Returns
TypeDescription
Fulfillment

getEnableGenerativeFallback()

public boolean getEnableGenerativeFallback()

If the flag is true, the agent will utilize LLM to generate a text response. If LLM generation fails, the defined responses in the fulfillment will be respected. This flag is only useful for fulfillments associated with no-match event handlers.

bool enable_generative_fallback = 12;

Returns
TypeDescription
boolean

The enableGenerativeFallback.

getMessages(int index)

public ResponseMessage getMessages(int index)

The list of rich message responses to present to the user.

repeated .google.cloud.dialogflow.cx.v3beta1.ResponseMessage messages = 1;

Parameter
NameDescription
indexint
Returns
TypeDescription
ResponseMessage

getMessagesCount()

public int getMessagesCount()

The list of rich message responses to present to the user.

repeated .google.cloud.dialogflow.cx.v3beta1.ResponseMessage messages = 1;

Returns
TypeDescription
int

getMessagesList()

public List<ResponseMessage> getMessagesList()

The list of rich message responses to present to the user.

repeated .google.cloud.dialogflow.cx.v3beta1.ResponseMessage messages = 1;

Returns
TypeDescription
List<ResponseMessage>

getMessagesOrBuilder(int index)

public ResponseMessageOrBuilder getMessagesOrBuilder(int index)

The list of rich message responses to present to the user.

repeated .google.cloud.dialogflow.cx.v3beta1.ResponseMessage messages = 1;

Parameter
NameDescription
indexint
Returns
TypeDescription
ResponseMessageOrBuilder

getMessagesOrBuilderList()

public List<? extends ResponseMessageOrBuilder> getMessagesOrBuilderList()

The list of rich message responses to present to the user.

repeated .google.cloud.dialogflow.cx.v3beta1.ResponseMessage messages = 1;

Returns
TypeDescription
List<? extends com.google.cloud.dialogflow.cx.v3beta1.ResponseMessageOrBuilder>

getParserForType()

public Parser<Fulfillment> getParserForType()
Returns
TypeDescription
Parser<Fulfillment>
Overrides

getReturnPartialResponses()

public boolean getReturnPartialResponses()

Whether Dialogflow should return currently queued fulfillment response messages in streaming APIs. If a webhook is specified, it happens before Dialogflow invokes webhook. Warning: 1) This flag only affects streaming API. Responses are still queued and returned once in non-streaming API. 2) The flag can be enabled in any fulfillment but only the first 3 partial responses will be returned. You may only want to apply it to fulfillments that have slow webhooks.

bool return_partial_responses = 8;

Returns
TypeDescription
boolean

The returnPartialResponses.

getSerializedSize()

public int getSerializedSize()
Returns
TypeDescription
int
Overrides

getSetParameterActions(int index)

public Fulfillment.SetParameterAction getSetParameterActions(int index)

Set parameter values before executing the webhook.

repeated .google.cloud.dialogflow.cx.v3beta1.Fulfillment.SetParameterAction set_parameter_actions = 4;

Parameter
NameDescription
indexint
Returns
TypeDescription
Fulfillment.SetParameterAction

getSetParameterActionsCount()

public int getSetParameterActionsCount()

Set parameter values before executing the webhook.

repeated .google.cloud.dialogflow.cx.v3beta1.Fulfillment.SetParameterAction set_parameter_actions = 4;

Returns
TypeDescription
int

getSetParameterActionsList()

public List<Fulfillment.SetParameterAction> getSetParameterActionsList()

Set parameter values before executing the webhook.

repeated .google.cloud.dialogflow.cx.v3beta1.Fulfillment.SetParameterAction set_parameter_actions = 4;

Returns
TypeDescription
List<SetParameterAction>

getSetParameterActionsOrBuilder(int index)

public Fulfillment.SetParameterActionOrBuilder getSetParameterActionsOrBuilder(int index)

Set parameter values before executing the webhook.

repeated .google.cloud.dialogflow.cx.v3beta1.Fulfillment.SetParameterAction set_parameter_actions = 4;

Parameter
NameDescription
indexint
Returns
TypeDescription
Fulfillment.SetParameterActionOrBuilder

getSetParameterActionsOrBuilderList()

public List<? extends Fulfillment.SetParameterActionOrBuilder> getSetParameterActionsOrBuilderList()

Set parameter values before executing the webhook.

repeated .google.cloud.dialogflow.cx.v3beta1.Fulfillment.SetParameterAction set_parameter_actions = 4;

Returns
TypeDescription
List<? extends com.google.cloud.dialogflow.cx.v3beta1.Fulfillment.SetParameterActionOrBuilder>

getTag()

public String getTag()

The value of this field will be populated in the WebhookRequest fulfillmentInfo.tag field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes. This field is required if webhook is specified.

string tag = 3;

Returns
TypeDescription
String

The tag.

getTagBytes()

public ByteString getTagBytes()

The value of this field will be populated in the WebhookRequest fulfillmentInfo.tag field by Dialogflow when the associated webhook is called. The tag is typically used by the webhook service to identify which fulfillment is being called, but it could be used for other purposes. This field is required if webhook is specified.

string tag = 3;

Returns
TypeDescription
ByteString

The bytes for tag.

getWebhook()

public String getWebhook()

The webhook to call. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/webhooks/<Webhook ID>.

string webhook = 2 [(.google.api.resource_reference) = { ... }

Returns
TypeDescription
String

The webhook.

getWebhookBytes()

public ByteString getWebhookBytes()

The webhook to call. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/webhooks/<Webhook ID>.

string webhook = 2 [(.google.api.resource_reference) = { ... }

Returns
TypeDescription
ByteString

The bytes for webhook.

hasAdvancedSettings()

public boolean hasAdvancedSettings()

Hierarchical advanced settings for this fulfillment. The settings exposed at the lower level overrides the settings exposed at the higher level.

.google.cloud.dialogflow.cx.v3beta1.AdvancedSettings advanced_settings = 7;

Returns
TypeDescription
boolean

Whether the advancedSettings field is set.

hashCode()

public int hashCode()
Returns
TypeDescription
int
Overrides

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

newBuilderForType()

public Fulfillment.Builder newBuilderForType()
Returns
TypeDescription
Fulfillment.Builder

newBuilderForType(GeneratedMessageV3.BuilderParent parent)

protected Fulfillment.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
NameDescription
parentBuilderParent
Returns
TypeDescription
Fulfillment.Builder
Overrides

newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)

protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
NameDescription
unusedUnusedPrivateParameter
Returns
TypeDescription
Object
Overrides

toBuilder()

public Fulfillment.Builder toBuilder()
Returns
TypeDescription
Fulfillment.Builder

writeTo(CodedOutputStream output)

public void writeTo(CodedOutputStream output)
Parameter
NameDescription
outputCodedOutputStream
Overrides
Exceptions
TypeDescription
IOException