Exportar e importar

Nesta página, descrevemos como exportar e importar aplicativos de agente e ferramentas individuais.

Exportação e importação de agentes

É possível exportar e importar aplicativos de agente:

  1. Abra o console do Gemini Enterprise para CX.
  2. Selecione o projeto. A lista de aplicativos de agente do seu projeto é mostrada.
  3. Clique no menu de contexto do aplicativo e selecione importar ou exportar.

Arquivo de ambiente

Ao exportar um aplicativo de agente, um arquivo chamado environment.json é incluído no diretório raiz do arquivo baixado. Esse arquivo ajuda a gerenciar configurações específicas do ambiente para seu aplicativo, como buckets do Cloud Storage, endpoints de serviço e URIs do repositório de dados.

Usar esse arquivo para exportações e importações tem as seguintes vantagens:

  • Portabilidade aprimorada:transfira aplicativos de agente entre diferentes projetos ou ambientes (por exemplo, desenvolvimento para produção) modificando um único arquivo.
  • Configuração centralizada:todas as principais dependências externas são listadas em um só lugar, simplificando o gerenciamento e oferecendo uma visão geral clara.
  • Redução de erros:minimiza o risco de erros em comparação com a edição manual de configurações em vários arquivos de recursos.
  • Compatível com automação:o formato JSON permite atualizar configurações de maneira programática usando scripts como parte de um pipeline de CI/CD.

Para atualizar as configurações específicas do ambiente:

  1. Exportar:faça o download e extraia o aplicativo do agente exportado.
  2. Modificar:abra o arquivo environment.json localizado no diretório raiz. Modifique os valores das dependências para corresponder às configurações do ambiente de destino.
  3. Importar:compacte todo o diretório, incluindo o arquivo environment.json modificado, em um novo arquivo ZIP. Importe esse novo arquivo para o ambiente de destino. O sistema aplica os valores atualizados de environment.json.

Detalhes do arquivo de ambiente

O arquivo environment.json funciona como um manifesto central para dependências externas que podem mudar entre diferentes ambientes (por exemplo, desenvolvimento, teste e produção).

Ao exportar um aplicativo de agente, o sistema identifica campos específicos do ambiente nos recursos do aplicativo. Em vez de codificar esses valores, o sistema os extrai e os coloca no arquivo environment.json. Os valores são organizados por tipo e nome do recurso. Nos arquivos de manifesto de recursos originais, esses valores extraídos são substituídos por uma variável de marcador, $env_var.

Quando você importa o aplicativo do agente, o sistema lê o arquivo environment.json. Ele encontra os marcadores de posição $env_var nos manifestos de recursos e os substitui pelos valores correspondentes do arquivo environment.json. Esse processo configura o aplicativo para o novo ambiente.

Os seguintes campos são gerenciados no arquivo environment.json:

  • ApiKeyConfig.key_name
  • ApiKeyConfig.api_key_secret_version
  • AudioRecordingConfig.gcs_bucket
  • BoostSpecs.data_stores
  • ConnectorTool.connection
  • DataStore.name
  • EngineSource.engine
  • FileSearchTool.file_corpus
  • OAuthConfig.client_secret_version
  • OAuthConfig.token_endpoint
  • OpenApiToolset.url (extraído automaticamente de OpenApiToolset.open_api_schema)
  • ServiceAccountAuthConfig.service_account
  • VertexAiRagRetrievalTool.RagResource.rag_corpus
  • VertexAiRagRetrievalTool.RagResource.rag_file_ids

Exportação e importação de ferramentas

É possível exportar e importar ferramentas individuais. Essa funcionalidade oferece duas novas opções no painel Ferramentas: Importar e Exportar.

  • Exportar:faça o download do conteúdo da ferramenta como um arquivo JSON para sua máquina local ou para o Cloud Storage.
  • Importação:use arquivos JSON locais ou armazenados no Cloud Storage para criar ou atualizar ferramentas.

Exportar uma ferramenta

Para exportar uma ferramenta:

  1. Abra o Gemini Enterprise para o console do CX e selecione seu projeto e agente.
  2. Abra o painel Ferramenta.
  3. Clique no menu de contexto da ferramenta que você quer exportar.
  4. Selecione Exportar.
  5. Na caixa de diálogo, escolha uma das seguintes opções:
    • Fazer o download:salva o arquivo JSON na sua máquina local.
    • Cloud Storage:salva o arquivo JSON em um URI do Cloud Storage especificado.

Importar uma ferramenta

Há dois fluxos de trabalho para importar uma ferramenta:

Importar para substituir

Use essa opção para modificar uma ferramenta atual. O arquivo JSON importado precisa corresponder ao mesmo tipo de ferramenta da ferramenta atual.

  1. Abra o Gemini Enterprise para o console do CX e selecione seu projeto e agente.
  2. Abra o painel Ferramenta.
  3. Clique no menu de contexto da ferramenta que você quer atualizar.
  4. Selecione Importar para substituir.
  5. Na caixa de diálogo, escolha uma das seguintes opções:
    • Fazer upload de JSON:selecione um arquivo JSON na sua máquina local.
    • Cloud Storage:insira o URI de um arquivo JSON no Cloud Storage.

Importar como novo

Use essa opção para criar uma nova ferramenta.

  1. Abra o Gemini Enterprise para o console do CX e selecione seu projeto e agente.
  2. Abra o painel Criar ferramenta.
  3. Selecione Importar como novo.
  4. Na caixa de diálogo, escolha uma das seguintes opções:
    • Fazer upload de JSON:selecione um arquivo JSON na sua máquina local.
    • Cloud Storage:insira o URI de um arquivo JSON no Cloud Storage.