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.v3.Fulfillment

Static Fields

ADVANCED_SETTINGS_FIELD_NUMBER

public static final int ADVANCED_SETTINGS_FIELD_NUMBER
Field Value
Type Description
int

CONDITIONAL_CASES_FIELD_NUMBER

public static final int CONDITIONAL_CASES_FIELD_NUMBER
Field Value
Type Description
int

ENABLE_GENERATIVE_FALLBACK_FIELD_NUMBER

public static final int ENABLE_GENERATIVE_FALLBACK_FIELD_NUMBER
Field Value
Type Description
int

MESSAGES_FIELD_NUMBER

public static final int MESSAGES_FIELD_NUMBER
Field Value
Type Description
int

RETURN_PARTIAL_RESPONSES_FIELD_NUMBER

public static final int RETURN_PARTIAL_RESPONSES_FIELD_NUMBER
Field Value
Type Description
int

SET_PARAMETER_ACTIONS_FIELD_NUMBER

public static final int SET_PARAMETER_ACTIONS_FIELD_NUMBER
Field Value
Type Description
int

TAG_FIELD_NUMBER

public static final int TAG_FIELD_NUMBER
Field Value
Type Description
int

WEBHOOK_FIELD_NUMBER

public static final int WEBHOOK_FIELD_NUMBER
Field Value
Type Description
int

Static Methods

getDefaultInstance()

public static Fulfillment getDefaultInstance()
Returns
Type Description
Fulfillment

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
Type Description
Descriptor

newBuilder()

public static Fulfillment.Builder newBuilder()
Returns
Type Description
Fulfillment.Builder

newBuilder(Fulfillment prototype)

public static Fulfillment.Builder newBuilder(Fulfillment prototype)
Parameter
Name Description
prototype Fulfillment
Returns
Type Description
Fulfillment.Builder

parseDelimitedFrom(InputStream input)

public static Fulfillment parseDelimitedFrom(InputStream input)
Parameter
Name Description
input InputStream
Returns
Type Description
Fulfillment
Exceptions
Type Description
IOException

parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static Fulfillment parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input InputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
Fulfillment
Exceptions
Type Description
IOException

parseFrom(byte[] data)

public static Fulfillment parseFrom(byte[] data)
Parameter
Name Description
data byte[]
Returns
Type Description
Fulfillment
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)

public static Fulfillment parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
data byte[]
extensionRegistry ExtensionRegistryLite
Returns
Type Description
Fulfillment
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(ByteString data)

public static Fulfillment parseFrom(ByteString data)
Parameter
Name Description
data ByteString
Returns
Type Description
Fulfillment
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)

public static Fulfillment parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
data ByteString
extensionRegistry ExtensionRegistryLite
Returns
Type Description
Fulfillment
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(CodedInputStream input)

public static Fulfillment parseFrom(CodedInputStream input)
Parameter
Name Description
input CodedInputStream
Returns
Type Description
Fulfillment
Exceptions
Type Description
IOException

parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public static Fulfillment parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input CodedInputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
Fulfillment
Exceptions
Type Description
IOException

parseFrom(InputStream input)

public static Fulfillment parseFrom(InputStream input)
Parameter
Name Description
input InputStream
Returns
Type Description
Fulfillment
Exceptions
Type Description
IOException

parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static Fulfillment parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input InputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
Fulfillment
Exceptions
Type Description
IOException

parseFrom(ByteBuffer data)

public static Fulfillment parseFrom(ByteBuffer data)
Parameter
Name Description
data ByteBuffer
Returns
Type Description
Fulfillment
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)

public static Fulfillment parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
data ByteBuffer
extensionRegistry ExtensionRegistryLite
Returns
Type Description
Fulfillment
Exceptions
Type Description
InvalidProtocolBufferException

parser()

public static Parser<Fulfillment> parser()
Returns
Type Description
Parser<Fulfillment>

Methods

equals(Object obj)

public boolean equals(Object obj)
Parameter
Name Description
obj Object
Returns
Type Description
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.v3.AdvancedSettings advanced_settings = 7;

Returns
Type Description
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.v3.AdvancedSettings advanced_settings = 7;

Returns
Type Description
AdvancedSettingsOrBuilder

getConditionalCases(int index)

public Fulfillment.ConditionalCases getConditionalCases(int index)

Conditional cases for this fulfillment.

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

Parameter
Name Description
index int
Returns
Type Description
Fulfillment.ConditionalCases

getConditionalCasesCount()

public int getConditionalCasesCount()

Conditional cases for this fulfillment.

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

Returns
Type Description
int

getConditionalCasesList()

public List<Fulfillment.ConditionalCases> getConditionalCasesList()

Conditional cases for this fulfillment.

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

Returns
Type Description
List<ConditionalCases>

getConditionalCasesOrBuilder(int index)

public Fulfillment.ConditionalCasesOrBuilder getConditionalCasesOrBuilder(int index)

Conditional cases for this fulfillment.

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

Parameter
Name Description
index int
Returns
Type Description
Fulfillment.ConditionalCasesOrBuilder

getConditionalCasesOrBuilderList()

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

Conditional cases for this fulfillment.

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

Returns
Type Description
List<? extends com.google.cloud.dialogflow.cx.v3.Fulfillment.ConditionalCasesOrBuilder>

getDefaultInstanceForType()

public Fulfillment getDefaultInstanceForType()
Returns
Type Description
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
Type Description
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.v3.ResponseMessage messages = 1;

Parameter
Name Description
index int
Returns
Type Description
ResponseMessage

getMessagesCount()

public int getMessagesCount()

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

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

Returns
Type Description
int

getMessagesList()

public List<ResponseMessage> getMessagesList()

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

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

Returns
Type Description
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.v3.ResponseMessage messages = 1;

Parameter
Name Description
index int
Returns
Type Description
ResponseMessageOrBuilder

getMessagesOrBuilderList()

public List<? extends ResponseMessageOrBuilder> getMessagesOrBuilderList()

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

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

Returns
Type Description
List<? extends com.google.cloud.dialogflow.cx.v3.ResponseMessageOrBuilder>

getParserForType()

public Parser<Fulfillment> getParserForType()
Returns
Type Description
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
Type Description
boolean

The returnPartialResponses.

getSerializedSize()

public int getSerializedSize()
Returns
Type Description
int
Overrides

getSetParameterActions(int index)

public Fulfillment.SetParameterAction getSetParameterActions(int index)

Set parameter values before executing the webhook.

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

Parameter
Name Description
index int
Returns
Type Description
Fulfillment.SetParameterAction

getSetParameterActionsCount()

public int getSetParameterActionsCount()

Set parameter values before executing the webhook.

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

Returns
Type Description
int

getSetParameterActionsList()

public List<Fulfillment.SetParameterAction> getSetParameterActionsList()

Set parameter values before executing the webhook.

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

Returns
Type Description
List<SetParameterAction>

getSetParameterActionsOrBuilder(int index)

public Fulfillment.SetParameterActionOrBuilder getSetParameterActionsOrBuilder(int index)

Set parameter values before executing the webhook.

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

Parameter
Name Description
index int
Returns
Type Description
Fulfillment.SetParameterActionOrBuilder

getSetParameterActionsOrBuilderList()

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

Set parameter values before executing the webhook.

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

Returns
Type Description
List<? extends com.google.cloud.dialogflow.cx.v3.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
Type Description
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
Type Description
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
Type Description
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
Type Description
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.v3.AdvancedSettings advanced_settings = 7;

Returns
Type Description
boolean

Whether the advancedSettings field is set.

hashCode()

public int hashCode()
Returns
Type Description
int
Overrides

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Type Description
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
Type Description
boolean
Overrides

newBuilderForType()

public Fulfillment.Builder newBuilderForType()
Returns
Type Description
Fulfillment.Builder

newBuilderForType(GeneratedMessageV3.BuilderParent parent)

protected Fulfillment.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
Name Description
parent BuilderParent
Returns
Type Description
Fulfillment.Builder
Overrides

newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)

protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
Name Description
unused UnusedPrivateParameter
Returns
Type Description
Object
Overrides

toBuilder()

public Fulfillment.Builder toBuilder()
Returns
Type Description
Fulfillment.Builder

writeTo(CodedOutputStream output)

public void writeTo(CodedOutputStream output)
Parameter
Name Description
output CodedOutputStream
Overrides
Exceptions
Type Description
IOException