Interface AgentsGrpc.AsyncService (4.47.0)

Version latest

• 4.47.0 (latest)
• 4.46.0
• 4.45.0
• 4.43.0
• 4.42.0
• 4.41.0
• 4.40.0
• 4.39.0
• 4.38.0
• 4.37.0
• 4.36.0
• 4.35.0
• 4.34.0
• 4.33.0
• 4.30.0
• 4.29.0
• 4.28.0
• 4.27.0
• 4.26.0
• 4.25.0
• 4.24.0
• 4.23.0
• 4.22.0
• 4.21.0
• 4.20.0
• 4.19.0
• 4.18.0
• 4.17.0
• 4.15.0
• 4.14.0
• 4.13.0
• 4.12.0
• 4.11.0
• 4.10.0
• 4.9.1
• 4.8.6
• 4.7.5
• 4.6.0
• 4.5.11
• 4.4.0
• 4.3.1

public static interface AgentsGrpc.AsyncService

Service for managing Agents.

Methods

deleteAgent(DeleteAgentRequest request, StreamObserver<Empty> responseObserver)

public default void deleteAgent(DeleteAgentRequest request, StreamObserver<Empty> responseObserver)

Deletes the specified agent.

Parameters
Name	Description
request	DeleteAgentRequest
responseObserver	io.grpc.stub.StreamObserver<Empty>

exportAgent(ExportAgentRequest request, StreamObserver<Operation> responseObserver)

public default void exportAgent(ExportAgentRequest request, StreamObserver<Operation> responseObserver)

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:

• metadata: An empty Struct message
• response: ExportAgentResponse

Parameters
Name	Description
request	ExportAgentRequest
responseObserver	io.grpc.stub.StreamObserver<Operation>

getAgent(GetAgentRequest request, StreamObserver<Agent> responseObserver)

public default void getAgent(GetAgentRequest request, StreamObserver<Agent> responseObserver)

Retrieves the specified agent.

Parameters
Name	Description
request	GetAgentRequest
responseObserver	io.grpc.stub.StreamObserver<Agent>

getValidationResult(GetValidationResultRequest request, StreamObserver<ValidationResult> responseObserver)

public default void getValidationResult(GetValidationResultRequest request, StreamObserver<ValidationResult> responseObserver)

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

Parameters
Name	Description
request	GetValidationResultRequest
responseObserver	io.grpc.stub.StreamObserver<ValidationResult>

importAgent(ImportAgentRequest request, StreamObserver<Operation> responseObserver)

public default void importAgent(ImportAgentRequest request, StreamObserver<Operation> responseObserver)

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.

Parameters
Name	Description
request	ImportAgentRequest
responseObserver	io.grpc.stub.StreamObserver<Operation>

restoreAgent(RestoreAgentRequest request, StreamObserver<Operation> responseObserver)

public default void restoreAgent(RestoreAgentRequest request, StreamObserver<Operation> responseObserver)

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.

Parameters
Name	Description
request	RestoreAgentRequest
responseObserver	io.grpc.stub.StreamObserver<Operation>

searchAgents(SearchAgentsRequest request, StreamObserver<SearchAgentsResponse> responseObserver)

public default void searchAgents(SearchAgentsRequest request, StreamObserver<SearchAgentsResponse> responseObserver)

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.

Parameters
Name	Description
request	SearchAgentsRequest
responseObserver	io.grpc.stub.StreamObserver<SearchAgentsResponse>

setAgent(SetAgentRequest request, StreamObserver<Agent> responseObserver)

public default void setAgent(SetAgentRequest request, StreamObserver<Agent> responseObserver)

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

Parameters
Name	Description
request	SetAgentRequest
responseObserver	io.grpc.stub.StreamObserver<Agent>

trainAgent(TrainAgentRequest request, StreamObserver<Operation> responseObserver)

public default void trainAgent(TrainAgentRequest request, StreamObserver<Operation> responseObserver)

Trains the specified agent. 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 Note: You should always train an agent prior to sending it queries. See the training documentation.

Parameters
Name	Description
request	TrainAgentRequest
responseObserver	io.grpc.stub.StreamObserver<Operation>