REST Resource: projects.locations.collections.engines.assistants

Resource: Assistant

Discovery Engine Assistant resource.

JSON representation 
{
  "name": string,
  "displayName": string,
  "description": string,
  "googleSearchGroundingEnabled": boolean,
  "webGroundingType": enum (WebGroundingType),
  "enabledActions": {
    string: {
      object (ActionList)
    },
    ...
  },
  "enabledTools": {
    string: {
      object (ToolList)
    },
    ...
  },
  "customerPolicy": {
    object (CustomerPolicy)
  }
}
Fields
name

string

Immutable. Resource name of the assistant. Format: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}

It must be a UTF-8 encoded string with a length limit of 1024 characters.
displayName

string

Required. The assistant display name.

It must be a UTF-8 encoded string with a length limit of 128 characters.
description

string

Optional. description for additional information. Expected to be shown on the configuration UI, not to the users of the assistant.
googleSearchGroundingEnabled
(deprecated)

boolean

Optional. Deprecated. Use webGroundingType instead.
webGroundingType

enum (WebGroundingType)

Optional. The type of web grounding to use. LINT.ThenChange(//depot/google3/google/cloud/discoveryengine/v1main/widgetConfig.proto)
enabledActions
(deprecated)

map (key: string, value: object (ActionList))

Optional. Deprecated: will be replaced by enabledTools instead. The enabled actions on this assistant. The keys are connector name, for example "projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector The values consist of admin enabled actions towards the connector instance. Admin can selectively enable multiple actions on any of the connector instances that they created in the project. For example {"jira1ConnectorName": [(actionId1, "createTicket"), (actionId2, "transferTicket")], "gmail1ConnectorName": [(actionId3, "sendEmail"),..] }
enabledTools

map (key: string, value: object (ToolList))

Optional. Note: not implemented yet. Use enabledActions instead. The enabled tools on this assistant. The keys are connector name, for example "projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector The values consist of admin enabled tools towards the connector instance. Admin can selectively enable multiple tools on any of the connector instances that they created in the project. For example {"jira1ConnectorName": [(toolId1, "createTicket"), (toolId2, "transferTicket")], "gmail1ConnectorName": [(toolId3, "sendEmail"),..] }
customerPolicy

object (CustomerPolicy)

Optional. Customer policy for the assistant.

WebGroundingType

LINT.IfChange The type of web grounding to use.

Enums
WEB_GROUNDING_TYPE_UNSPECIFIED Default, unspecified setting. This is the same as disabled.
WEB_GROUNDING_TYPE_DISABLED Web grounding is disabled.

ActionList

Deprecated: Will be replaced by ToolList instead. The enabled actions on a connector

JSON representation 
{
  "actionInfo": [
    {
      object (ActionInfo)
    }
  ]
}
Fields
actionInfo[]

object (ActionInfo)

The list of actions with corresponding action information.

ActionInfo

Deprecated: Will be replaced by ToolInfo instead. Information to identify an action.

JSON representation 
{
  "actionName": string,
  "actionDisplayName": string
}
Fields
actionName

string

The name of the action as defined by DataConnectorService.QueryAvailableActions.
actionDisplayName

string

The display name of the action.

ToolList

The enabled tools on a connector

JSON representation 
{
  "toolInfo": [
    {
      object (ToolInfo)
    }
  ]
}
Fields
toolInfo[]

object (ToolInfo)

The list of tools with corresponding tool information.

ToolInfo

Information to identify a tool.

JSON representation 
{
  "toolName": string,
  "toolDisplayName": string
}
Fields
toolName

string

The name of the tool as defined by DataConnectorService.QueryAvailableActions. Note: it's using action in the DataConnectorService apis, but they are the same as the tool here.
toolDisplayName

string

The display name of the tool.

CustomerPolicy

Customer-defined policy for the assistant.

JSON representation 
{
  "bannedPhrases": [
    {
      object (BannedPhrase)
    }
  ]
}
Fields
bannedPhrases[]

object (BannedPhrase)

Optional. List of banned phrases.

BannedPhrase

Definition of a customer-defined banned phrase. A banned phrase is not allowed to appear in the user query or the LLM response, or else the answer will be refused.

JSON representation 
{
  "phrase": string,
  "matchType": enum (BannedPhraseMatchType),
  "ignoreDiacritics": boolean
}
Fields
phrase

string

Required. The raw string content to be banned.
matchType

enum (BannedPhraseMatchType)

Optional. Match type for the banned phrase.
ignoreDiacritics

boolean

Optional. If true, diacritical marks (e.g., accents, umlauts) are ignored when matching banned phrases. For example, "cafe" would match "café".

BannedPhraseMatchType

The matching method for the banned phrase.

Enums
BANNED_PHRASE_MATCH_TYPE_UNSPECIFIED Defaults to SIMPLE_STRING_MATCH.
SIMPLE_STRING_MATCH The banned phrase matches if it is found anywhere in the text as an exact substring.
WORD_BOUNDARY_STRING_MATCH Banned phrase only matches if the pattern found in the text is surrounded by word delimiters. The phrase itself may still contain word delimiters.

Methods

create

 Creates an Assistant.

delete

 Deletes an Assistant.

get

 Gets an Assistant.

list

 Lists all Assistants under an Engine.

patch

 Updates an Assistant