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

Risorsa: Assistente

Risorsa Discovery Engine Assistant.

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

string

Immutabile. Nome risorsa dell'assistente. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}

Deve essere una stringa codificata in UTF-8 con un limite di lunghezza di 1024 caratteri.
displayName

string

Obbligatorio. Il nome visualizzato dell'assistente.

Deve essere una stringa codificata in UTF-8 con un limite di lunghezza di 128 caratteri.
description

string

Facoltativo. Descrizione per ulteriori informazioni. Previsto per essere mostrato nella UI di configurazione, non agli utenti dell'assistente.
generationConfig

object (GenerationConfig)

Facoltativo. Configurazione per la generazione della risposta dell'assistente.
googleSearchGroundingEnabled
(deprecated)

boolean

Facoltativo. Deprecato. Utilizza invece webGroundingType.
webGroundingType

enum (WebGroundingType)

Facoltativo. Il tipo di grounding web da utilizzare.
enabledActions
(deprecated)

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

Facoltativo. Deprecato: verrà sostituito da enabledTools. Le azioni attivate su questo assistente. Le chiavi sono il nome del connettore, ad esempio "projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector. I valori sono costituiti dalle azioni abilitate dall'amministratore nei confronti dell'istanza del connettore. L'amministratore può attivare in modo selettivo più azioni su una qualsiasi delle istanze del connettore create nel progetto. Ad esempio {"jira1ConnectorName": [(actionId1, "createTicket"), (actionId2, "transferTicket")], "gmail1ConnectorName": [(actionId3, "sendEmail"),..] }
enabledTools

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

Facoltativo. Nota: non ancora implementata. Utilizza invece enabledActions. Gli strumenti attivati in questo assistente. Le chiavi sono il nome del connettore, ad esempio "projects/{projectId}/locations/{locationId}/collections/{collectionId}/dataconnector. I valori sono costituiti da strumenti abilitati dall'amministratore per l'istanza del connettore. L'amministratore può attivare selettivamente più strumenti in una qualsiasi delle istanze del connettore create nel progetto. Ad esempio {"jira1ConnectorName": [(toolId1, "createTicket"), (toolId2, "transferTicket")], "gmail1ConnectorName": [(toolId3, "sendEmail"),..] }
customerPolicy

object (CustomerPolicy)

Facoltativo. Norme per i clienti per l'assistente.

GenerationConfig

Configurazione per la generazione della risposta dell'assistente.

Rappresentazione JSON 
{
  "systemInstruction": {
    object (SystemInstruction)
  },
  "defaultLanguage": string
}
Campi
systemInstruction

object (SystemInstruction)

Istruzione di sistema, nota anche come preambolo del prompt per le chiamate LLM. Vedi anche https://cloud.google.com/vertex-ai/generative-ai/docs/learn/prompts/system-instructions
defaultLanguage

string

La lingua predefinita da utilizzare per la generazione della risposta dell'assistente. Utilizza un codice lingua ISO 639-1 come en. Se non specificata, la lingua verrà rilevata automaticamente.

SystemInstruction

Istruzione di sistema, nota anche come preambolo del prompt per le chiamate LLM.

Rappresentazione JSON 
{
  "additionalSystemInstruction": string
}
Campi
additionalSystemInstruction

string

Facoltativo. Istruzione di sistema aggiuntiva che verrà aggiunta all'istruzione di sistema predefinita.

WebGroundingType

Il tipo di grounding web da utilizzare.

Enum
WEB_GROUNDING_TYPE_UNSPECIFIED Impostazione predefinita non specificata. Equivale a disattivato.
WEB_GROUNDING_TYPE_DISABLED Il grounding web è disattivato.

ActionList

Deprecato: verrà sostituito da ToolList. Le azioni abilitate su un connettore

Rappresentazione JSON 
{
  "actionInfo": [
    {
      object (ActionInfo)
    }
  ]
}
Campi
actionInfo[]

object (ActionInfo)

L'elenco delle azioni con le informazioni corrispondenti.

ActionInfo

Deprecato: verrà sostituito da ToolInfo. Informazioni per identificare un'azione.

Rappresentazione JSON 
{
  "actionName": string,
  "actionDisplayName": string
}
Campi
actionName

string

Il nome dell'azione come definito da DataConnectorService.QueryAvailableActions.
actionDisplayName

string

Il nome visualizzato dell'azione.

ToolList

Gli strumenti abilitati su un connettore

Rappresentazione JSON 
{
  "toolInfo": [
    {
      object (ToolInfo)
    }
  ]
}
Campi
toolInfo[]

object (ToolInfo)

L'elenco degli strumenti con le informazioni corrispondenti.

ToolInfo

Informazioni per identificare uno strumento.

Rappresentazione JSON 
{
  "toolName": string,
  "toolDisplayName": string
}
Campi
toolName

string

Il nome dello strumento come definito da DataConnectorService.QueryAvailableActions. Nota: utilizza action nelle API DataConnectorService, ma sono uguali a tool qui.
toolDisplayName

string

Il nome visualizzato dello strumento.

CustomerPolicy

Norme definite dal cliente per l'assistente.

Rappresentazione JSON 
{
  "bannedPhrases": [
    {
      object (BannedPhrase)
    }
  ],
  "modelArmorConfig": {
    object (ModelArmorConfig)
  }
}
Campi
bannedPhrases[]

object (BannedPhrase)

Facoltativo. Elenco delle frasi vietate.
modelArmorConfig

object (ModelArmorConfig)

Facoltativo. Configurazione di Model Armor da utilizzare per la sanitizzazione dei prompt degli utenti e delle risposte dell'assistente.

BannedPhrase

Definizione di una frase vietata definita dal cliente. Una frase vietata non può essere visualizzata nella query dell'utente o nella risposta del LLM, altrimenti la risposta verrà rifiutata.

Rappresentazione JSON 
{
  "phrase": string,
  "matchType": enum (BannedPhraseMatchType),
  "ignoreDiacritics": boolean
}
Campi
phrase

string

Obbligatorio. I contenuti della stringa non elaborata da vietare.
matchType

enum (BannedPhraseMatchType)

Facoltativo. Tipo di corrispondenza per la frase vietata.
ignoreDiacritics

boolean

Facoltativo. Se true, i segni diacritici (ad es. accenti, umlaut) vengono ignorati durante la corrispondenza con le frasi vietate. Ad esempio, "cafe" corrisponderà a "café".

BannedPhraseMatchType

Il metodo di corrispondenza per la frase vietata.

Enum
BANNED_PHRASE_MATCH_TYPE_UNSPECIFIED Il valore predefinito è SIMPLE_STRING_MATCH.
SIMPLE_STRING_MATCH La frase vietata corrisponde se viene trovata in qualsiasi punto del testo come sottostringa esatta.
WORD_BOUNDARY_STRING_MATCH La corrispondenza della frase vietata si verifica solo se il pattern trovato nel testo è racchiuso tra delimitatori di parole. La frase stessa può comunque contenere delimitatori di parole.

ModelArmorConfig

Configurazione dei modelli Model Armor definiti dal cliente da utilizzare per la sanificazione dei prompt dell'utente e delle risposte dell'assistente.

Rappresentazione JSON 
{
  "userPromptTemplate": string,
  "responseTemplate": string,
  "failureMode": enum (FailureMode)
}
Campi
userPromptTemplate

string

Facoltativo. Il nome risorsa del modello Model Armor per la sanificazione dei prompt dell'utente. Formato: projects/{project}/locations/{location}/templates/{templateId}

Se non specificato, non verrà applicata alcuna sanificazione al prompt dell'utente.
responseTemplate

string

Facoltativo. Il nome risorsa del template Model Armor per la sanificazione delle risposte dell'assistente. Formato: projects/{project}/locations/{location}/templates/{templateId}

Se non specificato, alla risposta dell'assistente non verrà applicata alcuna sanificazione.
failureMode

enum (FailureMode)

Facoltativo. Definisce la modalità di errore per la sanificazione di Model Armor.

FailureMode

Determina il comportamento quando Model Armor non riesce a elaborare una richiesta.

Enum
FAILURE_MODE_UNSPECIFIED Modalità di errore non specificata, il comportamento predefinito è FAIL_CLOSED.
FAIL_OPEN In caso di errore di elaborazione di Model Armor, la richiesta può procedere senza modifiche.
FAIL_CLOSED In caso di errore di elaborazione di Model Armor, la richiesta viene rifiutata.

Metodi

assist

 Aiuta l'utente con una query.

create

 Crea un Assistant.

delete

 Elimina un Assistant.

get

 Riceve un Assistant.

list

 Elenca tutti i Assistant in un Engine.

patch

 Aggiorna un Assistant

streamAssist

 Aiuta l'utente con una query in modalità di streaming.