go: cloud.google.com/go/dialogflow/apiv2 Index | Examples | Files

package dialogflow

import "cloud.google.com/go/dialogflow/apiv2"

Package dialogflow is an auto-generated package for the Dialogflow API.

NOTE: This package is in alpha. It is not stable, and is likely to change.

An end-to-end development suite for conversational interfaces (e.g., chatbots, voice-powered apps and devices).

Index

Examples

Package Files

agents_client.go contexts_client.go doc.go entity_types_client.go intents_client.go session_entity_types_client.go sessions_client.go

func DefaultAuthScopes Uses

func DefaultAuthScopes() []string

DefaultAuthScopes reports the default set of authentication scopes to use with this package.

type AgentIterator Uses

type AgentIterator struct {

    // InternalFetch is for use by the Google Cloud Libraries only.
    // It is not part of the stable interface of this package.
    //
    // InternalFetch returns results from a single call to the underlying RPC.
    // The number of results is no greater than pageSize.
    // If there are no more results, nextPageToken is empty and err is nil.
    InternalFetch func(pageSize int, pageToken string) (results []*dialogflowpb.Agent, nextPageToken string, err error)
    // contains filtered or unexported fields
}

AgentIterator manages a stream of *dialogflowpb.Agent.

func (*AgentIterator) Next Uses

func (it *AgentIterator) Next() (*dialogflowpb.Agent, error)

Next returns the next result. Its second return value is iterator.Done if there are no more results. Once Next returns Done, all subsequent calls will return Done.

func (*AgentIterator) PageInfo Uses

func (it *AgentIterator) PageInfo() *iterator.PageInfo

PageInfo supports pagination. See the google.golang.org/api/iterator package for details.

type AgentsCallOptions Uses

type AgentsCallOptions struct {
    GetAgent     []gax.CallOption
    SearchAgents []gax.CallOption
    TrainAgent   []gax.CallOption
    ExportAgent  []gax.CallOption
    ImportAgent  []gax.CallOption
    RestoreAgent []gax.CallOption
}

AgentsCallOptions contains the retry settings for each method of AgentsClient.

type AgentsClient Uses

type AgentsClient struct {

    // LROClient is used internally to handle longrunning operations.
    // It is exposed so that its CallOptions can be modified if required.
    // Users should not Close this client.
    LROClient *lroauto.OperationsClient

    // The call options for this service.
    CallOptions *AgentsCallOptions
    // contains filtered or unexported fields
}

AgentsClient is a client for interacting with Dialogflow API.

Methods, except Close, may be called concurrently. However, fields must not be modified concurrently with method calls.

func NewAgentsClient Uses

func NewAgentsClient(ctx context.Context, opts ...option.ClientOption) (*AgentsClient, error)

NewAgentsClient creates a new agents client.

Agents are best described as Natural Language Understanding (NLU) modules that transform user requests into actionable data. You can include agents in your app, product, or service to determine user intent and respond to the user in a natural way.

After you create an agent, you can add [Intents][google.cloud.dialogflow.v2.Intents], [Contexts][google.cloud.dialogflow.v2.Contexts], [Entity Types][google.cloud.dialogflow.v2.EntityTypes], [Webhooks][google.cloud.dialogflow.v2.WebhookRequest], and so on to manage the flow of a conversation and match user input to predefined intents and actions.

You can create an agent using both Dialogflow Standard Edition and Dialogflow Enterprise Edition. For details, see Dialogflow Editions (at /dialogflow-enterprise/docs/editions).

You can save your agent for backup or versioning by exporting the agent by using the [ExportAgent][google.cloud.dialogflow.v2.Agents.ExportAgent] method. You can import a saved agent by using the [ImportAgent][google.cloud.dialogflow.v2.Agents.ImportAgent] method.

Dialogflow provides several prebuilt agents (at https://dialogflow.com/docs/prebuilt-agents) for common conversation scenarios such as determining a date and time, converting currency, and so on.

For more information about agents, see the Dialogflow documentation (at https://dialogflow.com/docs/agents).

Code:

ctx := context.Background()
c, err := dialogflow.NewAgentsClient(ctx)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use client.
_ = c

func (*AgentsClient) Close Uses

func (c *AgentsClient) Close() error

Close closes the connection to the API service. The user should invoke this when the client is no longer required.

func (*AgentsClient) Connection Uses

func (c *AgentsClient) Connection() *grpc.ClientConn

Connection returns the client's connection to the API service.

func (*AgentsClient) ExportAgent Uses

func (c *AgentsClient) ExportAgent(ctx context.Context, req *dialogflowpb.ExportAgentRequest, opts ...gax.CallOption) (*ExportAgentOperation, error)

ExportAgent exports the specified agent to a ZIP file.

Operation <response: [ExportAgentResponse][google.cloud.dialogflow.v2.ExportAgentResponse], metadata: [google.protobuf.Struct][google.protobuf.Struct]>

Code:

ctx := context.Background()
c, err := dialogflow.NewAgentsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.ExportAgentRequest{
    // TODO: Fill request struct fields.
}
op, err := c.ExportAgent(ctx, req)
if err != nil {
    // TODO: Handle error.
}

resp, err := op.Wait(ctx)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use resp.
_ = resp

func (*AgentsClient) ExportAgentOperation Uses

func (c *AgentsClient) ExportAgentOperation(name string) *ExportAgentOperation

ExportAgentOperation returns a new ExportAgentOperation from a given name. The name must be that of a previously created ExportAgentOperation, possibly from a different process.

func (*AgentsClient) GetAgent Uses

func (c *AgentsClient) GetAgent(ctx context.Context, req *dialogflowpb.GetAgentRequest, opts ...gax.CallOption) (*dialogflowpb.Agent, error)

GetAgent retrieves the specified agent.

Code:

ctx := context.Background()
c, err := dialogflow.NewAgentsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.GetAgentRequest{
    // TODO: Fill request struct fields.
}
resp, err := c.GetAgent(ctx, req)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use resp.
_ = resp

func (*AgentsClient) ImportAgent Uses

func (c *AgentsClient) ImportAgent(ctx context.Context, req *dialogflowpb.ImportAgentRequest, opts ...gax.CallOption) (*ImportAgentOperation, error)

ImportAgent imports the specified agent from a ZIP file.

Uploads new intents and entity types without deleting the existing ones. Intents and entity types with the same name are replaced with the new versions from ImportAgentRequest.

Operation <response: [google.protobuf.Empty][google.protobuf.Empty], metadata: [google.protobuf.Struct][google.protobuf.Struct]>

Code:

ctx := context.Background()
c, err := dialogflow.NewAgentsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.ImportAgentRequest{
    // TODO: Fill request struct fields.
}
op, err := c.ImportAgent(ctx, req)
if err != nil {
    // TODO: Handle error.
}

err = op.Wait(ctx)
// TODO: Handle error.

func (*AgentsClient) ImportAgentOperation Uses

func (c *AgentsClient) ImportAgentOperation(name string) *ImportAgentOperation

ImportAgentOperation returns a new ImportAgentOperation from a given name. The name must be that of a previously created ImportAgentOperation, possibly from a different process.

func (*AgentsClient) RestoreAgent Uses

func (c *AgentsClient) RestoreAgent(ctx context.Context, req *dialogflowpb.RestoreAgentRequest, opts ...gax.CallOption) (*RestoreAgentOperation, error)

RestoreAgent restores the specified agent from a ZIP file.

Replaces the current agent version with a new one. All the intents and entity types in the older version are deleted.

Operation <response: [google.protobuf.Empty][google.protobuf.Empty], metadata: [google.protobuf.Struct][google.protobuf.Struct]>

Code:

ctx := context.Background()
c, err := dialogflow.NewAgentsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.RestoreAgentRequest{
    // TODO: Fill request struct fields.
}
op, err := c.RestoreAgent(ctx, req)
if err != nil {
    // TODO: Handle error.
}

err = op.Wait(ctx)
// TODO: Handle error.

func (*AgentsClient) RestoreAgentOperation Uses

func (c *AgentsClient) RestoreAgentOperation(name string) *RestoreAgentOperation

RestoreAgentOperation returns a new RestoreAgentOperation from a given name. The name must be that of a previously created RestoreAgentOperation, possibly from a different process.

func (*AgentsClient) SearchAgents Uses

func (c *AgentsClient) SearchAgents(ctx context.Context, req *dialogflowpb.SearchAgentsRequest, opts ...gax.CallOption) *AgentIterator

SearchAgents returns the list of agents.

Since there is at most one conversational agent per project, this method is useful primarily for listing all agents across projects the caller has access to. One can achieve that with a wildcard project collection id "-". Refer to List Sub-Collections (at https://cloud.google.com/apis/design/design_patterns#list_sub-collections).

Code:

ctx := context.Background()
c, err := dialogflow.NewAgentsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.SearchAgentsRequest{
    // TODO: Fill request struct fields.
}
it := c.SearchAgents(ctx, req)
for {
    resp, err := it.Next()
    if err == iterator.Done {
        break
    }
    if err != nil {
        // TODO: Handle error.
    }
    // TODO: Use resp.
    _ = resp
}

func (*AgentsClient) TrainAgent Uses

func (c *AgentsClient) TrainAgent(ctx context.Context, req *dialogflowpb.TrainAgentRequest, opts ...gax.CallOption) (*TrainAgentOperation, error)

TrainAgent trains the specified agent.

Operation <response: [google.protobuf.Empty][google.protobuf.Empty], metadata: [google.protobuf.Struct][google.protobuf.Struct]>

Code:

ctx := context.Background()
c, err := dialogflow.NewAgentsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.TrainAgentRequest{
    // TODO: Fill request struct fields.
}
op, err := c.TrainAgent(ctx, req)
if err != nil {
    // TODO: Handle error.
}

err = op.Wait(ctx)
// TODO: Handle error.

func (*AgentsClient) TrainAgentOperation Uses

func (c *AgentsClient) TrainAgentOperation(name string) *TrainAgentOperation

TrainAgentOperation returns a new TrainAgentOperation from a given name. The name must be that of a previously created TrainAgentOperation, possibly from a different process.

type BatchCreateEntitiesOperation Uses

type BatchCreateEntitiesOperation struct {
    // contains filtered or unexported fields
}

BatchCreateEntitiesOperation manages a long-running operation from BatchCreateEntities.

func (*BatchCreateEntitiesOperation) Done Uses

func (op *BatchCreateEntitiesOperation) Done() bool

Done reports whether the long-running operation has completed.

func (*BatchCreateEntitiesOperation) Metadata Uses

func (op *BatchCreateEntitiesOperation) Metadata() (*structpbpb.Struct, error)

Metadata returns metadata associated with the long-running operation. Metadata itself does not contact the server, but Poll does. To get the latest metadata, call this method after a successful call to Poll. If the metadata is not available, the returned metadata and error are both nil.

func (*BatchCreateEntitiesOperation) Name Uses

func (op *BatchCreateEntitiesOperation) Name() string

Name returns the name of the long-running operation. The name is assigned by the server and is unique within the service from which the operation is created.

func (*BatchCreateEntitiesOperation) Poll Uses

func (op *BatchCreateEntitiesOperation) Poll(ctx context.Context, opts ...gax.CallOption) error

Poll fetches the latest state of the long-running operation.

Poll also fetches the latest metadata, which can be retrieved by Metadata.

If Poll fails, the error is returned and op is unmodified. If Poll succeeds and the operation has completed with failure, the error is returned and op.Done will return true. If Poll succeeds and the operation has completed successfully, op.Done will return true.

func (*BatchCreateEntitiesOperation) Wait Uses

func (op *BatchCreateEntitiesOperation) Wait(ctx context.Context, opts ...gax.CallOption) error

Wait blocks until the long-running operation is completed, returning any error encountered.

See documentation of Poll for error-handling information.

type BatchDeleteEntitiesOperation Uses

type BatchDeleteEntitiesOperation struct {
    // contains filtered or unexported fields
}

BatchDeleteEntitiesOperation manages a long-running operation from BatchDeleteEntities.

func (*BatchDeleteEntitiesOperation) Done Uses

func (op *BatchDeleteEntitiesOperation) Done() bool

Done reports whether the long-running operation has completed.

func (*BatchDeleteEntitiesOperation) Metadata Uses

func (op *BatchDeleteEntitiesOperation) Metadata() (*structpbpb.Struct, error)

Metadata returns metadata associated with the long-running operation. Metadata itself does not contact the server, but Poll does. To get the latest metadata, call this method after a successful call to Poll. If the metadata is not available, the returned metadata and error are both nil.

func (*BatchDeleteEntitiesOperation) Name Uses

func (op *BatchDeleteEntitiesOperation) Name() string

Name returns the name of the long-running operation. The name is assigned by the server and is unique within the service from which the operation is created.

func (*BatchDeleteEntitiesOperation) Poll Uses

func (op *BatchDeleteEntitiesOperation) Poll(ctx context.Context, opts ...gax.CallOption) error

Poll fetches the latest state of the long-running operation.

Poll also fetches the latest metadata, which can be retrieved by Metadata.

If Poll fails, the error is returned and op is unmodified. If Poll succeeds and the operation has completed with failure, the error is returned and op.Done will return true. If Poll succeeds and the operation has completed successfully, op.Done will return true.

func (*BatchDeleteEntitiesOperation) Wait Uses

func (op *BatchDeleteEntitiesOperation) Wait(ctx context.Context, opts ...gax.CallOption) error

Wait blocks until the long-running operation is completed, returning any error encountered.

See documentation of Poll for error-handling information.

type BatchDeleteEntityTypesOperation Uses

type BatchDeleteEntityTypesOperation struct {
    // contains filtered or unexported fields
}

BatchDeleteEntityTypesOperation manages a long-running operation from BatchDeleteEntityTypes.

func (*BatchDeleteEntityTypesOperation) Done Uses

func (op *BatchDeleteEntityTypesOperation) Done() bool

Done reports whether the long-running operation has completed.

func (*BatchDeleteEntityTypesOperation) Metadata Uses

func (op *BatchDeleteEntityTypesOperation) Metadata() (*structpbpb.Struct, error)

Metadata returns metadata associated with the long-running operation. Metadata itself does not contact the server, but Poll does. To get the latest metadata, call this method after a successful call to Poll. If the metadata is not available, the returned metadata and error are both nil.

func (*BatchDeleteEntityTypesOperation) Name Uses

func (op *BatchDeleteEntityTypesOperation) Name() string

Name returns the name of the long-running operation. The name is assigned by the server and is unique within the service from which the operation is created.

func (*BatchDeleteEntityTypesOperation) Poll Uses

func (op *BatchDeleteEntityTypesOperation) Poll(ctx context.Context, opts ...gax.CallOption) error

Poll fetches the latest state of the long-running operation.

Poll also fetches the latest metadata, which can be retrieved by Metadata.

If Poll fails, the error is returned and op is unmodified. If Poll succeeds and the operation has completed with failure, the error is returned and op.Done will return true. If Poll succeeds and the operation has completed successfully, op.Done will return true.

func (*BatchDeleteEntityTypesOperation) Wait Uses

func (op *BatchDeleteEntityTypesOperation) Wait(ctx context.Context, opts ...gax.CallOption) error

Wait blocks until the long-running operation is completed, returning any error encountered.

See documentation of Poll for error-handling information.

type BatchDeleteIntentsOperation Uses

type BatchDeleteIntentsOperation struct {
    // contains filtered or unexported fields
}

BatchDeleteIntentsOperation manages a long-running operation from BatchDeleteIntents.

func (*BatchDeleteIntentsOperation) Done Uses

func (op *BatchDeleteIntentsOperation) Done() bool

Done reports whether the long-running operation has completed.

func (*BatchDeleteIntentsOperation) Metadata Uses

func (op *BatchDeleteIntentsOperation) Metadata() (*structpbpb.Struct, error)

Metadata returns metadata associated with the long-running operation. Metadata itself does not contact the server, but Poll does. To get the latest metadata, call this method after a successful call to Poll. If the metadata is not available, the returned metadata and error are both nil.

func (*BatchDeleteIntentsOperation) Name Uses

func (op *BatchDeleteIntentsOperation) Name() string

Name returns the name of the long-running operation. The name is assigned by the server and is unique within the service from which the operation is created.

func (*BatchDeleteIntentsOperation) Poll Uses

func (op *BatchDeleteIntentsOperation) Poll(ctx context.Context, opts ...gax.CallOption) error

Poll fetches the latest state of the long-running operation.

Poll also fetches the latest metadata, which can be retrieved by Metadata.

If Poll fails, the error is returned and op is unmodified. If Poll succeeds and the operation has completed with failure, the error is returned and op.Done will return true. If Poll succeeds and the operation has completed successfully, op.Done will return true.

func (*BatchDeleteIntentsOperation) Wait Uses

func (op *BatchDeleteIntentsOperation) Wait(ctx context.Context, opts ...gax.CallOption) error

Wait blocks until the long-running operation is completed, returning any error encountered.

See documentation of Poll for error-handling information.

type BatchUpdateEntitiesOperation Uses

type BatchUpdateEntitiesOperation struct {
    // contains filtered or unexported fields
}

BatchUpdateEntitiesOperation manages a long-running operation from BatchUpdateEntities.

func (*BatchUpdateEntitiesOperation) Done Uses

func (op *BatchUpdateEntitiesOperation) Done() bool

Done reports whether the long-running operation has completed.

func (*BatchUpdateEntitiesOperation) Metadata Uses

func (op *BatchUpdateEntitiesOperation) Metadata() (*structpbpb.Struct, error)

Metadata returns metadata associated with the long-running operation. Metadata itself does not contact the server, but Poll does. To get the latest metadata, call this method after a successful call to Poll. If the metadata is not available, the returned metadata and error are both nil.

func (*BatchUpdateEntitiesOperation) Name Uses

func (op *BatchUpdateEntitiesOperation) Name() string

Name returns the name of the long-running operation. The name is assigned by the server and is unique within the service from which the operation is created.

func (*BatchUpdateEntitiesOperation) Poll Uses

func (op *BatchUpdateEntitiesOperation) Poll(ctx context.Context, opts ...gax.CallOption) error

Poll fetches the latest state of the long-running operation.

Poll also fetches the latest metadata, which can be retrieved by Metadata.

If Poll fails, the error is returned and op is unmodified. If Poll succeeds and the operation has completed with failure, the error is returned and op.Done will return true. If Poll succeeds and the operation has completed successfully, op.Done will return true.

func (*BatchUpdateEntitiesOperation) Wait Uses

func (op *BatchUpdateEntitiesOperation) Wait(ctx context.Context, opts ...gax.CallOption) error

Wait blocks until the long-running operation is completed, returning any error encountered.

See documentation of Poll for error-handling information.

type BatchUpdateEntityTypesOperation Uses

type BatchUpdateEntityTypesOperation struct {
    // contains filtered or unexported fields
}

BatchUpdateEntityTypesOperation manages a long-running operation from BatchUpdateEntityTypes.

func (*BatchUpdateEntityTypesOperation) Done Uses

func (op *BatchUpdateEntityTypesOperation) Done() bool

Done reports whether the long-running operation has completed.

func (*BatchUpdateEntityTypesOperation) Metadata Uses

func (op *BatchUpdateEntityTypesOperation) Metadata() (*structpbpb.Struct, error)

Metadata returns metadata associated with the long-running operation. Metadata itself does not contact the server, but Poll does. To get the latest metadata, call this method after a successful call to Poll. If the metadata is not available, the returned metadata and error are both nil.

func (*BatchUpdateEntityTypesOperation) Name Uses

func (op *BatchUpdateEntityTypesOperation) Name() string

Name returns the name of the long-running operation. The name is assigned by the server and is unique within the service from which the operation is created.

func (*BatchUpdateEntityTypesOperation) Poll Uses

func (op *BatchUpdateEntityTypesOperation) Poll(ctx context.Context, opts ...gax.CallOption) (*dialogflowpb.BatchUpdateEntityTypesResponse, error)

Poll fetches the latest state of the long-running operation.

Poll also fetches the latest metadata, which can be retrieved by Metadata.

If Poll fails, the error is returned and op is unmodified. If Poll succeeds and the operation has completed with failure, the error is returned and op.Done will return true. If Poll succeeds and the operation has completed successfully, op.Done will return true, and the response of the operation is returned. If Poll succeeds and the operation has not completed, the returned response and error are both nil.

func (*BatchUpdateEntityTypesOperation) Wait Uses

func (op *BatchUpdateEntityTypesOperation) Wait(ctx context.Context, opts ...gax.CallOption) (*dialogflowpb.BatchUpdateEntityTypesResponse, error)

Wait blocks until the long-running operation is completed, returning the response and any errors encountered.

See documentation of Poll for error-handling information.

type BatchUpdateIntentsOperation Uses

type BatchUpdateIntentsOperation struct {
    // contains filtered or unexported fields
}

BatchUpdateIntentsOperation manages a long-running operation from BatchUpdateIntents.

func (*BatchUpdateIntentsOperation) Done Uses

func (op *BatchUpdateIntentsOperation) Done() bool

Done reports whether the long-running operation has completed.

func (*BatchUpdateIntentsOperation) Metadata Uses

func (op *BatchUpdateIntentsOperation) Metadata() (*structpbpb.Struct, error)

Metadata returns metadata associated with the long-running operation. Metadata itself does not contact the server, but Poll does. To get the latest metadata, call this method after a successful call to Poll. If the metadata is not available, the returned metadata and error are both nil.

func (*BatchUpdateIntentsOperation) Name Uses

func (op *BatchUpdateIntentsOperation) Name() string

Name returns the name of the long-running operation. The name is assigned by the server and is unique within the service from which the operation is created.

func (*BatchUpdateIntentsOperation) Poll Uses

func (op *BatchUpdateIntentsOperation) Poll(ctx context.Context, opts ...gax.CallOption) (*dialogflowpb.BatchUpdateIntentsResponse, error)

Poll fetches the latest state of the long-running operation.

Poll also fetches the latest metadata, which can be retrieved by Metadata.

If Poll fails, the error is returned and op is unmodified. If Poll succeeds and the operation has completed with failure, the error is returned and op.Done will return true. If Poll succeeds and the operation has completed successfully, op.Done will return true, and the response of the operation is returned. If Poll succeeds and the operation has not completed, the returned response and error are both nil.

func (*BatchUpdateIntentsOperation) Wait Uses

func (op *BatchUpdateIntentsOperation) Wait(ctx context.Context, opts ...gax.CallOption) (*dialogflowpb.BatchUpdateIntentsResponse, error)

Wait blocks until the long-running operation is completed, returning the response and any errors encountered.

See documentation of Poll for error-handling information.

type ContextIterator Uses

type ContextIterator struct {

    // InternalFetch is for use by the Google Cloud Libraries only.
    // It is not part of the stable interface of this package.
    //
    // InternalFetch returns results from a single call to the underlying RPC.
    // The number of results is no greater than pageSize.
    // If there are no more results, nextPageToken is empty and err is nil.
    InternalFetch func(pageSize int, pageToken string) (results []*dialogflowpb.Context, nextPageToken string, err error)
    // contains filtered or unexported fields
}

ContextIterator manages a stream of *dialogflowpb.Context.

func (*ContextIterator) Next Uses

func (it *ContextIterator) Next() (*dialogflowpb.Context, error)

Next returns the next result. Its second return value is iterator.Done if there are no more results. Once Next returns Done, all subsequent calls will return Done.

func (*ContextIterator) PageInfo Uses

func (it *ContextIterator) PageInfo() *iterator.PageInfo

PageInfo supports pagination. See the google.golang.org/api/iterator package for details.

type ContextsCallOptions Uses

type ContextsCallOptions struct {
    ListContexts      []gax.CallOption
    GetContext        []gax.CallOption
    CreateContext     []gax.CallOption
    UpdateContext     []gax.CallOption
    DeleteContext     []gax.CallOption
    DeleteAllContexts []gax.CallOption
}

ContextsCallOptions contains the retry settings for each method of ContextsClient.

type ContextsClient Uses

type ContextsClient struct {

    // The call options for this service.
    CallOptions *ContextsCallOptions
    // contains filtered or unexported fields
}

ContextsClient is a client for interacting with Dialogflow API.

Methods, except Close, may be called concurrently. However, fields must not be modified concurrently with method calls.

func NewContextsClient Uses

func NewContextsClient(ctx context.Context, opts ...option.ClientOption) (*ContextsClient, error)

NewContextsClient creates a new contexts client.

A context represents additional information included with user input or with an intent returned by the Dialogflow API. Contexts are helpful for differentiating user input which may be vague or have a different meaning depending on additional details from your application such as user setting and preferences, previous user input, where the user is in your application, geographic location, and so on.

You can include contexts as input parameters of a [DetectIntent][google.cloud.dialogflow.v2.Sessions.DetectIntent] (or [StreamingDetectIntent][google.cloud.dialogflow.v2.Sessions.StreamingDetectIntent]) request, or as output contexts included in the returned intent. Contexts expire when an intent is matched, after the number of DetectIntent requests specified by the lifespan_count parameter, or after 10 minutes if no intents are matched for a DetectIntent request.

For more information about contexts, see the Dialogflow documentation (at https://dialogflow.com/docs/contexts).

Code:

ctx := context.Background()
c, err := dialogflow.NewContextsClient(ctx)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use client.
_ = c

func (*ContextsClient) Close Uses

func (c *ContextsClient) Close() error

Close closes the connection to the API service. The user should invoke this when the client is no longer required.

func (*ContextsClient) Connection Uses

func (c *ContextsClient) Connection() *grpc.ClientConn

Connection returns the client's connection to the API service.

func (*ContextsClient) CreateContext Uses

func (c *ContextsClient) CreateContext(ctx context.Context, req *dialogflowpb.CreateContextRequest, opts ...gax.CallOption) (*dialogflowpb.Context, error)

CreateContext creates a context.

Code:

ctx := context.Background()
c, err := dialogflow.NewContextsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.CreateContextRequest{
    // TODO: Fill request struct fields.
}
resp, err := c.CreateContext(ctx, req)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use resp.
_ = resp

func (*ContextsClient) DeleteAllContexts Uses

func (c *ContextsClient) DeleteAllContexts(ctx context.Context, req *dialogflowpb.DeleteAllContextsRequest, opts ...gax.CallOption) error

DeleteAllContexts deletes all active contexts in the specified session.

Code:

ctx := context.Background()
c, err := dialogflow.NewContextsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.DeleteAllContextsRequest{
    // TODO: Fill request struct fields.
}
err = c.DeleteAllContexts(ctx, req)
if err != nil {
    // TODO: Handle error.
}

func (*ContextsClient) DeleteContext Uses

func (c *ContextsClient) DeleteContext(ctx context.Context, req *dialogflowpb.DeleteContextRequest, opts ...gax.CallOption) error

DeleteContext deletes the specified context.

Code:

ctx := context.Background()
c, err := dialogflow.NewContextsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.DeleteContextRequest{
    // TODO: Fill request struct fields.
}
err = c.DeleteContext(ctx, req)
if err != nil {
    // TODO: Handle error.
}

func (*ContextsClient) GetContext Uses

func (c *ContextsClient) GetContext(ctx context.Context, req *dialogflowpb.GetContextRequest, opts ...gax.CallOption) (*dialogflowpb.Context, error)

GetContext retrieves the specified context.

Code:

ctx := context.Background()
c, err := dialogflow.NewContextsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.GetContextRequest{
    // TODO: Fill request struct fields.
}
resp, err := c.GetContext(ctx, req)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use resp.
_ = resp

func (*ContextsClient) ListContexts Uses

func (c *ContextsClient) ListContexts(ctx context.Context, req *dialogflowpb.ListContextsRequest, opts ...gax.CallOption) *ContextIterator

ListContexts returns the list of all contexts in the specified session.

Code:

ctx := context.Background()
c, err := dialogflow.NewContextsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.ListContextsRequest{
    // TODO: Fill request struct fields.
}
it := c.ListContexts(ctx, req)
for {
    resp, err := it.Next()
    if err == iterator.Done {
        break
    }
    if err != nil {
        // TODO: Handle error.
    }
    // TODO: Use resp.
    _ = resp
}

func (*ContextsClient) UpdateContext Uses

func (c *ContextsClient) UpdateContext(ctx context.Context, req *dialogflowpb.UpdateContextRequest, opts ...gax.CallOption) (*dialogflowpb.Context, error)

UpdateContext updates the specified context.

Code:

ctx := context.Background()
c, err := dialogflow.NewContextsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.UpdateContextRequest{
    // TODO: Fill request struct fields.
}
resp, err := c.UpdateContext(ctx, req)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use resp.
_ = resp

type EntityTypeIterator Uses

type EntityTypeIterator struct {

    // InternalFetch is for use by the Google Cloud Libraries only.
    // It is not part of the stable interface of this package.
    //
    // InternalFetch returns results from a single call to the underlying RPC.
    // The number of results is no greater than pageSize.
    // If there are no more results, nextPageToken is empty and err is nil.
    InternalFetch func(pageSize int, pageToken string) (results []*dialogflowpb.EntityType, nextPageToken string, err error)
    // contains filtered or unexported fields
}

EntityTypeIterator manages a stream of *dialogflowpb.EntityType.

func (*EntityTypeIterator) Next Uses

func (it *EntityTypeIterator) Next() (*dialogflowpb.EntityType, error)

Next returns the next result. Its second return value is iterator.Done if there are no more results. Once Next returns Done, all subsequent calls will return Done.

func (*EntityTypeIterator) PageInfo Uses

func (it *EntityTypeIterator) PageInfo() *iterator.PageInfo

PageInfo supports pagination. See the google.golang.org/api/iterator package for details.

type EntityTypesCallOptions Uses

type EntityTypesCallOptions struct {
    ListEntityTypes        []gax.CallOption
    GetEntityType          []gax.CallOption
    CreateEntityType       []gax.CallOption
    UpdateEntityType       []gax.CallOption
    DeleteEntityType       []gax.CallOption
    BatchUpdateEntityTypes []gax.CallOption
    BatchDeleteEntityTypes []gax.CallOption
    BatchCreateEntities    []gax.CallOption
    BatchUpdateEntities    []gax.CallOption
    BatchDeleteEntities    []gax.CallOption
}

EntityTypesCallOptions contains the retry settings for each method of EntityTypesClient.

type EntityTypesClient Uses

type EntityTypesClient struct {

    // LROClient is used internally to handle longrunning operations.
    // It is exposed so that its CallOptions can be modified if required.
    // Users should not Close this client.
    LROClient *lroauto.OperationsClient

    // The call options for this service.
    CallOptions *EntityTypesCallOptions
    // contains filtered or unexported fields
}

EntityTypesClient is a client for interacting with Dialogflow API.

Methods, except Close, may be called concurrently. However, fields must not be modified concurrently with method calls.

func NewEntityTypesClient Uses

func NewEntityTypesClient(ctx context.Context, opts ...option.ClientOption) (*EntityTypesClient, error)

NewEntityTypesClient creates a new entity types client.

Entities are extracted from user input and represent parameters that are meaningful to your application. For example, a date range, a proper name such as a geographic location or landmark, and so on. Entities represent actionable data for your application.

When you define an entity, you can also include synonyms that all map to that entity. For example, "soft drink", "soda", "pop", and so on.

There are three types of entities:

* **System** - entities that are defined by the Dialogflow API for common

data types such as date, time, currency, and so on. A system entity is
represented by the `EntityType` type.

* **Developer** - entities that are defined by you that represent

actionable data that is meaningful to your application. For example,
you could define a `pizza.sauce` entity for red or white pizza sauce,
a `pizza.cheese` entity for the different types of cheese on a pizza,
a `pizza.topping` entity for different toppings, and so on. A developer
entity is represented by the `EntityType` type.

* **User** - entities that are built for an individual user such as

favorites, preferences, playlists, and so on. A user entity is
represented by the [SessionEntityType][google.cloud.dialogflow.v2.SessionEntityType] type.

For more information about entity types, see the [Dialogflow documentation](https://dialogflow.com/docs/entities).

Code:

ctx := context.Background()
c, err := dialogflow.NewEntityTypesClient(ctx)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use client.
_ = c

func (*EntityTypesClient) BatchCreateEntities Uses

func (c *EntityTypesClient) BatchCreateEntities(ctx context.Context, req *dialogflowpb.BatchCreateEntitiesRequest, opts ...gax.CallOption) (*BatchCreateEntitiesOperation, error)

BatchCreateEntities creates multiple new entities in the specified entity type (extends the existing collection of entries).

Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>

Code:

ctx := context.Background()
c, err := dialogflow.NewEntityTypesClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.BatchCreateEntitiesRequest{
    // TODO: Fill request struct fields.
}
op, err := c.BatchCreateEntities(ctx, req)
if err != nil {
    // TODO: Handle error.
}

err = op.Wait(ctx)
// TODO: Handle error.

func (*EntityTypesClient) BatchCreateEntitiesOperation Uses

func (c *EntityTypesClient) BatchCreateEntitiesOperation(name string) *BatchCreateEntitiesOperation

BatchCreateEntitiesOperation returns a new BatchCreateEntitiesOperation from a given name. The name must be that of a previously created BatchCreateEntitiesOperation, possibly from a different process.

func (*EntityTypesClient) BatchDeleteEntities Uses

func (c *EntityTypesClient) BatchDeleteEntities(ctx context.Context, req *dialogflowpb.BatchDeleteEntitiesRequest, opts ...gax.CallOption) (*BatchDeleteEntitiesOperation, error)

BatchDeleteEntities deletes entities in the specified entity type.

Operation <response: [google.protobuf.Empty][google.protobuf.Empty], metadata: [google.protobuf.Struct][google.protobuf.Struct]>

Code:

ctx := context.Background()
c, err := dialogflow.NewEntityTypesClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.BatchDeleteEntitiesRequest{
    // TODO: Fill request struct fields.
}
op, err := c.BatchDeleteEntities(ctx, req)
if err != nil {
    // TODO: Handle error.
}

err = op.Wait(ctx)
// TODO: Handle error.

func (*EntityTypesClient) BatchDeleteEntitiesOperation Uses

func (c *EntityTypesClient) BatchDeleteEntitiesOperation(name string) *BatchDeleteEntitiesOperation

BatchDeleteEntitiesOperation returns a new BatchDeleteEntitiesOperation from a given name. The name must be that of a previously created BatchDeleteEntitiesOperation, possibly from a different process.

func (*EntityTypesClient) BatchDeleteEntityTypes Uses

func (c *EntityTypesClient) BatchDeleteEntityTypes(ctx context.Context, req *dialogflowpb.BatchDeleteEntityTypesRequest, opts ...gax.CallOption) (*BatchDeleteEntityTypesOperation, error)

BatchDeleteEntityTypes deletes entity types in the specified agent.

Operation <response: [google.protobuf.Empty][google.protobuf.Empty], metadata: [google.protobuf.Struct][google.protobuf.Struct]>

Code:

ctx := context.Background()
c, err := dialogflow.NewEntityTypesClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.BatchDeleteEntityTypesRequest{
    // TODO: Fill request struct fields.
}
op, err := c.BatchDeleteEntityTypes(ctx, req)
if err != nil {
    // TODO: Handle error.
}

err = op.Wait(ctx)
// TODO: Handle error.

func (*EntityTypesClient) BatchDeleteEntityTypesOperation Uses

func (c *EntityTypesClient) BatchDeleteEntityTypesOperation(name string) *BatchDeleteEntityTypesOperation

BatchDeleteEntityTypesOperation returns a new BatchDeleteEntityTypesOperation from a given name. The name must be that of a previously created BatchDeleteEntityTypesOperation, possibly from a different process.

func (*EntityTypesClient) BatchUpdateEntities Uses

func (c *EntityTypesClient) BatchUpdateEntities(ctx context.Context, req *dialogflowpb.BatchUpdateEntitiesRequest, opts ...gax.CallOption) (*BatchUpdateEntitiesOperation, error)

BatchUpdateEntities updates entities in the specified entity type (replaces the existing collection of entries).

Operation <response: [google.protobuf.Empty][google.protobuf.Empty], metadata: [google.protobuf.Struct][google.protobuf.Struct]>

Code:

ctx := context.Background()
c, err := dialogflow.NewEntityTypesClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.BatchUpdateEntitiesRequest{
    // TODO: Fill request struct fields.
}
op, err := c.BatchUpdateEntities(ctx, req)
if err != nil {
    // TODO: Handle error.
}

err = op.Wait(ctx)
// TODO: Handle error.

func (*EntityTypesClient) BatchUpdateEntitiesOperation Uses

func (c *EntityTypesClient) BatchUpdateEntitiesOperation(name string) *BatchUpdateEntitiesOperation

BatchUpdateEntitiesOperation returns a new BatchUpdateEntitiesOperation from a given name. The name must be that of a previously created BatchUpdateEntitiesOperation, possibly from a different process.

func (*EntityTypesClient) BatchUpdateEntityTypes Uses

func (c *EntityTypesClient) BatchUpdateEntityTypes(ctx context.Context, req *dialogflowpb.BatchUpdateEntityTypesRequest, opts ...gax.CallOption) (*BatchUpdateEntityTypesOperation, error)

BatchUpdateEntityTypes updates/Creates multiple entity types in the specified agent.

Operation <response: [BatchUpdateEntityTypesResponse][google.cloud.dialogflow.v2.BatchUpdateEntityTypesResponse], metadata: [google.protobuf.Struct][google.protobuf.Struct]>

Code:

ctx := context.Background()
c, err := dialogflow.NewEntityTypesClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.BatchUpdateEntityTypesRequest{
    // TODO: Fill request struct fields.
}
op, err := c.BatchUpdateEntityTypes(ctx, req)
if err != nil {
    // TODO: Handle error.
}

resp, err := op.Wait(ctx)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use resp.
_ = resp

func (*EntityTypesClient) BatchUpdateEntityTypesOperation Uses

func (c *EntityTypesClient) BatchUpdateEntityTypesOperation(name string) *BatchUpdateEntityTypesOperation

BatchUpdateEntityTypesOperation returns a new BatchUpdateEntityTypesOperation from a given name. The name must be that of a previously created BatchUpdateEntityTypesOperation, possibly from a different process.

func (*EntityTypesClient) Close Uses

func (c *EntityTypesClient) Close() error

Close closes the connection to the API service. The user should invoke this when the client is no longer required.

func (*EntityTypesClient) Connection Uses

func (c *EntityTypesClient) Connection() *grpc.ClientConn

Connection returns the client's connection to the API service.

func (*EntityTypesClient) CreateEntityType Uses

func (c *EntityTypesClient) CreateEntityType(ctx context.Context, req *dialogflowpb.CreateEntityTypeRequest, opts ...gax.CallOption) (*dialogflowpb.EntityType, error)

CreateEntityType creates an entity type in the specified agent.

Code:

ctx := context.Background()
c, err := dialogflow.NewEntityTypesClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.CreateEntityTypeRequest{
    // TODO: Fill request struct fields.
}
resp, err := c.CreateEntityType(ctx, req)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use resp.
_ = resp

func (*EntityTypesClient) DeleteEntityType Uses

func (c *EntityTypesClient) DeleteEntityType(ctx context.Context, req *dialogflowpb.DeleteEntityTypeRequest, opts ...gax.CallOption) error

DeleteEntityType deletes the specified entity type.

Code:

ctx := context.Background()
c, err := dialogflow.NewEntityTypesClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.DeleteEntityTypeRequest{
    // TODO: Fill request struct fields.
}
err = c.DeleteEntityType(ctx, req)
if err != nil {
    // TODO: Handle error.
}

func (*EntityTypesClient) GetEntityType Uses

func (c *EntityTypesClient) GetEntityType(ctx context.Context, req *dialogflowpb.GetEntityTypeRequest, opts ...gax.CallOption) (*dialogflowpb.EntityType, error)

GetEntityType retrieves the specified entity type.

Code:

ctx := context.Background()
c, err := dialogflow.NewEntityTypesClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.GetEntityTypeRequest{
    // TODO: Fill request struct fields.
}
resp, err := c.GetEntityType(ctx, req)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use resp.
_ = resp

func (*EntityTypesClient) ListEntityTypes Uses

func (c *EntityTypesClient) ListEntityTypes(ctx context.Context, req *dialogflowpb.ListEntityTypesRequest, opts ...gax.CallOption) *EntityTypeIterator

ListEntityTypes returns the list of all entity types in the specified agent.

Code:

ctx := context.Background()
c, err := dialogflow.NewEntityTypesClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.ListEntityTypesRequest{
    // TODO: Fill request struct fields.
}
it := c.ListEntityTypes(ctx, req)
for {
    resp, err := it.Next()
    if err == iterator.Done {
        break
    }
    if err != nil {
        // TODO: Handle error.
    }
    // TODO: Use resp.
    _ = resp
}

func (*EntityTypesClient) UpdateEntityType Uses

func (c *EntityTypesClient) UpdateEntityType(ctx context.Context, req *dialogflowpb.UpdateEntityTypeRequest, opts ...gax.CallOption) (*dialogflowpb.EntityType, error)

UpdateEntityType updates the specified entity type.

Code:

ctx := context.Background()
c, err := dialogflow.NewEntityTypesClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.UpdateEntityTypeRequest{
    // TODO: Fill request struct fields.
}
resp, err := c.UpdateEntityType(ctx, req)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use resp.
_ = resp

type ExportAgentOperation Uses

type ExportAgentOperation struct {
    // contains filtered or unexported fields
}

ExportAgentOperation manages a long-running operation from ExportAgent.

func (*ExportAgentOperation) Done Uses

func (op *ExportAgentOperation) Done() bool

Done reports whether the long-running operation has completed.

func (*ExportAgentOperation) Metadata Uses

func (op *ExportAgentOperation) Metadata() (*structpbpb.Struct, error)

Metadata returns metadata associated with the long-running operation. Metadata itself does not contact the server, but Poll does. To get the latest metadata, call this method after a successful call to Poll. If the metadata is not available, the returned metadata and error are both nil.

func (*ExportAgentOperation) Name Uses

func (op *ExportAgentOperation) Name() string

Name returns the name of the long-running operation. The name is assigned by the server and is unique within the service from which the operation is created.

func (*ExportAgentOperation) Poll Uses

func (op *ExportAgentOperation) Poll(ctx context.Context, opts ...gax.CallOption) (*dialogflowpb.ExportAgentResponse, error)

Poll fetches the latest state of the long-running operation.

Poll also fetches the latest metadata, which can be retrieved by Metadata.

If Poll fails, the error is returned and op is unmodified. If Poll succeeds and the operation has completed with failure, the error is returned and op.Done will return true. If Poll succeeds and the operation has completed successfully, op.Done will return true, and the response of the operation is returned. If Poll succeeds and the operation has not completed, the returned response and error are both nil.

func (*ExportAgentOperation) Wait Uses

func (op *ExportAgentOperation) Wait(ctx context.Context, opts ...gax.CallOption) (*dialogflowpb.ExportAgentResponse, error)

Wait blocks until the long-running operation is completed, returning the response and any errors encountered.

See documentation of Poll for error-handling information.

type ImportAgentOperation Uses

type ImportAgentOperation struct {
    // contains filtered or unexported fields
}

ImportAgentOperation manages a long-running operation from ImportAgent.

func (*ImportAgentOperation) Done Uses

func (op *ImportAgentOperation) Done() bool

Done reports whether the long-running operation has completed.

func (*ImportAgentOperation) Metadata Uses

func (op *ImportAgentOperation) Metadata() (*structpbpb.Struct, error)

Metadata returns metadata associated with the long-running operation. Metadata itself does not contact the server, but Poll does. To get the latest metadata, call this method after a successful call to Poll. If the metadata is not available, the returned metadata and error are both nil.

func (*ImportAgentOperation) Name Uses

func (op *ImportAgentOperation) Name() string

Name returns the name of the long-running operation. The name is assigned by the server and is unique within the service from which the operation is created.

func (*ImportAgentOperation) Poll Uses

func (op *ImportAgentOperation) Poll(ctx context.Context, opts ...gax.CallOption) error

Poll fetches the latest state of the long-running operation.

Poll also fetches the latest metadata, which can be retrieved by Metadata.

If Poll fails, the error is returned and op is unmodified. If Poll succeeds and the operation has completed with failure, the error is returned and op.Done will return true. If Poll succeeds and the operation has completed successfully, op.Done will return true.

func (*ImportAgentOperation) Wait Uses

func (op *ImportAgentOperation) Wait(ctx context.Context, opts ...gax.CallOption) error

Wait blocks until the long-running operation is completed, returning any error encountered.

See documentation of Poll for error-handling information.

type IntentIterator Uses

type IntentIterator struct {

    // InternalFetch is for use by the Google Cloud Libraries only.
    // It is not part of the stable interface of this package.
    //
    // InternalFetch returns results from a single call to the underlying RPC.
    // The number of results is no greater than pageSize.
    // If there are no more results, nextPageToken is empty and err is nil.
    InternalFetch func(pageSize int, pageToken string) (results []*dialogflowpb.Intent, nextPageToken string, err error)
    // contains filtered or unexported fields
}

IntentIterator manages a stream of *dialogflowpb.Intent.

func (*IntentIterator) Next Uses

func (it *IntentIterator) Next() (*dialogflowpb.Intent, error)

Next returns the next result. Its second return value is iterator.Done if there are no more results. Once Next returns Done, all subsequent calls will return Done.

func (*IntentIterator) PageInfo Uses

func (it *IntentIterator) PageInfo() *iterator.PageInfo

PageInfo supports pagination. See the google.golang.org/api/iterator package for details.

type IntentsCallOptions Uses

type IntentsCallOptions struct {
    ListIntents        []gax.CallOption
    GetIntent          []gax.CallOption
    CreateIntent       []gax.CallOption
    UpdateIntent       []gax.CallOption
    DeleteIntent       []gax.CallOption
    BatchUpdateIntents []gax.CallOption
    BatchDeleteIntents []gax.CallOption
}

IntentsCallOptions contains the retry settings for each method of IntentsClient.

type IntentsClient Uses

type IntentsClient struct {

    // LROClient is used internally to handle longrunning operations.
    // It is exposed so that its CallOptions can be modified if required.
    // Users should not Close this client.
    LROClient *lroauto.OperationsClient

    // The call options for this service.
    CallOptions *IntentsCallOptions
    // contains filtered or unexported fields
}

IntentsClient is a client for interacting with Dialogflow API.

Methods, except Close, may be called concurrently. However, fields must not be modified concurrently with method calls.

func NewIntentsClient Uses

func NewIntentsClient(ctx context.Context, opts ...option.ClientOption) (*IntentsClient, error)

NewIntentsClient creates a new intents client.

An intent represents a mapping between input from a user and an action to be taken by your application. When you pass user input to the [DetectIntent][google.cloud.dialogflow.v2.Sessions.DetectIntent] (or [StreamingDetectIntent][google.cloud.dialogflow.v2.Sessions.StreamingDetectIntent]) method, the Dialogflow API analyzes the input and searches for a matching intent. If no match is found, the Dialogflow API returns a fallback intent (`is_fallback` = true).

You can provide additional information for the Dialogflow API to use to match user input to an intent by adding the following to your intent.

* **Contexts** - provide additional context for intent analysis. For

example, if an intent is related to an object in your application that
plays music, you can provide a context to determine when to match the
intent if the user input is “turn it off”.  You can include a context
that matches the intent when there is previous user input of
"play music", and not when there is previous user input of
"turn on the light".

* **Events** - allow for matching an intent by using an event name

instead of user input. Your application can provide an event name and
related parameters to the Dialogflow API to match an intent. For
example, when your application starts, you can send a welcome event
with a user name parameter to the Dialogflow API to match an intent with
a personalized welcome message for the user.

* **Training phrases** - provide examples of user input to train the

Dialogflow API agent to better match intents.

For more information about intents, see the [Dialogflow documentation](https://dialogflow.com/docs/intents).

Code:

ctx := context.Background()
c, err := dialogflow.NewIntentsClient(ctx)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use client.
_ = c

func (*IntentsClient) BatchDeleteIntents Uses

func (c *IntentsClient) BatchDeleteIntents(ctx context.Context, req *dialogflowpb.BatchDeleteIntentsRequest, opts ...gax.CallOption) (*BatchDeleteIntentsOperation, error)

BatchDeleteIntents deletes intents in the specified agent.

Operation <response: [google.protobuf.Empty][google.protobuf.Empty]>

Code:

ctx := context.Background()
c, err := dialogflow.NewIntentsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.BatchDeleteIntentsRequest{
    // TODO: Fill request struct fields.
}
op, err := c.BatchDeleteIntents(ctx, req)
if err != nil {
    // TODO: Handle error.
}

err = op.Wait(ctx)
// TODO: Handle error.

func (*IntentsClient) BatchDeleteIntentsOperation Uses

func (c *IntentsClient) BatchDeleteIntentsOperation(name string) *BatchDeleteIntentsOperation

BatchDeleteIntentsOperation returns a new BatchDeleteIntentsOperation from a given name. The name must be that of a previously created BatchDeleteIntentsOperation, possibly from a different process.

func (*IntentsClient) BatchUpdateIntents Uses

func (c *IntentsClient) BatchUpdateIntents(ctx context.Context, req *dialogflowpb.BatchUpdateIntentsRequest, opts ...gax.CallOption) (*BatchUpdateIntentsOperation, error)

BatchUpdateIntents updates/Creates multiple intents in the specified agent.

Operation <response: [BatchUpdateIntentsResponse][google.cloud.dialogflow.v2.BatchUpdateIntentsResponse]>

Code:

ctx := context.Background()
c, err := dialogflow.NewIntentsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.BatchUpdateIntentsRequest{
    // TODO: Fill request struct fields.
}
op, err := c.BatchUpdateIntents(ctx, req)
if err != nil {
    // TODO: Handle error.
}

resp, err := op.Wait(ctx)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use resp.
_ = resp

func (*IntentsClient) BatchUpdateIntentsOperation Uses

func (c *IntentsClient) BatchUpdateIntentsOperation(name string) *BatchUpdateIntentsOperation

BatchUpdateIntentsOperation returns a new BatchUpdateIntentsOperation from a given name. The name must be that of a previously created BatchUpdateIntentsOperation, possibly from a different process.

func (*IntentsClient) Close Uses

func (c *IntentsClient) Close() error

Close closes the connection to the API service. The user should invoke this when the client is no longer required.

func (*IntentsClient) Connection Uses

func (c *IntentsClient) Connection() *grpc.ClientConn

Connection returns the client's connection to the API service.

func (*IntentsClient) CreateIntent Uses

func (c *IntentsClient) CreateIntent(ctx context.Context, req *dialogflowpb.CreateIntentRequest, opts ...gax.CallOption) (*dialogflowpb.Intent, error)

CreateIntent creates an intent in the specified agent.

Code:

ctx := context.Background()
c, err := dialogflow.NewIntentsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.CreateIntentRequest{
    // TODO: Fill request struct fields.
}
resp, err := c.CreateIntent(ctx, req)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use resp.
_ = resp

func (*IntentsClient) DeleteIntent Uses

func (c *IntentsClient) DeleteIntent(ctx context.Context, req *dialogflowpb.DeleteIntentRequest, opts ...gax.CallOption) error

DeleteIntent deletes the specified intent.

Code:

ctx := context.Background()
c, err := dialogflow.NewIntentsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.DeleteIntentRequest{
    // TODO: Fill request struct fields.
}
err = c.DeleteIntent(ctx, req)
if err != nil {
    // TODO: Handle error.
}

func (*IntentsClient) GetIntent Uses

func (c *IntentsClient) GetIntent(ctx context.Context, req *dialogflowpb.GetIntentRequest, opts ...gax.CallOption) (*dialogflowpb.Intent, error)

GetIntent retrieves the specified intent.

Code:

ctx := context.Background()
c, err := dialogflow.NewIntentsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.GetIntentRequest{
    // TODO: Fill request struct fields.
}
resp, err := c.GetIntent(ctx, req)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use resp.
_ = resp

func (*IntentsClient) ListIntents Uses

func (c *IntentsClient) ListIntents(ctx context.Context, req *dialogflowpb.ListIntentsRequest, opts ...gax.CallOption) *IntentIterator

ListIntents returns the list of all intents in the specified agent.

Code:

ctx := context.Background()
c, err := dialogflow.NewIntentsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.ListIntentsRequest{
    // TODO: Fill request struct fields.
}
it := c.ListIntents(ctx, req)
for {
    resp, err := it.Next()
    if err == iterator.Done {
        break
    }
    if err != nil {
        // TODO: Handle error.
    }
    // TODO: Use resp.
    _ = resp
}

func (*IntentsClient) UpdateIntent Uses

func (c *IntentsClient) UpdateIntent(ctx context.Context, req *dialogflowpb.UpdateIntentRequest, opts ...gax.CallOption) (*dialogflowpb.Intent, error)

UpdateIntent updates the specified intent.

Code:

ctx := context.Background()
c, err := dialogflow.NewIntentsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.UpdateIntentRequest{
    // TODO: Fill request struct fields.
}
resp, err := c.UpdateIntent(ctx, req)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use resp.
_ = resp

type RestoreAgentOperation Uses

type RestoreAgentOperation struct {
    // contains filtered or unexported fields
}

RestoreAgentOperation manages a long-running operation from RestoreAgent.

func (*RestoreAgentOperation) Done Uses

func (op *RestoreAgentOperation) Done() bool

Done reports whether the long-running operation has completed.

func (*RestoreAgentOperation) Metadata Uses

func (op *RestoreAgentOperation) Metadata() (*structpbpb.Struct, error)

Metadata returns metadata associated with the long-running operation. Metadata itself does not contact the server, but Poll does. To get the latest metadata, call this method after a successful call to Poll. If the metadata is not available, the returned metadata and error are both nil.

func (*RestoreAgentOperation) Name Uses

func (op *RestoreAgentOperation) Name() string

Name returns the name of the long-running operation. The name is assigned by the server and is unique within the service from which the operation is created.

func (*RestoreAgentOperation) Poll Uses

func (op *RestoreAgentOperation) Poll(ctx context.Context, opts ...gax.CallOption) error

Poll fetches the latest state of the long-running operation.

Poll also fetches the latest metadata, which can be retrieved by Metadata.

If Poll fails, the error is returned and op is unmodified. If Poll succeeds and the operation has completed with failure, the error is returned and op.Done will return true. If Poll succeeds and the operation has completed successfully, op.Done will return true.

func (*RestoreAgentOperation) Wait Uses

func (op *RestoreAgentOperation) Wait(ctx context.Context, opts ...gax.CallOption) error

Wait blocks until the long-running operation is completed, returning any error encountered.

See documentation of Poll for error-handling information.

type SessionEntityTypeIterator Uses

type SessionEntityTypeIterator struct {

    // InternalFetch is for use by the Google Cloud Libraries only.
    // It is not part of the stable interface of this package.
    //
    // InternalFetch returns results from a single call to the underlying RPC.
    // The number of results is no greater than pageSize.
    // If there are no more results, nextPageToken is empty and err is nil.
    InternalFetch func(pageSize int, pageToken string) (results []*dialogflowpb.SessionEntityType, nextPageToken string, err error)
    // contains filtered or unexported fields
}

SessionEntityTypeIterator manages a stream of *dialogflowpb.SessionEntityType.

func (*SessionEntityTypeIterator) Next Uses

func (it *SessionEntityTypeIterator) Next() (*dialogflowpb.SessionEntityType, error)

Next returns the next result. Its second return value is iterator.Done if there are no more results. Once Next returns Done, all subsequent calls will return Done.

func (*SessionEntityTypeIterator) PageInfo Uses

func (it *SessionEntityTypeIterator) PageInfo() *iterator.PageInfo

PageInfo supports pagination. See the google.golang.org/api/iterator package for details.

type SessionEntityTypesCallOptions Uses

type SessionEntityTypesCallOptions struct {
    ListSessionEntityTypes  []gax.CallOption
    GetSessionEntityType    []gax.CallOption
    CreateSessionEntityType []gax.CallOption
    UpdateSessionEntityType []gax.CallOption
    DeleteSessionEntityType []gax.CallOption
}

SessionEntityTypesCallOptions contains the retry settings for each method of SessionEntityTypesClient.

type SessionEntityTypesClient Uses

type SessionEntityTypesClient struct {

    // The call options for this service.
    CallOptions *SessionEntityTypesCallOptions
    // contains filtered or unexported fields
}

SessionEntityTypesClient is a client for interacting with Dialogflow API.

Methods, except Close, may be called concurrently. However, fields must not be modified concurrently with method calls.

func NewSessionEntityTypesClient Uses

func NewSessionEntityTypesClient(ctx context.Context, opts ...option.ClientOption) (*SessionEntityTypesClient, error)

NewSessionEntityTypesClient creates a new session entity types client.

Entities are extracted from user input and represent parameters that are meaningful to your application. For example, a date range, a proper name such as a geographic location or landmark, and so on. Entities represent actionable data for your application.

Session entity types are referred to as **User** entity types and are entities that are built for an individual user such as favorites, preferences, playlists, and so on. You can redefine a session entity type at the session level.

For more information about entity types, see the [Dialogflow documentation](https://dialogflow.com/docs/entities).

Code:

ctx := context.Background()
c, err := dialogflow.NewSessionEntityTypesClient(ctx)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use client.
_ = c

func (*SessionEntityTypesClient) Close Uses

func (c *SessionEntityTypesClient) Close() error

Close closes the connection to the API service. The user should invoke this when the client is no longer required.

func (*SessionEntityTypesClient) Connection Uses

func (c *SessionEntityTypesClient) Connection() *grpc.ClientConn

Connection returns the client's connection to the API service.

func (*SessionEntityTypesClient) CreateSessionEntityType Uses

func (c *SessionEntityTypesClient) CreateSessionEntityType(ctx context.Context, req *dialogflowpb.CreateSessionEntityTypeRequest, opts ...gax.CallOption) (*dialogflowpb.SessionEntityType, error)

CreateSessionEntityType creates a session entity type.

Code:

ctx := context.Background()
c, err := dialogflow.NewSessionEntityTypesClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.CreateSessionEntityTypeRequest{
    // TODO: Fill request struct fields.
}
resp, err := c.CreateSessionEntityType(ctx, req)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use resp.
_ = resp

func (*SessionEntityTypesClient) DeleteSessionEntityType Uses

func (c *SessionEntityTypesClient) DeleteSessionEntityType(ctx context.Context, req *dialogflowpb.DeleteSessionEntityTypeRequest, opts ...gax.CallOption) error

DeleteSessionEntityType deletes the specified session entity type.

Code:

ctx := context.Background()
c, err := dialogflow.NewSessionEntityTypesClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.DeleteSessionEntityTypeRequest{
    // TODO: Fill request struct fields.
}
err = c.DeleteSessionEntityType(ctx, req)
if err != nil {
    // TODO: Handle error.
}

func (*SessionEntityTypesClient) GetSessionEntityType Uses

func (c *SessionEntityTypesClient) GetSessionEntityType(ctx context.Context, req *dialogflowpb.GetSessionEntityTypeRequest, opts ...gax.CallOption) (*dialogflowpb.SessionEntityType, error)

GetSessionEntityType retrieves the specified session entity type.

Code:

ctx := context.Background()
c, err := dialogflow.NewSessionEntityTypesClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.GetSessionEntityTypeRequest{
    // TODO: Fill request struct fields.
}
resp, err := c.GetSessionEntityType(ctx, req)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use resp.
_ = resp

func (*SessionEntityTypesClient) ListSessionEntityTypes Uses

func (c *SessionEntityTypesClient) ListSessionEntityTypes(ctx context.Context, req *dialogflowpb.ListSessionEntityTypesRequest, opts ...gax.CallOption) *SessionEntityTypeIterator

ListSessionEntityTypes returns the list of all session entity types in the specified session.

Code:

ctx := context.Background()
c, err := dialogflow.NewSessionEntityTypesClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.ListSessionEntityTypesRequest{
    // TODO: Fill request struct fields.
}
it := c.ListSessionEntityTypes(ctx, req)
for {
    resp, err := it.Next()
    if err == iterator.Done {
        break
    }
    if err != nil {
        // TODO: Handle error.
    }
    // TODO: Use resp.
    _ = resp
}

func (*SessionEntityTypesClient) UpdateSessionEntityType Uses

func (c *SessionEntityTypesClient) UpdateSessionEntityType(ctx context.Context, req *dialogflowpb.UpdateSessionEntityTypeRequest, opts ...gax.CallOption) (*dialogflowpb.SessionEntityType, error)

UpdateSessionEntityType updates the specified session entity type.

Code:

ctx := context.Background()
c, err := dialogflow.NewSessionEntityTypesClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.UpdateSessionEntityTypeRequest{
    // TODO: Fill request struct fields.
}
resp, err := c.UpdateSessionEntityType(ctx, req)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use resp.
_ = resp

type SessionsCallOptions Uses

type SessionsCallOptions struct {
    DetectIntent          []gax.CallOption
    StreamingDetectIntent []gax.CallOption
}

SessionsCallOptions contains the retry settings for each method of SessionsClient.

type SessionsClient Uses

type SessionsClient struct {

    // The call options for this service.
    CallOptions *SessionsCallOptions
    // contains filtered or unexported fields
}

SessionsClient is a client for interacting with Dialogflow API.

Methods, except Close, may be called concurrently. However, fields must not be modified concurrently with method calls.

func NewSessionsClient Uses

func NewSessionsClient(ctx context.Context, opts ...option.ClientOption) (*SessionsClient, error)

NewSessionsClient creates a new sessions client.

A session represents an interaction with a user. You retrieve user input and pass it to the [DetectIntent][google.cloud.dialogflow.v2.Sessions.DetectIntent] (or [StreamingDetectIntent][google.cloud.dialogflow.v2.Sessions.StreamingDetectIntent]) method to determine user intent and respond.

Code:

ctx := context.Background()
c, err := dialogflow.NewSessionsClient(ctx)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use client.
_ = c

func (*SessionsClient) Close Uses

func (c *SessionsClient) Close() error

Close closes the connection to the API service. The user should invoke this when the client is no longer required.

func (*SessionsClient) Connection Uses

func (c *SessionsClient) Connection() *grpc.ClientConn

Connection returns the client's connection to the API service.

func (*SessionsClient) DetectIntent Uses

func (c *SessionsClient) DetectIntent(ctx context.Context, req *dialogflowpb.DetectIntentRequest, opts ...gax.CallOption) (*dialogflowpb.DetectIntentResponse, error)

DetectIntent processes a natural language query and returns structured, actionable data as a result. This method is not idempotent, because it may cause contexts and session entity types to be updated, which in turn might affect results of future queries.

Code:

ctx := context.Background()
c, err := dialogflow.NewSessionsClient(ctx)
if err != nil {
    // TODO: Handle error.
}

req := &dialogflowpb.DetectIntentRequest{
    // TODO: Fill request struct fields.
}
resp, err := c.DetectIntent(ctx, req)
if err != nil {
    // TODO: Handle error.
}
// TODO: Use resp.
_ = resp

func (*SessionsClient) StreamingDetectIntent Uses

func (c *SessionsClient) StreamingDetectIntent(ctx context.Context, opts ...gax.CallOption) (dialogflowpb.Sessions_StreamingDetectIntentClient, error)

StreamingDetectIntent processes a natural language query in audio format in a streaming fashion and returns structured, actionable data as a result. This method is only available via the gRPC API (not REST).

Code:

ctx := context.Background()
c, err := dialogflow.NewSessionsClient(ctx)
if err != nil {
    // TODO: Handle error.
}
stream, err := c.StreamingDetectIntent(ctx)
if err != nil {
    // TODO: Handle error.
}
go func() {
    reqs := []*dialogflowpb.StreamingDetectIntentRequest{
        // TODO: Create requests.
    }
    for _, req := range reqs {
        if err := stream.Send(req); err != nil {
            // TODO: Handle error.
        }
    }
    stream.CloseSend()
}()
for {
    resp, err := stream.Recv()
    if err == io.EOF {
        break
    }
    if err != nil {
        // TODO: handle error.
    }
    // TODO: Use resp.
    _ = resp
}

type TrainAgentOperation Uses

type TrainAgentOperation struct {
    // contains filtered or unexported fields
}

TrainAgentOperation manages a long-running operation from TrainAgent.

func (*TrainAgentOperation) Done Uses

func (op *TrainAgentOperation) Done() bool

Done reports whether the long-running operation has completed.

func (*TrainAgentOperation) Metadata Uses

func (op *TrainAgentOperation) Metadata() (*structpbpb.Struct, error)

Metadata returns metadata associated with the long-running operation. Metadata itself does not contact the server, but Poll does. To get the latest metadata, call this method after a successful call to Poll. If the metadata is not available, the returned metadata and error are both nil.

func (*TrainAgentOperation) Name Uses

func (op *TrainAgentOperation) Name() string

Name returns the name of the long-running operation. The name is assigned by the server and is unique within the service from which the operation is created.

func (*TrainAgentOperation) Poll Uses

func (op *TrainAgentOperation) Poll(ctx context.Context, opts ...gax.CallOption) error

Poll fetches the latest state of the long-running operation.

Poll also fetches the latest metadata, which can be retrieved by Metadata.

If Poll fails, the error is returned and op is unmodified. If Poll succeeds and the operation has completed with failure, the error is returned and op.Done will return true. If Poll succeeds and the operation has completed successfully, op.Done will return true.

func (*TrainAgentOperation) Wait Uses

func (op *TrainAgentOperation) Wait(ctx context.Context, opts ...gax.CallOption) error

Wait blocks until the long-running operation is completed, returning any error encountered.

See documentation of Poll for error-handling information.

Package dialogflow imports 17 packages (graph). Updated 2018-07-23. Refresh now. Tools for package owners.