- Recurso: DataAgent
- DataAnalyticsAgent
- Context
- DatasourceReferences
- BigQueryTableReferences
- BigQueryTableReference
- Esquema
- Campo
- DataFilter
- DataFilterType
- StudioDatasourceReferences
- StudioDatasourceReference
- LookerExploreReferences
- LookerExploreReference
- PrivateLookerInstanceInfo
- Credenciais
- OAuthCredentials
- SecretBased
- TokenBased
- ConversationOptions
- ChartOptions
- ImageOptions
- NoImage
- SvgOptions
- AnalysisOptions
- Python
- ExampleQuery
- Métodos
Recurso: DataAgent
Mensagem que descreve um objeto DataAgent.
Representação JSON |
---|
{ "name": string, "displayName": string, "description": string, "labels": { string: string, ... }, "createTime": string, "updateTime": string, "deleteTime": string, "purgeTime": string, // Union field |
Campos | |
---|---|
name |
Opcional. Identificador. O nome do recurso exclusivo de um DataAgent. Formato: Exemplo: Recomendamos que ignore a definição deste campo durante a criação do agente, uma vez que é inferido automaticamente e substituído por {parent}/dataAgents/{dataAgentId}. |
displayName |
Opcional. Nome a apresentar intuitivo.
|
description |
Opcional. Descrição do agente.
|
labels |
Opcional. Etiquetas para ajudar os utilizadores a filtrar agentes relacionados. Por exemplo, "vendas", "empresa", "etl" e assim sucessivamente. As etiquetas de notas são usadas apenas para filtragem e não para políticas. Consulte a documentação sobre etiquetas para ver mais detalhes sobre a utilização de etiquetas. Um objeto que contém uma lista de pares |
createTime |
Apenas saída. A hora em que o agente de dados foi criado. Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: |
updateTime |
Apenas saída. A hora em que o agente de dados foi atualizado pela última vez. Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: |
deleteTime |
Apenas saída. [Apenas saída] A hora em que o agente de dados foi eliminado temporariamente. Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: |
purgeTime |
Apenas saída. Data/hora em UTC em que este agente de dados é considerado expirado. Este valor é sempre fornecido na saída, independentemente do que foi enviado na entrada. Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: |
Campo de união type . O tipo de agente. Pode ser uma das seguintes opções: * Agente de estatísticas de dados. * O agente de engenharia de dados type só pode ser um dos seguintes: |
|
dataAnalyticsAgent |
Agente de análise de dados. |
DataAnalyticsAgent
Mensagem que descreve um objeto DataAnalyticsAgent.
Representação JSON |
---|
{ "stagingContext": { object ( |
Campos | |
---|---|
stagingContext |
Opcional. O contexto de preparação para o agente. Este contexto é usado para testar e validar as alterações antes da publicação. |
publishedContext |
Opcional. O contexto publicado para o agente. Este contexto é usado pela API Chat na produção. |
lastPublishedContext |
Apenas saída. O contexto publicado mais recentemente para o agente. Este é um campo só de saída preenchido pelo sistema quando o contexto publicado é atualizado. É usado para restaurar o agente para um estado anterior. |
Contexto
Uma coleção de contexto a aplicar a esta conversa
Representação JSON |
---|
{ "systemInstruction": string, "datasourceReferences": { object ( |
Campos | |
---|---|
systemInstruction |
Opcional. O ponto de entrada básico para os proprietários de dados que criam conhecimentos do domínio para o agente. Porquê: a gíria empresarial (por exemplo, As informações específicas da empresa (por exemplo, a receita desde o início do ano é calculada como…, a idade de reforma é de 65 anos nos EUA, etc.) e as instruções do sistema (por exemplo, responder como um pirata) podem ajudar o modelo a compreender o contexto empresarial em torno de uma pergunta do utilizador. |
datasourceReferences |
Obrigatório. Origens de dados disponíveis para responder à pergunta. |
options |
Opcional. Opções adicionais para a conversa. |
exampleQueries[] |
Opcional. Uma lista de consultas de exemplo, que fornece exemplos de consultas SQL relevantes e usadas com frequência, e as respetivas consultas de linguagem natural, que podem estar presentes. Atualmente, apenas é usado para origens de dados do BigQuery. |
DatasourceReferences
Uma coleção de referências a origens de dados.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união references . As origens de dados a usar. references só pode ser uma das seguintes opções: |
|
bq |
Referências a tabelas do BigQuery. |
studio |
Referências a origens de dados do Looker Studio. |
looker |
Referências a opções Explorar do Looker. |
BigQueryTableReferences
Mensagem que representa referências a tabelas do BigQuery.
Representação JSON |
---|
{
"tableReferences": [
{
object ( |
Campos | |
---|---|
tableReferences[] |
Obrigatório. Referências a tabelas do BigQuery. |
BigQueryTableReference
Mensagem que representa uma referência a uma única tabela do BigQuery.
Representação JSON |
---|
{
"projectId": string,
"datasetId": string,
"tableId": string,
"schema": {
object ( |
Campos | |
---|---|
projectId |
Obrigatório. O projeto ao qual a tabela pertence. |
datasetId |
Obrigatório. O conjunto de dados ao qual a tabela pertence. |
tableId |
Obrigatório. O ID da tabela. |
schema |
Opcional. O esquema da origem de dados. |
Esquema
O esquema de uma instância Datasource ou QueryResult.
Representação JSON |
---|
{ "fields": [ { object ( |
Campos | |
---|---|
fields[] |
Opcional. Os campos no esquema. |
description |
Opcional. Uma descrição textual do conteúdo e da finalidade da tabela. Por exemplo: "Contém informações sobre as encomendas dos clientes na nossa loja de comércio eletrónico." Atualmente, apenas é usado para origens de dados do BigQuery. |
synonyms[] |
Opcional. Uma lista de nomes alternativos ou sinónimos que podem ser usados para fazer referência à tabela. Por exemplo: ["vendas", "encomendas", "compras"]. Atualmente, apenas é usado para origens de dados do BigQuery. |
tags[] |
Opcional. Uma lista de etiquetas ou palavras-chave associadas à tabela, usadas para categorização. Por exemplo: ["transaction", "revenue", "customer_data"]. Atualmente, apenas é usado para origens de dados do BigQuery. |
displayName |
Opcional. displayName da tabela (igual à etiqueta em cloud/data_analytics/anarres/data/looker/proto/model_explore.proto), não obrigatório, atualmente apenas o Looker tem este campo. |
filters[] |
Opcional. Os filtros nos dados subjacentes da origem de dados. Atualmente, apenas usado para origens de dados do Looker. |
Campo
Um campo num esquema.
Representação JSON |
---|
{
"name": string,
"type": string,
"description": string,
"mode": string,
"synonyms": [
string
],
"tags": [
string
],
"displayName": string,
"subfields": [
{
object ( |
Campos | |
---|---|
name |
Opcional. O nome do campo. |
type |
Opcional. O tipo de campo. |
description |
Opcional. Uma breve descrição do campo. |
mode |
Opcional. O modo do campo (por exemplo, NULLABLE, REPEATED). |
synonyms[] |
Opcional. Uma lista de nomes alternativos ou sinónimos que podem ser usados para se referir a este campo. Por exemplo: ["id", "customerid", "cust_id"]. Atualmente, apenas é usado para origens de dados do BigQuery. |
tags[] |
Opcional. Uma lista de etiquetas ou palavras-chave associadas ao campo, usadas para categorização. Por exemplo: ["identifier", "customer", "pii"]. Atualmente, apenas é usado para origens de dados do BigQuery. |
displayName |
Opcional. Nome a apresentar do campo (igual à etiqueta em |
subfields[] |
Opcional. Propriedade recursiva para estruturas de esquemas aninhadas. |
category |
Opcional. Categoria do campo, não obrigatória, atualmente útil apenas para o Looker. Estamos a usar uma string para evitar depender de um pacote externo e manter este pacote autónomo. |
valueFormat |
Opcional. Apenas o Looker. Formato do valor do campo. Ref: https://cloud.google.com/looker/docs/reference/param-field-value-format |
DataFilter
Um filtro nos dados subjacentes de uma origem de dados. Documentação da sintaxe de filtros: https://cloud.google.com/looker/docs/filter-expressions
Representação JSON |
---|
{
"field": string,
"value": string,
"type": enum ( |
Campos | |
---|---|
field |
Opcional. O campo a filtrar. Por exemplo: ["event_date", "customer_id", "product_category"] |
value |
Opcional. O valor predefinido usado para este filtro se o filtro não for substituído numa consulta. Por exemplo: ["after 2024-01-01", "123", "-fashion"] |
type |
Opcional. O tipo de filtro presente numa origem de dados, como ALWAYS_FILTER. |
DataFilterType
O tipo de filtro presente numa origem de dados, como ALWAYS_FILTER.
Enumerações | |
---|---|
DATA_FILTER_TYPE_UNSPECIFIED |
O tipo de filtro não foi especificado. |
ALWAYS_FILTER |
Um filtro que o utilizador configura e que todas as consultas ao Explorar aplicam sempre por predefinição. Atualmente, apenas usado para origens de dados do Looker. |
StudioDatasourceReferences
Mensagem que representa referências a origens de dados do Looker Studio.
Representação JSON |
---|
{
"studioReferences": [
{
object ( |
Campos | |
---|---|
studioReferences[] |
As referências às origens de dados do Studio. |
StudioDatasourceReference
Mensagem que representa uma referência a uma única origem de dados do Looker Studio.
Representação JSON |
---|
{ "datasourceId": string } |
Campos | |
---|---|
datasourceId |
Obrigatório. O ID da origem de dados. |
LookerExploreReferences
Mensagem que representa referências a explorações do Looker.
Representação JSON |
---|
{ "exploreReferences": [ { object ( |
Campos | |
---|---|
exploreReferences[] |
Obrigatório. Referências a explorações do Looker. |
credentials |
Opcional. As credenciais a usar quando chamar a API Looker. Atualmente, suporta credenciais baseadas em chaves API e tokens OAuth, conforme descrito no artigo Autenticação com um SDK. |
LookerExploreReference
Mensagem que representa uma referência a uma única exploração do Looker.
Representação JSON |
---|
{ "lookmlModel": string, "explore": string, "schema": { object ( |
Campos | |
---|---|
lookmlModel |
Obrigatório. Modelo do Looker, conforme descrito em Estruturas principais do LookML. Nome do modelo do LookML. |
explore |
Obrigatório. Explorar do Looker, conforme descrito em Estruturas principais do LookML. Nome da exploração do LookML. |
schema |
Opcional. O esquema da origem de dados. |
Campo de união instance . A instância do Explorar do Looker. instance só pode ser uma das seguintes opções: |
|
lookerInstanceUri |
Obrigatório. O URL base da instância do Looker. |
privateLookerInstanceInfo |
Informações da instância do Looker privada. |
PrivateLookerInstanceInfo
Mensagem que representa as informações de uma instância privada do Looker necessárias se a instância do Looker estiver atrás de uma rede privada.
Representação JSON |
---|
{ "lookerInstanceId": string, "serviceDirectoryName": string } |
Campos | |
---|---|
lookerInstanceId |
O ID da instância do Looker. |
serviceDirectoryName |
O nome do diretório de serviços da instância do Looker. |
Credenciais
Representa diferentes formas de especificação de credenciais.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união kind . O tipo de credenciais. } kind só pode ser uma das seguintes opções: |
|
oauth |
Credenciais do OAuth. |
OAuthCredentials
Representa credenciais do OAuth.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união kind . O tipo de credenciais do OAuth. kind só pode ser uma das seguintes opções: |
|
secret |
Credenciais do OAuth baseadas em segredos. |
token |
Credenciais OAuth baseadas em tokens. |
SecretBased
O nome do segredo que contém o token de acesso. Representa credenciais OAuth baseadas em segredos.
Representação JSON |
---|
{ "clientId": string, "clientSecret": string } |
Campos | |
---|---|
clientId |
Obrigatório. Um ID de cliente OAuth. |
clientSecret |
Obrigatório. Um segredo do cliente OAuth. |
TokenBased
Leia mais sobre os tokens de acesso do Looker aqui: https://developers.looker.com/api/advanced-usage/looker-api-oauth
Representação JSON |
---|
{ "accessToken": string } |
Campos | |
---|---|
accessToken |
Obrigatório. O nome do segredo que contém o token de acesso. |
ConversationOptions
Opções para a conversa.
Representação JSON |
---|
{ "chart": { object ( |
Campos | |
---|---|
chart |
Opcional. Opções para a geração de gráficos. |
analysis |
Opcional. Opções de análise. |
ChartOptions
Opções para a geração de gráficos.
Representação JSON |
---|
{
"image": {
object ( |
Campos | |
---|---|
image |
Opcional. Quando especificado, o agente vai renderizar os gráficos gerados com o formato fornecido. A predefinição é sem imagem. |
ImageOptions
Opções para renderizar imagens de gráficos gerados.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união kind . O tipo de imagem a renderizar. kind só pode ser uma das seguintes opções: |
|
noImage |
Sem imagem. |
svg |
SVG. |
NoImage
Este tipo não tem campos.
Sem imagem.
SvgOptions
Este tipo não tem campos.
Opções SVG.
AnalysisOptions
Opções de análise.
Representação JSON |
---|
{
"python": {
object ( |
Campos | |
---|---|
python |
Opcional. Opções para a análise do Python. |
Python
Opções para a análise do Python.
Representação JSON |
---|
{ "enabled": boolean } |
Campos | |
---|---|
enabled |
Opcional. Ativar ou não a análise de Python. A predefinição é false. |
ExampleQuery
Exemplo de uma consulta SQL relevante e usada com frequência, e as respetivas consultas de linguagem natural, que podem estar presentes ou não. Atualmente, apenas é usado para origens de dados do BigQuery.
Representação JSON |
---|
{ "naturalLanguageQuestion": string, // Union field |
Campos | |
---|---|
naturalLanguageQuestion |
Opcional. Uma pergunta em linguagem natural que um utilizador pode fazer. Por exemplo: "Quantas encomendas foram feitas no mês passado?" |
Campo de união query . A consulta SQL ou do Looker que deve ser gerada para responder à consulta de linguagem natural. query só pode ser uma das seguintes opções: |
|
sqlQuery |
Opcional. A consulta SQL que deve ser gerada para responder à pergunta em linguagem natural. Por exemplo: "SELECT COUNT(*) FROM orders WHERE order_date BETWEEN '2024-01-01' AND '2024-01-31'" |
Métodos |
|
---|---|
|
Cria um novo DataAgent num determinado projeto e localização. |
|
Elimina um único DataAgent. |
|
Obtém detalhes de um único DataAgent. |
|
Obtém a Política IAM para DataAgent |
|
Lista os DataAgents num determinado projeto e localização. |
|
Lista os DataAgents acessíveis ao autor da chamada num determinado projeto e localização. |
|
Atualiza os parâmetros de um único DataAgent. |
|
Define a Política IAM para um DataAgent. |