Class AgentsGrpc.AgentsFutureStub (4.47.0)

public static final class AgentsGrpc.AgentsFutureStub extends AbstractFutureStub<AgentsGrpc.AgentsFutureStub>

A stub to allow clients to do ListenableFuture-style rpc calls to service Agents.

Service for managing Agents.

Inheritance

java.lang.Object > io.grpc.stub.AbstractStub > io.grpc.stub.AbstractFutureStub > AgentsGrpc.AgentsFutureStub

Methods

build(Channel channel, CallOptions callOptions)

protected AgentsGrpc.AgentsFutureStub build(Channel channel, CallOptions callOptions)
Parameters
NameDescription
channelio.grpc.Channel
callOptionsio.grpc.CallOptions
Returns
TypeDescription
AgentsGrpc.AgentsFutureStub
Overrides
io.grpc.stub.AbstractStub.build(io.grpc.Channel,io.grpc.CallOptions)

deleteAgent(DeleteAgentRequest request)

public ListenableFuture<Empty> deleteAgent(DeleteAgentRequest request)

Deletes the specified agent.

Parameter
NameDescription
requestDeleteAgentRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Empty>

exportAgent(ExportAgentRequest request)

public ListenableFuture<Operation> exportAgent(ExportAgentRequest request)

Exports the specified agent to a ZIP file. This method is a long-running operation. The returned Operation type has the following method-specific fields:

Parameter
NameDescription
requestExportAgentRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Operation>

getAgent(GetAgentRequest request)

public ListenableFuture<Agent> getAgent(GetAgentRequest request)

Retrieves the specified agent.

Parameter
NameDescription
requestGetAgentRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Agent>

getValidationResult(GetValidationResultRequest request)

public ListenableFuture<ValidationResult> getValidationResult(GetValidationResultRequest request)

Gets agent validation result. Agent validation is performed during training time and is updated automatically when training is completed.

Parameter
NameDescription
requestGetValidationResultRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<ValidationResult>

importAgent(ImportAgentRequest request)

public ListenableFuture<Operation> importAgent(ImportAgentRequest request)

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. After the import, the imported draft agent will be trained automatically (unless disabled in agent settings). However, once the import is done, training may not be completed yet. Please call TrainAgent and wait for the operation it returns in order to train explicitly. This method is a long-running operation. The returned Operation type has the following method-specific fields:

  • metadata: An empty Struct message
  • response: An Empty message The operation only tracks when importing is complete, not when it is done training. Note: You should always train an agent prior to sending it queries. See the training documentation.
Parameter
NameDescription
requestImportAgentRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Operation>

restoreAgent(RestoreAgentRequest request)

public ListenableFuture<Operation> restoreAgent(RestoreAgentRequest request)

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. After the restore, the restored draft agent will be trained automatically (unless disabled in agent settings). However, once the restore is done, training may not be completed yet. Please call TrainAgent and wait for the operation it returns in order to train explicitly. This method is a long-running operation. The returned Operation type has the following method-specific fields:

  • metadata: An empty Struct message
  • response: An Empty message The operation only tracks when restoring is complete, not when it is done training. Note: You should always train an agent prior to sending it queries. See the training documentation.
Parameter
NameDescription
requestRestoreAgentRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Operation>

searchAgents(SearchAgentsRequest request)

public ListenableFuture<SearchAgentsResponse> searchAgents(SearchAgentsRequest request)

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.

Parameter
NameDescription
requestSearchAgentsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<SearchAgentsResponse>

setAgent(SetAgentRequest request)

public ListenableFuture<Agent> setAgent(SetAgentRequest request)

Creates/updates the specified agent. Note: You should always train an agent prior to sending it queries. See the training documentation.

Parameter
NameDescription
requestSetAgentRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Agent>

trainAgent(TrainAgentRequest request)

public ListenableFuture<Operation> trainAgent(TrainAgentRequest request)

Trains the specified agent. This method is a long-running operation. The returned Operation type has the following method-specific fields:

Parameter
NameDescription
requestTrainAgentRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Operation>