Gemini Enterprise for Customer Experience API

Servizio: ces.googleapis.com

Per chiamare questo servizio, ti consigliamo di utilizzare le librerie client fornite da Google. Se la tua applicazione deve utilizzare le tue librerie per chiamare questo servizio, utilizza le seguenti informazioni quando effettui le richieste API.

Documento di rilevamento

Un documento di rilevamento è una specifica leggibile da una macchina per descrivere e utilizzare le API REST. Viene utilizzato per creare librerie client, plug-in IDE e altri strumenti che interagiscono con le API di Google. Un servizio può fornire più documenti di rilevamento. Questo servizio fornisce il seguente documento di rilevamento:

Endpoint di servizio

Un endpoint di servizio è un URL di base che specifica l'indirizzo di rete di un servizio API. Un servizio potrebbe avere più endpoint di servizio. Questo servizio ha il seguente endpoint di servizio e tutti gli URI riportati di seguito sono relativi a questo endpoint di servizio:

  • https://ces.googleapis.com

Risorsa REST: v1beta.projects.locations

Metodi
get GET /v1beta/{name=projects/*/locations/*}
Recupera informazioni su una località.
getSecuritySettings GET /v1beta/{name=projects/*/locations/*/securitySettings}
Recupera le impostazioni di sicurezza per il progetto e la località.
list GET /v1beta/{name=projects/*}/locations
Elenca le informazioni sulle località supportate per questo servizio.
updateSecuritySettings PATCH /v1beta/{securitySettings.name=projects/*/locations/*/securitySettings}
Aggiorna le impostazioni di sicurezza per il progetto e la sede.

Risorsa REST: v1beta.projects.locations.apps

Metodi
create POST /v1beta/{parent=projects/*/locations/*}/apps
Crea una nuova app nel progetto e nella località specifici.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*}
Elimina l'app specificata.
executeTool POST /v1beta/{parent=projects/*/locations/*/apps/*}:executeTool
Esegue lo strumento specificato con gli argomenti indicati.
exportApp POST /v1beta/{name=projects/*/locations/*/apps/*}:exportApp
Esporta l'app specificata.
generateAppResource POST /v1beta/{parent=projects/*/locations/*/apps/*}:generateAppResource
Genera risorse specifiche (ad es.
get GET /v1beta/{name=projects/*/locations/*/apps/*}
Recupera i dettagli dell'app specificata.
getExtendedAgentCard GET /v1beta/{tenant=projects/*/locations/*/apps/*}/extendedAgentCard
Recupera la scheda dell'agente estesa per l'agente autenticato.
importApp POST /v1beta/{parent=projects/*/locations/*}/apps:importApp
Importa l'app specificata.
importEvaluations POST /v1beta/{parent=projects/*/locations/*/apps/*}:importEvaluations
Importa le valutazioni nell'app.
list GET /v1beta/{parent=projects/*/locations/*}/apps
Elenca le app nel progetto e nella località specificati.
patch PATCH /v1beta/{app.name=projects/*/locations/*/apps/*}
Aggiorna l'app specificata.
retrieveToolSchema POST /v1beta/{parent=projects/*/locations/*/apps/*}:retrieveToolSchema
Recupera lo schema dello strumento specificato.
runEvaluation POST /v1beta/{app=projects/*/locations/*/apps/*}:runEvaluation
Esegue una valutazione dell'app.
testPersonaVoice POST /v1beta/{app=projects/*/locations/*/apps/*}:testPersonaVoice
Testa la voce di una persona.

Risorsa REST: v1beta.projects.locations.apps.agents

Metodi
create POST /v1beta/{parent=projects/*/locations/*/apps/*}/agents
Crea un nuovo agente nell'app specificata.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/agents/*}
Elimina l'agente specificato.
get GET /v1beta/{name=projects/*/locations/*/apps/*/agents/*}
Recupera i dettagli dell'agente specificato.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/agents
Elenca gli agenti nell'app specificata.
patch PATCH /v1beta/{agent.name=projects/*/locations/*/apps/*/agents/*}
Aggiorna l'agente specificato.

Risorsa REST: v1beta.projects.locations.apps.changelogs

Metodi
get GET /v1beta/{name=projects/*/locations/*/apps/*/changelogs/*}
Recupera il changelog specificato.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/changelogs
Elenca i log delle modifiche dell'app specificata.

Risorsa REST: v1beta.projects.locations.apps.conversations

Metodi
batchDelete POST /v1beta/{parent=projects/*/locations/*/apps/*}/conversations:batchDelete
Elimina in batch le conversazioni specificate.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/conversations/*}
Elimina la conversazione specificata.
generateEvaluation POST /v1beta/{conversation=projects/*/locations/*/apps/*/conversations/*}:generateEvaluation
Crea una valutazione di riferimento da una conversazione.
get GET /v1beta/{name=projects/*/locations/*/apps/*/conversations/*}
Recupera i dettagli della conversazione specificata.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/conversations
Elenca le conversazioni nell'app specificata.

Risorsa REST: v1beta.projects.locations.apps.deployments

Metodi
create POST /v1beta/{parent=projects/*/locations/*/apps/*}/deployments
Crea un nuovo deployment nell'app specificata.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/deployments/*}
Elimina il deployment specificato.
get GET /v1beta/{name=projects/*/locations/*/apps/*/deployments/*}
Recupera i dettagli del deployment specificato.
getExtendedAgentCard GET /v1beta/{tenant=projects/*/locations/*/apps/*/deployments/*}/extendedAgentCard
Recupera la scheda dell'agente estesa per l'agente autenticato.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/deployments
Elenca i deployment nell'app specificata.
patch PATCH /v1beta/{deployment.name=projects/*/locations/*/apps/*/deployments/*}
Aggiorna il deployment specificato.

Risorsa REST: v1beta.projects.locations.apps.deployments.message

Metodi
send POST /v1beta/{tenant=projects/*/locations/*/apps/*/deployments/*}/message:send
Invia un messaggio a un agente.
stream POST /v1beta/{tenant=projects/*/locations/*/apps/*/deployments/*}/message:stream
Invia un messaggio di streaming a un agente, consentendo l'interazione e gli aggiornamenti di stato in tempo reale.

Risorsa REST: v1beta.projects.locations.apps.evaluationDatasets

Metodi
create POST /v1beta/{parent=projects/*/locations/*/apps/*}/evaluationDatasets
Crea un set di dati di valutazione.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/evaluationDatasets/*}
Elimina un set di dati di valutazione.
get GET /v1beta/{name=projects/*/locations/*/apps/*/evaluationDatasets/*}
Recupera i dettagli del set di dati di valutazione specificato.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/evaluationDatasets
Elenca tutti i set di dati di valutazione nella determinata app.
patch PATCH /v1beta/{evaluationDataset.name=projects/*/locations/*/apps/*/evaluationDatasets/*}
Aggiorna un set di dati di valutazione.

Risorsa REST: v1beta.projects.locations.apps.evaluationExpectations

Metodi
create POST /v1beta/{parent=projects/*/locations/*/apps/*}/evaluationExpectations
Crea un'aspettativa di valutazione.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/evaluationExpectations/*}
Elimina un'aspettativa di valutazione.
get GET /v1beta/{name=projects/*/locations/*/apps/*/evaluationExpectations/*}
Recupera i dettagli dell'aspettativa di valutazione specificata.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/evaluationExpectations
Elenca tutte le aspettative di valutazione nella determinata app.
patch PATCH /v1beta/{evaluationExpectation.name=projects/*/locations/*/apps/*/evaluationExpectations/*}
Aggiorna un'aspettativa di valutazione.

Risorsa REST: v1beta.projects.locations.apps.evaluationRuns

Metodi
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/evaluationRuns/*}
Elimina un'esecuzione della valutazione.
export POST /v1beta/{parent=projects/*/locations/*/apps/*}/evaluationRuns:export
Esporta le esecuzioni della valutazione.
get GET /v1beta/{name=projects/*/locations/*/apps/*/evaluationRuns/*}
Recupera i dettagli dell'esecuzione della valutazione specificata.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/evaluationRuns
Elenca tutte le esecuzioni di valutazione nella determinata app.

Risorsa REST: v1beta.projects.locations.apps.evaluations

Metodi
create POST /v1beta/{parent=projects/*/locations/*/apps/*}/evaluations
Crea una valutazione.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/evaluations/*}
Elimina una valutazione.
export POST /v1beta/{parent=projects/*/locations/*/apps/*}/evaluations:export
Esporta le valutazioni.
get GET /v1beta/{name=projects/*/locations/*/apps/*/evaluations/*}
Recupera i dettagli della valutazione specificata.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/evaluations
Elenca tutte le valutazioni nella determinata app.
patch PATCH /v1beta/{evaluation.name=projects/*/locations/*/apps/*/evaluations/*}
Aggiorna una valutazione.
uploadEvaluationAudio POST /v1beta/{name=projects/*/locations/*/apps/*/evaluations/*}:uploadEvaluationAudio
Carica l'audio da utilizzare nelle valutazioni dorate.

Risorsa REST: v1beta.projects.locations.apps.evaluations.results

Metodi
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/evaluations/*/results/*}
Elimina il risultato di una valutazione.
export POST /v1beta/{parent=projects/*/locations/*/apps/*/evaluations/*}/results:export
Esporta i risultati delle valutazioni.
get GET /v1beta/{name=projects/*/locations/*/apps/*/evaluations/*/results/*}
Recupera i dettagli del risultato della valutazione specificato.
list GET /v1beta/{parent=projects/*/locations/*/apps/*/evaluations/*}/results
Elenca tutti i risultati della valutazione per una determinata valutazione.
runEvaluationResultMetrics POST /v1beta/{evaluationResultId=projects/*/locations/*/apps/*/evaluations/*/results/*}:runEvaluationResultMetrics
Esegue le metriche su un risultato di valutazione esistente.

Risorsa REST: v1beta.projects.locations.apps.examples

Metodi
create POST /v1beta/{parent=projects/*/locations/*/apps/*}/examples
Crea un nuovo esempio nell'app specificata.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/examples/*}
Elimina l'esempio specificato.
get GET /v1beta/{name=projects/*/locations/*/apps/*/examples/*}
Recupera i dettagli dell'esempio specificato.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/examples
Elenca gli esempi nell'app specificata.
patch PATCH /v1beta/{example.name=projects/*/locations/*/apps/*/examples/*}
Aggiorna l'esempio specificato.

Risorsa REST: v1beta.projects.locations.apps.guardrails

Metodi
create POST /v1beta/{parent=projects/*/locations/*/apps/*}/guardrails
Crea un nuovo guardrail nell'app specificata.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/guardrails/*}
Elimina la barriera protettiva specificata.
get GET /v1beta/{name=projects/*/locations/*/apps/*/guardrails/*}
Recupera i dettagli della funzionalità di protezione specificata.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/guardrails
Elenca le misure di salvaguardia nell'app specificata.
patch PATCH /v1beta/{guardrail.name=projects/*/locations/*/apps/*/guardrails/*}
Aggiorna la barriera protettiva specificata.

Risorsa REST: v1beta.projects.locations.apps.message

Metodi
send POST /v1beta/{tenant=projects/*/locations/*/apps/*}/message:send
Invia un messaggio a un agente.
stream POST /v1beta/{tenant=projects/*/locations/*/apps/*}/message:stream
Invia un messaggio di streaming a un agente, consentendo l'interazione e gli aggiornamenti di stato in tempo reale.

Risorsa REST: v1beta.projects.locations.apps.scheduledEvaluationRuns

Metodi
create POST /v1beta/{parent=projects/*/locations/*/apps/*}/scheduledEvaluationRuns
Crea un'esecuzione di valutazione pianificata.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/scheduledEvaluationRuns/*}
Elimina un'esecuzione della valutazione pianificata.
get GET /v1beta/{name=projects/*/locations/*/apps/*/scheduledEvaluationRuns/*}
Recupera i dettagli dell'esecuzione della valutazione pianificata specificata.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/scheduledEvaluationRuns
Elenca tutte le esecuzioni di valutazione pianificate nella determinata app.
patch PATCH /v1beta/{scheduledEvaluationRun.name=projects/*/locations/*/apps/*/scheduledEvaluationRuns/*}
Aggiorna un'esecuzione di valutazione pianificata.

Risorsa REST: v1beta.projects.locations.apps.sessions

Metodi
generateChatToken POST /v1beta/{name=projects/*/locations/*/apps/*/sessions/*}:generateChatToken
Genera un token con ambito di sessione per il widget di chat per l'autenticazione con le API Session.
runSession POST /v1beta/{config.session=projects/*/locations/*/apps/*/sessions/*}:runSession
Avvia un'interazione a un solo turno con l'agente CES all'interno di una sessione.
streamRunSession POST /v1beta/{config.session=projects/*/locations/*/apps/*/sessions/*}:streamRunSession
Avvia un'interazione a un solo turno con l'agente CES.

Risorsa REST: v1beta.projects.locations.apps.tools

Metodi
create POST /v1beta/{parent=projects/*/locations/*/apps/*}/tools
Crea un nuovo strumento nell'app specificata.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/tools/*}
Elimina lo strumento specificato.
get GET /v1beta/{name=projects/*/locations/*/apps/*/tools/*}
Recupera i dettagli dello strumento specificato.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/tools
Elenca gli strumenti nell'app specificata.
patch PATCH /v1beta/{tool.name=projects/*/locations/*/apps/*/tools/*}
Aggiorna lo strumento specificato.

Risorsa REST: v1beta.projects.locations.apps.toolsets

Metodi
create POST /v1beta/{parent=projects/*/locations/*/apps/*}/toolsets
Crea un nuovo insieme di strumenti nell'app specificata.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/toolsets/*}
Elimina il set di strumenti specificato.
get GET /v1beta/{name=projects/*/locations/*/apps/*/toolsets/*}
Recupera i dettagli del set di strumenti specificato.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/toolsets
Elenca i set di strumenti nell'app specificata.
patch PATCH /v1beta/{toolset.name=projects/*/locations/*/apps/*/toolsets/*}
Aggiorna il set di strumenti specificato.
retrieveTools POST /v1beta/{toolset=projects/*/locations/*/apps/*/toolsets/*}:retrieveTools
Recupera l'elenco degli strumenti inclusi nel toolset specificato.

Risorsa REST: v1beta.projects.locations.apps.versions

Metodi
create POST /v1beta/{parent=projects/*/locations/*/apps/*}/versions
Crea una nuova versione dell'app nell'app specificata.
delete DELETE /v1beta/{name=projects/*/locations/*/apps/*/versions/*}
Elimina la versione dell'app specificata.
get GET /v1beta/{name=projects/*/locations/*/apps/*/versions/*}
Recupera i dettagli della versione dell'app specificata.
getExtendedAgentCard GET /v1beta/{tenant=projects/*/locations/*/apps/*/versions/*}/extendedAgentCard
Recupera la scheda dell'agente estesa per l'agente autenticato.
list GET /v1beta/{parent=projects/*/locations/*/apps/*}/versions
Elenca tutte le versioni dell'app specificata.
restore POST /v1beta/{name=projects/*/locations/*/apps/*/versions/*}:restore
Ripristina la versione dell'app specificata.

Risorsa REST: v1beta.projects.locations.apps.versions.message

Metodi
send POST /v1beta/{tenant=projects/*/locations/*/apps/*/versions/*}/message:send
Invia un messaggio a un agente.
stream POST /v1beta/{tenant=projects/*/locations/*/apps/*/versions/*}/message:stream
Invia un messaggio di streaming a un agente, consentendo l'interazione e gli aggiornamenti di stato in tempo reale.

Risorsa REST: v1beta.projects.locations.operations

Metodi
cancel POST /v1beta/{name=projects/*/locations/*/operations/*}:cancel
Avvia l'annullamento asincrono di un'operazione a lunga esecuzione.
delete DELETE /v1beta/{name=projects/*/locations/*/operations/*}
Elimina un'operazione a lunga esecuzione.
get GET /v1beta/{name=projects/*/locations/*/operations/*}
Recupera l'ultimo stato di un'operazione a lunga esecuzione.
list GET /v1beta/{name=projects/*/locations/*}/operations
Elenca le operazioni che corrispondono al filtro specificato nella richiesta.