# Administração

### Gerenciamento de função

#### <mark style="color:azul;">Gerenciamento de função: os administradores devem ter permissões baseadas na função para Acessar o AI Studio</mark>

Para Acessar o AI Studio no portal da web de uma conta Zoom, os usuários (administradores) devem ter uma função com as permissões suficientes do AI Studio. Por padrão, apenas o proprietário da conta terá acesso a este Recursos, e a função Administrador padrão deve receber essas permissões.

Para atualizar uma função com as permissões aplicáveis, siga estas etapas:

1. Como proprietário da conta Zoom ou administrador autorizado a editar funções, navegue até a [Gerenciamento de função](https://zoom.us/role#/) página no portal da web.
2. Clique no ícone de lápis ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdrt4w892b-zEM2wS7LJ91RM20YJQgpbrq4oo_aydenYlSeh5rk6riEmEw0lPlO93avV08ChLRgjAtUq_no29yJFQ0kR-dfa-L0HsTiuXhawRxaQ1WU90lKAhJPOAFQaHI7wE2A?key=8xRdbBwKrN2U2fUmgGv7Q9gQ) à direita da função que você está editando.
3. Navegue até a subseção do AI Studio e defina o acesso da função conforme desejado.
4. Repita para quaisquer funções adicionais.

<div data-with-frame="true"><figure><img src="/files/0ff6f245d50520064a993b850ee70bb880894c68" alt="An image showing an example of AI Studio roles" width="563"><figcaption><p>Exemplo de funções do AI Studio</p></figcaption></figure></div>

#### Acedendo ao AI Studio

Administradores com permissões baseadas na função suficientes podem acessar o AI Studio através do Portal web do Zoom clicando no menu AI Studio no lado esquerdo da tela, na subseção Administrador.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcPgi4MSwEjaqMywHyRNzsBXyBtelMYSZbyVFsr5jsDhuBKnt9JTkvbI4xTzV4oaE1tHJTucVcVRDaZ3EVG7vVlOMZjm1QKCvuWRputKt27eQcVIzKduYE2r5FewjiOkgGbh0FC?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Image showing how to access AI Studio in the Web Portal" width="375"><figcaption><p>Acessando o AI Studio no Portal Web</p></figcaption></figure></div>

### Licenciamento

#### <mark style="color:azul;">Licenciamento: Concedendo aos usuários Acessar aos recursos personalizados do AI Companion</mark>

Para conceder aos utilizadores finais acesso ao Custom AI Companion, os utilizadores devem ser atribuídos a uma licença de add-on do Custom AI Companion.

Os administradores da conta também podem Atribuir aos usuários licenças do Custom AI Companion, seja por provisionamento manual ou por SSO, via mapeamento de resposta SAML ou SCIM.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdt5GpwY92fM8riIzDb84ukL1UiJsXRPJdXsXbQj7F41L4ifi_WrpR9stcjsKmpINpWSD0ePBFgYpOTOR2h4p3sWTh5RuyTY7w-esi9W7_Mv3GMqTfomwMaxlPxFuyTfZ8FFQcs8w?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="An example image of assigning a Custom AI Companion License" width="563"><figcaption><p>Exemplo de atribuição de uma licença Custom AI Companion</p></figcaption></figure></div>

Consulte a Central de suporte do Zoom para obter mais informações sobre [atribuir licenças manualmente](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064911), provisionamento por meio de [mapeamento avançado de resposta SAML](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061497), ou incluindo o [parâmetro SCIM 2](https://developers.zoom.us/docs/api/scim2/#tag/user/GET/scim2/Users) para o Custom AI Companion no payload do provedor de identidade.

### Bases de Conhecimento: O que saber

Para Configurar uma Base de Conhecimento, como administrador, expanda o **AI Studio** menu no Portal web do Zoom e clique em **Conhecimento**.

#### <mark style="color:azul;">As Bases de Conhecimento são usadas para conter Fontes de Dados relevantes para cada tópico relevante</mark>

Na aba Knowledge, os administradores podem criar Bases de Conhecimento, que funcionam como pastas de nível superior para um determinado tópico, assunto ou grupo.

Por exemplo, ao criar uma Base de Conhecimento para Recursos Humanos, essa Base de Conhecimento seria preenchida com Fontes de Dados (ou seja, documentos, recursos) mais comumente usados pelo departamento de Recursos Humanos.

<div data-with-frame="true"><figure><img src="/files/98c8b9a709325a93b400985c5880bd4901addb21" alt="An image showing the interface for choosing a Knowledge Base type" width="563"><figcaption><p>Interface para escolher um tipo de Base de Conhecimento</p></figcaption></figure></div>

#### <mark style="color:azul;">**As contas são limitadas a um máximo de 100 Bases de Conhecimento**</mark>

Cada conta suporta a criação de até 100 Bases de Conhecimento distintas, oferecendo aos administradores ampla flexibilidade para organizar e categorizar fontes de conteúdo de acordo com requisitos específicos Corporativo e necessidades de governança de acesso.

#### <mark style="color:azul;">**As Bases de Conhecimento são personalizáveis com ícones, nomes e descrições exclusivos**</mark>

Ao criar uma Base de Conhecimento, os administradores podem personalizar o nome, a descrição e o ícone da Base de Conhecimento a partir de uma biblioteca de emoji.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeyXgP8R5OgyEoqB_pZ1obCiIBPunX2xFXsjAEdTvgxE3i2ZYnLCRmX_G9Q106iskmoJAOTxBnyTaGoVuEik2pIYcgaz0uZFTGgyi3wfREmMHW-DI8GCkiEkcjU5avy_wNC9iHHKA?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Example image of creating a Knowledge Base" width="375"><figcaption><p>Exemplo de criação de uma Base de Conhecimento</p></figcaption></figure></div>

#### <mark style="color:azul;">**O Acessar a uma Base de Conhecimento pode ser restrito por Grupos de usuário do Zoom, a menos que estejam sendo usadas permissões de um provedor de armazenamento em nuvem integrado**</mark>

Ao configurar o acesso a uma Base de Conhecimento, os administradores podem usar os Grupos de Usuários do Zoom para definir e restringir quais usuários dentro da sua conta estão autorizados a visualizar ou utilizar conteúdo específico. Por exemplo, uma Base de Conhecimento pode ser restrita exclusivamente a um departamento específico, como Recursos Humanos ou Engenharia.

No entanto, se a Base de Conhecimento estiver conectada por meio de um provedor de Armazenamento em nuvem de terceiros — como Google Drive ou OneDrive — e configurada para usar as permissões nativas do provedor, o acesso seguirá essas permissões. Nesses casos, o acesso do usuário definido na própria plataforma de Armazenamento em nuvem tem precedência sobre os Grupos de Usuários do Zoom.

Leitores com perguntas sobre [grupos de usuários](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0062584) são encorajados a consultar a Central de suporte do Zoom para obter mais informações.

#### <mark style="color:azul;">**Cada Base de Conhecimento é limitada a um tipo de fonte de dados**</mark>

Cada Base de Conhecimento só pode extrair dados de um tipo de fonte por vez. Isso significa que dados de um provedor de Armazenamento em nuvem de terceiros não podem ser misturados com Sincronização da Web, Uploads Diretos de Dados, Conexões de Índice de Terceiros ou qualquer combinação entre eles. Cada fonte de dados separada requer uma Base de Conhecimento separada. Por exemplo, após criar uma Base de Conhecimento a partir de uma Sincronização da Web, você não pode posteriormente adicionar documentos de Uploads Diretos de Dados nem conectá-la a um índice de terceiros.

#### <mark style="color:azul;">As Fontes de Dados são os documentos e artefatos que preenchem uma Base de Conhecimento</mark>

Depois que uma Base de Conhecimento é criada, os administradores podem preencher a “pasta” da Base de Conhecimento com as fontes de dados correspondentes relevantes para a Base de Conhecimento, como arquivos PDF, .txt, .docx e .doc.

#### <mark style="color:azul;">**Cada Base de Conhecimento suporta até 2.500 fontes, enquanto a capacidade de fontes em toda a conta é limitada a 20.000 fontes no total**</mark>

Cada Base de Conhecimento individual suporta até 2.500 fontes de dados, com um máximo combinado de 20.000 fontes em toda a conta em todas as Bases de Conhecimento. Na capacidade máxima (2.500 fontes cada), uma conta pode ter até oito Bases de Conhecimento. No entanto, o limite total de 20.000 fontes também pode ser distribuído por um número maior de Bases de Conhecimento com menos fontes cada, dependendo das necessidades específicas da sua Organização (por exemplo, 100 bases de conhecimento com 200 fontes de dados cada).

#### <mark style="color:azul;">**As Fontes de Dados são limitadas a 50 MB para cada ficheiro**</mark>

Na data de publicação deste documento, cada Fonte de Dados não deve ter mais de 50 MB de tamanho.

#### <mark style="color:azul;">**Os administradores podem testar novos dados adicionados a uma Base de Conhecimento**</mark>

Após adicionar novas Fontes de Dados a uma Base de Conhecimento, os administradores da conta podem testar a funcionalidade dela usando o Recursos de Teste. Neste ambiente de teste, os administradores podem confirmar que o AI Companion consegue referenciar corretamente as Fontes de Dados carregadas.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeRDlHYZNkuGPNAvcQ7jbs6lXANqPG_k7smLJ1xJAcyCgokLSEoGLWZCAisnCt8UTuXWYqwboOqfdS9ljE2iWPrlLd20uG0S4NUMliYpgJO0Uc0QoXM8OQbZ_CAoWER3hdQ_bWp?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Example image of testing a Knowledge Base" width="563"><figcaption><p>Exemplo de teste de uma Base de Conhecimento</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeRoE5i_dKB0uGlIBej6KtIq5H_yiZkHmSEDwy4cy3sVUjraa6lKe1bl5mCp9m7ysZpYpq-GPJ_mp5bkwSzfF0cvf3f9V1xIh3WY85gNdn66W635o9-l8Avx-r1DxXTjENJrpPjYw?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Example image of testing a Knowledge Base" width="563"><figcaption><p>Exemplo de teste de uma Base de Conhecimento</p></figcaption></figure></div>

#### <mark style="color:azul;">**As Bases de Conhecimento devem ser publicadas formalmente após a adição de novas Fontes de Dados para entrarem em vigor**</mark>

Após adicionar novas Fontes de Dados a uma Base de Conhecimento, os administradores da conta devem Publicar a Base de Conhecimento da Fonte de Dados atualizada para que as alterações entrem em vigor; caso contrário, ela permanecerá no estado de “rascunho”. Se as alterações não forem publicadas, o AI Companion não conseguirá reconhecer e utilizar as novas Fontes de Dados.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcL0uB9rpbmL-AyNrxcpjgMWalMEVrIthV-m0I1uZRJ8BjfQQf8kavREEUQijZExg3hgL6k2sWIZ9d4VCSZ3T9yXwEsHDEey_TnYy7WC9K4WUTUG0V4Fpbv96kNFNk1zoXoEOqLtg?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Example image of Publishing a Knowledge Base" width="563"><figcaption><p>Exemplo de publicação de uma Base de Conhecimento</p></figcaption></figure></div>

### Bases de Conhecimento: Carregamento Direto de Dados

Para carregar arquivos no Zoom, um usuário ou administrador com permissões suficientes deve criar ou editar uma **manual** Base de Conhecimento e carregar os arquivos apropriados. Após testar e publicar a base de conhecimento, as informações do índice estarão disponíveis para usuários licenciados do Custom AI Companion por meio de consultas do AI Companion.

### Bases de Conhecimento: Sincronização Web

Para criar ou gerenciar uma Base de Conhecimento de Sincronização Web, um usuário ou administrador deve ter permissões suficientes para gerenciar Bases de Conhecimento.

Ao criar uma nova Base de Conhecimento de Sincronização Web, o usuário seleciona o método de indexação desejado e especifica a(s) URL(s) relevante(s). Depois disso, o Zoom começará a indexar as páginas designadas. Quando o Zoom tiver indexado todas as páginas especificadas dentro da instância RAG específica do cliente, a Base de Conhecimento poderá ser testada e, em seguida, publicada para uso.

<div data-with-frame="true"><figure><img src="/files/c8a82a4f0d654166c7e4c310612bf37e71978f3b" alt="Example image of creating a Web Sync Knowledge Base" width="563"><figcaption><p>Exemplo de criação de uma Base de Conhecimento de Sincronização Web</p></figcaption></figure></div>

#### <mark style="color:azul;">**Os arquivos de Sincronização Web podem ser convertidos em artigos**</mark>

Durante o processo de criação da Base de Conhecimento de Sincronização Web, o usuário pode habilitar configurações que converterão automaticamente o conteúdo rastreado de uma página da web em formato de artigo para ajudar a melhorar a legibilidade, a indexação e a Acessibilidade do conteúdo.

### Bases de Conhecimento: Armazenamento em nuvem de terceiros

A conexão de Armazenamento em nuvem de terceiros permite que o Zoom AI Companion acesse, indexe e entregue conteúdo de plataformas de Armazenamento em nuvem de terceiros (por exemplo, Google Drive, OneDrive) a usuários autorizados dentro do Zoom. Para estabelecer uma conexão com um provedor de Armazenamento em nuvem de terceiros, o usuário ou administrador do Zoom deve ter permissões apropriadas para gerenciar Bases de Conhecimento. Além disso, é necessário um administrador com privilégios suficientes na plataforma de terceiros para autorizar certas etapas de Integrações. Esta Integrações envolve várias etapas principais, detalhadas abaixo.

#### <mark style="color:azul;">Um administrador deve autorizar um aplicativo OAuth</mark>

Ao configurar pela primeira vez a Integrações do Cloud Drive, um administrador com as permissões apropriadas inicia um fluxo de autorização OAuth através do Zoom App Marketplace. Esta integração OAuth é realizada no nível do administrador, o que significa que o administrador concede permissões em nome de toda a conta Zoom. No entanto, esta autorização no nível do administrador concede à Zoom acesso apenas aos arquivos explicitamente acessíveis ao administrador dentro da plataforma de terceiros, e não a todos os arquivos em toda a plataforma.

#### <mark style="color:azul;">O Acessar do usuário aos dados pode ser baseado em Grupos de Usuários do Zoom ou nas permissões nativas de terceiros</mark>

Depois de Conectando ao Armazenamento em nuvem plataforma, o administrador deve Escolher como as permissões de Acessar serão gerenciadas:

* **Permissões de grupo de usuário do Zoom**: Este método usa permissões baseadas exclusivamente nos Grupos de usuários internos do Zoom. O administrador especifica quais Grupos de usuários do Zoom têm permissão de Acessar os documentos selecionados de Armazenamento em nuvem, independentemente das permissões nativas do terceiro.
* **Permissões Nativas de Terceiros** : Este método permite que os administradores Configurar o Zoom para respeitar a estrutura nativa de Permissão da plataforma de terceiros (por exemplo, configurações de Acesso de usuário/grupo do Google Drive ou do OneDrive). Quando configurado, o Zoom indexa as permissões da fonte original e aplica controles de Acesso que se alinham ao modelo de autorização da plataforma externa, ajudando a manter políticas consistentes de Acesso a documentos entre plataformas.

#### <mark style="color:azul;">**As permissões de terceiros exigem o mapeamento do usuário**</mark>

Se o administrador selecionar Permissão nativas de terceiros e nunca tiver mapeado anteriormente os usuários da sua plataforma de terceiros para o Zoom, o Zoom solicitará que ele conclua um processo de mapeamento de usuários. Isso associa as contas de usuário do Zoom às contas correspondentes na plataforma de nuvem de terceiros, normalmente usando identificadores exclusivos, como endereços de e-mail. Por sua vez, essa etapa estabelece a sincronização entre o Zoom e o sistema de terceiros, permitindo que o Zoom verifique as Permissão de Acessar do usuário com base nos direitos existentes do usuário na plataforma conectada.

#### <mark style="color:azul;">Após a integração, o Zoom indexará os dados selecionados e suas Permissão</mark>

Assim que o administrador selecionar o método de Permissão apropriado, o Zoom indexa dois componentes críticos:

* **Conteúdo do Documento**: O Zoom obtém, segmenta e converte o conteúdo do documento da unidade na nuvem em um módulo RAG específico do cliente que pode fornecer resultados de pesquisa contextualmente relevantes com base no nível de Acessar e na consulta do usuário.
* **Metadados de Permissão**: O Zoom indexa metadados detalhados de Permissão dependendo do método escolhido:
  * Se estiver usando Grupos de Usuários do Zoom, o Zoom registra IDs internos de Grupo de Usuários autorizados pelo administrador para cada documento.
  * Se estiver usando Permissões nativas de terceiros, o Zoom indexa os IDs nativos de usuários e grupos da plataforma de terceiros associados ao Acessar do documento, conforme determinado por meio do processo de mapeamento de usuários.

#### <mark style="color:azul;">O Zoom verifica os níveis de Acessar do usuário antes de entregar o conteúdo correspondente</mark>

Quando um usuário executa uma consulta, o Zoom AI Companion inicialmente consulta documentos indexados com base na relevância e na correspondência preliminar de Permissão usando metadados indexados. Em seguida, o Zoom verificará as permissões do documento em relação ao repositório de permissões indexadas:

* Se as permissões forem baseadas em Grupos de Usuários do Zoom, a associação do usuário ao grupo do Zoom é validada diretamente em relação às permissões de grupo do Zoom indexadas no documento.
* Se as permissões forem baseadas em Permissões Nativas de Terceiros, o Zoom valida a associação mapeada do usuário/grupo de terceiros do usuário em relação às permissões indexadas de terceiros do documento.

Depois, apenas os documentos que passam na Verificação são fornecidos ao usuário.

#### <mark style="color:azul;">Zoom realiza a sincronização incremental e periódica de Permissão</mark>

Para manter a precisão e a segurança, o Zoom sincroniza de forma incremental e periódica os dados de Permissão da plataforma de terceiros para o armazenamento interno de Permissões do Zoom. Devido às limitações de taxa da API e às restrições de latência, o Zoom não realiza verificações de Permissão em tempo real na plataforma de terceiros durante as consultas do usuário. Em vez disso, o Zoom verifica o conjunto de dados de Permissão sincronizado mais recentemente.

{% hint style="warning" %}
**Atenção**

Zoom aumenta incrementalmente e atualiza dinamicamente as Permissões de provedores de terceiros. Na maioria dos casos, as alterações de Permissão devem Sincronizar em minutos devido às atualizações incrementais. No entanto, o tempo pode variar com base no tamanho da sua Organização. Para Organizações maiores ou durante ciclos completos de sincronização, as atualizações podem levar de 2 a 24 horas para serem concluídas. No geral, as alterações de Permissão não devem exigir mais de 24 horas para Sincronizar completamente em toda a sua Base de Conhecimento.
{% endhint %}

### Bases de Conhecimento: Índice de Terceiros

Para integrar um serviço de índice de terceiros com o AI Companion personalizado, um usuário ou administrador com permissões suficientes do Zoom App Marketplace, conforme determinado pela Função do usuário, deve autorizar e concluir a conexão com o provedor escolhido.

#### <mark style="color:azul;">Integrações do aplicativo Marketplace</mark>

Os administradores podem usar os links a seguir para Acessar as integrações do Índice de Terceiros do Zoom com [Amazon Q](https://marketplace.zoom.us/apps/g8rC9XKyQcGwS51wF-jGWg) e [Respigar](https://marketplace.zoom.us/apps/Hg6qTk87SxKy2F0aA3JRcA) no Zoom App Marketplace. Para usar este Recursos, sua conta deve ter a configuração ativada que permite que o AI Companion [acessar as fontes de dados da sua Organização](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0080255).

Depois de adicionar uma Integrações, ela aparecerá dentro de **Conhecimento** lista.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXctaVvKENHZR8uxkTjXPzAmRs2RSMsqZZFzjeHHMcgWGlVP_I4yXYpxn-bO7zl_P4wwa2OUlJmPq99Sg8FKN79bioxqYqgvtSQ-GliSVC28IbUj71Vkd-zG0bObgWgesbrdjC6o?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Image showing a Knowledge Base with Glean and Amazon Q connections" width="563"><figcaption><p>Base de Conhecimento com conexões Glean e Amazon Q</p></figcaption></figure></div>

### Avatares personalizados para Zoom Clips

Os administradores da conta podem Habilitar ou Desabilitar o uso de avatares e avatares personalizados no Portal web do Zoom. Não há outras Configurações de nível de administrador a considerar para este Recursos.

#### <mark style="color:azul;">O acesso de usuário aos Avatares pode ser configurado nos níveis de conta, grupo e usuário</mark>

Semelhante a outros recursos do Zoom, os recursos de Avatares e Avatar personalizado do AI Companion podem ser desativados na [conta](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0062734), [grupo](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0062584), e [usuário](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061300) níveis.

Os administradores podem acessar esses recursos pelo Portal web do Zoom editando as Configurações do nível apropriado, selecionando a aba AI Companion e localizando a subseção Clips.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfKG1z5x12jiW309sdbpYHjT12Kc4P6aXxwjLbaXVEtL05ccPOIbuqvCun2LFS2vAAFM-zt243gGpupA9DlcBBty8LbNq956ktHK-iemhmadfQywsMSi3vNIO8hvXNjpPmcEHZG?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="An image showing the settings for Custom Avatar" width="563"><figcaption><p>Configurações para Avatar personalizado</p></figcaption></figure></div>

### Dicionário Personalizado

Para Configurar um Dicionário personalizado como usuário ou administrador com permissões suficientes do AI Studio, expanda o menu do AI Studio dentro do Portal web do Zoom e clique em Dicionário personalizado.

#### <mark style="color:azul;">O Dicionário personalizado oferece suporte tanto à edição manual quanto à importação/exportação baseada em CSV</mark>

Os administradores da conta podem gerir o dicionário personalizado da sua conta através de dois métodos: gestão manual ou importação/exportação via CSV dentro do AI Studio.

**Gestão Manual**

Para Adicionar manualmente palavras a um dicionário personalizado, clique no botão + Adicionar manualmente. No pop-up, Inserir uma palavra em cada linha, separada por uma quebra de linha.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeBOr76QQyFVw_x7I0wMUsUUPby6vUQt3jXxpIUskC5Lt0aU02R10RMPZbIVKtd8IkYA2Bq-He9jO-6-V8K96-ce8nSBwAOui0x_JD--ICCaV4c_VkZoA04oLwXhmCQD-aeks32jA?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="An image showing how to manually add words to a Custom Dictionary" width="563"><figcaption><p>Adicionando manualmente palavras a um Dicionário Personalizado</p></figcaption></figure></div>

Para eliminar manualmente uma palavra do dicionário, clique no ícone do caixote do lixo ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcTbYFZt-GEW3c7gPHrLxq0KsioX6XX2uEePczogg0OBHVtrOacYMmi39YX9gpiAaxkadPeSa79uyOk8uxoKvct6n1zVEar1MOZ4hn3NTqyce6NqmSzyjSEGY0zMHCB8XMiiBQFzQ?key=8xRdbBwKrN2U2fUmgGv7Q9gQ).

**Importação/Exportação de CSV**

Para criar ou atualizar um dicionário personalizado em massa, carregue um ficheiro CSV com todas as palavras novas numa única coluna do documento (por exemplo, Coluna A).

Antes de modificar um dicionário personalizado via CSV, os administradores da conta são incentivados a exportar e guardar uma cópia antes de fazer quaisquer alterações. Ao carregar o ficheiro, os administradores da conta serão solicitados a Adicionar ao ou substituir o dicionário pelo ficheiro. No Evento de um clique incorreto, a cópia guardada anteriormente pode ser usada como backup.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe7JJgH5pRFlN_1cQhQ6C8BgWV67HwsI4YQK3UnK6OvzaQ_eZRx6kJbH9k5p5sE2Uzx5qPC8ysgX2bli3Ac8E3BJC1LXEk4fBH7nKQQLHwpowDjeZGOOBJw-viDLgtbeNVNDlI9Ww?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="An image showing CSV import options" width="375"><figcaption><p>Opções de Importação de CSV</p></figcaption></figure></div>

#### <mark style="color:azul;">Depois de atualizar o Dicionário Personalizado, os administradores da conta podem testar para confirmar que as novas palavras são reconhecidas usando um ficheiro pré-gravado ou uma gravação ad hoc</mark>

Após adicionar palavras adicionais ao Dicionário Personalizado da conta, os administradores da conta podem testar o desempenho do reconhecimento do Zoom AI Companion das novas palavras, seja carregando um ficheiro de áudio pré-gravado ou fazendo uma gravação de áudio ad hoc usando a ferramenta no navegador.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe8FapHwTHohDGAUNfIJwjMWynpbyBtJrv4oWG_nBCDqsv7e5w4-_jp_A9Y2PCx3AsK8MZUT7wfG1tiVpQl_kafOJujZFYUnuqq1dpwp6fxkDHggpvXVYei8Syr6OndsSvA7wxP?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Image showing how to test a custom dictionary" width="375"><figcaption><p>Testando um dicionário personalizado</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeNGWDpzAGKSOX_9LO8LHCws3wU8GtZuafuQiDablof9GNxPuXDvuc9gQ_cOlCUZiQEN-7JShfQF0K5IC3ULQucQ1P9S-8JdfwuGOdr2DtuHpKl5_JyvQVuHovDbOn-5E0N7AnhFw?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="An image showing a detected Custom Dictionary word in bold" width="375"><figcaption><p>As palavras do dicionário personalizado ficam a negrito quando são detetadas em testes</p></figcaption></figure></div>

#### <mark style="color:azul;">O Dicionário Personalizado deve ser publicado formalmente antes que novas palavras sejam reconhecidas pelo AI Companion</mark>

Depois de adicionar novas palavras a um Dicionário Personalizado, os administradores de conta devem Publicar as alterações para que entrem em vigor. A falha ao Publicar pode resultar na falha do AI Companion em reconhecer novos termos. Depois de publicado, o AI Companion utilizará o Dicionário Personalizado para melhorar a precisão da transcrição em todas as reuniões futuras para utilizadores com o add-on do Custom AI Companion.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXciRxfi-429E-xgQlXFArsRishxxbWSB0Cga4_6TmXWBmO4K2Lp-zgV193WhIXpLQPS4ncqaDo3-4goqhkoDvdBHIZEP6U0HYudlRpE8LJYcGD8yHh1TDXn70Kvijz1eILY8Unx?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="An image showing how to publish a Custom Dictionary" width="375"><figcaption><p>Publicar dicionário personalizado</p></figcaption></figure></div>

#### <mark style="color:azul;">As contas estão atualmente limitadas a um dicionário personalizado</mark>

Na data de publicação deste documento, as contas estão atualmente limitadas a um dicionário personalizado por vez. Fale com a equipe da sua conta Zoom para obter mais informações.

### Modelos personalizados de resumo da reunião

A seção Modelos Personalizados de Resumo da Reunião é onde usuários da conta ou administradores com acesso ao AI Studio podem criar modelos personalizados de resumo da reunião.

#### <mark style="color:azul;">Os administradores criam resumos personalizados da reunião inserindo um breve prompt, que a IA generativa expande em um modelo de resumo adaptado com base no tópico</mark>

Ao criar um resumo personalizado da reunião, os administradores inserem um breve prompt descrevendo o tipo de reunião — como “Análise corporativa trimestral” — e a IA generativa usa essa entrada para criar um modelo de resumo personalizado da reunião. Por exemplo, a estrutura resultante pode incluir seções para desempenho financeiro, progresso em relação às metas, principais desafios e próximos passos, facilitando a captura dos insights mais relevantes para esse tipo de reunião.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcesV2rkgjF6o642qYPaibMV5d29v5Wodsd2b6efg1tkGW3entj30Qwa2YKFvNeD932dF1phplfSU4Whmrwh1xoRsWp_bVplsLJMsxMrHQ2enzHp0DY3wXqFboSPWp72cLgErKY0w?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Example image of generating a new Custom Meeting Summary Template from a prompt" width="375"><figcaption><p>Exemplo de geração de um novo modelo de resumo personalizado da reunião a partir de um prompt</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeGWRi6sAn9wwh_2LY5ogqisdZV4t5X_w2-QvZjSmiDeBsCFzlORYroZg0P818P9cbR3VhC4mpP4AyoJsYPvXk9l_fuJhaKPRW7MQlsV5gurk4g1Jr8IgkK-9Qu1X9vBF3IA7sbAA?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Example image of Custom Meeting Summary Template Sections" width="563"><figcaption><p>Exemplo de seções do modelo de resumo personalizado da reunião</p></figcaption></figure></div>

#### <mark style="color:azul;">Os administradores podem personalizar a lista de tópicos do resumo da reunião, incluindo descrições dos tópicos que o AI Companion usará para associar o conteúdo ao resumo</mark>

Durante o processo de criação do resumo personalizado, os administradores podem personalizar a lista de tópicos do resumo definindo seções específicas e adicionando descrições que orientam como o AI Companion organiza o conteúdo da reunião. Essas descrições ajudam o AI Companion a entender que tipo de informação procurar e incluir em cada seção. Por exemplo, se um tópico do resumo for rotulado como “Riscos do projeto”, com uma descrição como “Identificar quaisquer riscos ou bloqueios potenciais mencionados durante a reunião”, o AI Companion analisará a transcrição e preencherá essa seção com conteúdo relevante. Essa flexibilidade oferece às organizações maior controle sobre como os insights da reunião são capturados e estruturados.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdkZxNk0jYwm0K4Eqx6L0-mPyMbA58i88v220uZG3U0lc-oV4L1sqKTHsKRJCMeFTrzxGum5UMTo5HrPG9mbPqUd59dcevS8bEsr2gRvXgfaapcJ4_PCVzqzOQ79aBYKyAc2KOybg?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Example image of defining the purpose of a Custom Meeting Template section" width="563"><figcaption><p>Exemplo de definição da finalidade de uma seção do modelo de resumo personalizado da reunião</p></figcaption></figure></div>

#### <mark style="color:azul;">Depois que os tópicos são criados, os administradores podem testar os modelos de resumo no AI Studio</mark>

Após confirmar a lista de tópicos do resumo, os administradores podem testar o modelo de resumo personalizado da reunião usando dados conversacionais simulados, que são então processados pelo modelo para verificar a qualidade e a consistência.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeewfIck_Gvr3It3p1b-8k0r5d4djpngEiU_gSlt-CwQE9_pxoYJRCrPmxgrNRBjr19ZR8NT8VdJ7ZIciNzfmPIgEESBATOtHRN2kAi91NdE73P-lfb7Mo64aEhYwyMLvQr-efe?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="" width="563"><figcaption></figcaption></figure></div>

<mark style="color:azul;">**Os administradores também podem testar o modelo de resumo personalizado usando uma transcrição de reunião anterior do Zoom**</mark>

Se desejado, os administradores podem testar o modelo usando uma transcrição de uma reunião anterior do Zoom para avaliar como ele se sai com conteúdo real de reuniões e analisar a qualidade do modelo personalizado de resumo da reunião. Isso é especialmente útil para refinar modelos com base nos tipos de reuniões que suas equipes realizam regularmente.

#### <mark style="color:azul;">Depois de testar o modelo, ele pode ser publicado para toda a conta ou para um subconjunto de Grupos de usuários</mark>

Quando o teste do modelo estiver concluído, ele poderá ser publicado para toda a conta ou para um subconjunto específico de Grupos de usuários do Zoom.

<div data-with-frame="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcJm1fCIMv78oLIgAfsIXlICHa1umhfLO99QC453NrN7upvx09ntYxAWNUByBDGNW4_StT2Fs3UfHJ1DEpuIr0s0EjaZZbrJ-WCqaeO43FoqIzlaUvs_PSwPKyQuwsQ7C6VClje0w?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="Example image of selecting User Groups permissions" width="563"><figcaption><p>Exemplo de seleção de permissões de Grupos de usuários</p></figcaption></figure></div>

{% hint style="info" %}
**Observação**

Os usuários devem receber uma licença do complemento Custom AI Companion para usar um modelo personalizado de resumo da reunião.
{% endhint %}

### Reuniões de Terceiros com AI Companion

Esta seção explica como ajustar as Configurações do Custom AI Companion para participar de reuniões de terceiros.

#### <mark style="color:azul;">O uso do AI Companion em Reuniões de Terceiros pode ser configurado nos níveis de Conta, Grupo e Usuário</mark>

Semelhante a outros recursos do Zoom, a capacidade do Custom AI Companion de participar de Reuniões de Terceiros pode ser desativada no [conta](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0062734), [grupo](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0062584), e [usuário](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061300) níveis.

Os administradores podem acessar esses recursos no Portal web do Zoom editando as Configurações do nível apropriado, selecionando a aba AI Companion e localizando a subseção Custom AI Companion.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeLfyEa8lnI5ux2Yhxwmy4_9htk--9IVMt5kl4B9qrKvR6ZDRAc2WxUHynfu6Zg4YIh-6022SQnhN_M2CkE56pFNyYoFMYaDnk3KWj1pASr9GKlS00vWFIZ16EF7MyqhwybQbuGPw?key=8xRdbBwKrN2U2fUmgGv7Q9gQ" alt="" width="563"><figcaption></figcaption></figure>

### Apps de terceiros

Para integrar aplicativos de terceiros com AI Companion personalizado, um usuário ou administrador com permissões suficientes do Zoom App Marketplace, conforme determinado pela Função do usuário, deve autorizar e concluir a conexão com o provedor escolhido.

#### <mark style="color:azul;">Integrações do aplicativo Marketplace</mark>

Os administradores podem pesquisar no Zoom App Marketplace integrações de AI Companion com suporte, como [Jira](https://marketplace.zoom.us/apps/wc9NSSgESB-qLJed0RSZjQ). Para usar este Recursos, a sua conta deve ter a configuração ativada que [permite que o AI Companion execute tarefas em apps de terceiros](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0080218).

### **Agentes personalizados: como criar**

#### <mark style="color:azul;">Criar um Agente Personalizado</mark>

Administradores da conta ou usuários autorizados podem criar um Agente Personalizado na **AI Studio** subseção clicando no **Agentes Personalizados** opção no Portal web do Zoom.

{% hint style="info" %}
**Observação**

Se sua conta tiver adquirido o Custom AI Companion e a opção Custom Agents não estiver disponível, um administrador da conta deve enviar um protocolo do suporte do Zoom solicitando habilitar os Recursos.
{% endhint %}

#### <mark style="color:azul;">Modelos de Agente Personalizado</mark>

Ao criar um Agente Personalizado, os administradores podem selecionar em uma lista predefinida de modelos ou começar a partir de uma configuração em branco. Os modelos oferecem uma maneira rápida de lançar uma configuração pronta para uso, alinhada a funções ou fluxos de trabalho comuns, ajudando as organizações a ampliar rapidamente os recursos de IA sem começar do zero.

Os modelos pré-criados incluem:

* **Rastreador de Tarefas de Engenharia**: Ajuda os desenvolvedores a gerenciar protocolos do suporte atribuídos e tarefas técnicas em vários sprints e projetos. Ele pesquisa e atualiza problemas, acompanha o progresso e sinaliza bugs para manter os engenheiros focados nas prioridades e nos prazos.
* **Assistente de Suporte para Entrevistas**: Ajuda os entrevistadores a se prepararem, fornecendo acesso rápido a políticas de contratação de RH, dicas de entrevista e detalhes específicos da vaga. Ele recupera descrições de cargo, analisa perfis de candidatos e lista funções em aberto em plataformas ERP.
* **Assistente de Gerenciamento de Incidentes**: Ajuda os desenvolvedores a simplificar os fluxos de trabalho de resposta a Incidente entre equipes. Ajuda as organizações a gerenciar, documentar e responder com eficiência a Incidentes de todos os níveis de gravidade ao longo do ciclo de vida do Incidente.
* **Assistente de Campanha de Marketing**: Dá suporte aos profissionais de marketing no planejamento, execução e otimização de campanhas. Simplifica a criação de campanhas, gera ideias de conteúdo e acompanha prazos importantes e métricas de desempenho.
* **Pesquisar protocolo do suporte**: Ajuda os agentes a encontrar rapidamente protocolos resolvidos anteriormente com problemas semelhantes, reduzindo o tempo de resolução e melhorando a consistência ao pesquisar o histórico de protocolos e fornecer contexto de casos anteriores.

Os modelos também são personalizáveis e podem ser criados a partir de um modelo em branco, permitindo que os administradores refinem sua finalidade, atualizem as fontes de conhecimento ou estendam as capacidades com ferramentas e prompts conforme necessário.

<div data-with-frame="true"><figure><img src="/files/1b8940c42cb21974b9d068dfa83b2dee57bf038c" alt=""><figcaption><p>Modelos de agente personalizados</p></figcaption></figure></div>

#### As Bases de Conhecimento fornecem aos Agentes Personalizados contexto especializado

Cada Agente Personalizado pode ser associado a uma ou mais Bases de Conhecimento que definem sua área de especialização. Essas Bases de Conhecimento podem incluir documentos de políticas internas, guias de produto, materiais de Integração ou esquemas de processos específicos da equipe.

Por exemplo, um Agente de Suporte poderia ser configurado para Acessar uma combinação de fontes da Central de suporte, artigos internos de TI e documentação de produto. Ao referenciar tanto o conteúdo de suporte voltado ao público quanto materiais técnicos internos — como guias de configuração, registros de problemas conhecidos ou boas práticas de configuração — o Agente Personalizado pode fornecer respostas precisas e atualizadas, alinhadas às informações mais recentes do produto. Essa abordagem combinada ajuda a garantir que as respostas sejam consistentes, confiáveis e fundamentadas nos mesmos recursos usados pelas equipes oficiais de suporte.

<div data-with-frame="true"><figure><img src="/files/b01ca4c089bccacf923a628fc29378b0e95a2b2d" alt=""><figcaption><p>Bases de conhecimento atribuídas a um Agente Personalizado</p></figcaption></figure></div>

#### As ferramentas capacitam os Agentes Personalizados a realizar ações com sistemas de terceiros

As ferramentas definem do que um Agente Personalizado é capaz de fazer além da conversa — elas são as permissões e integrações que Permitir o agente agir em seu nome.

Algumas ferramentas são integradas, como a capacidade de ler, criar ou interagir com um Zoom Doc. Outras podem ser conectadas por meio de integrações do Zoom App Marketplace usando Model Context Protocol (MCP), permitindo que Custom Agents executem ações em plataformas externas. Por exemplo:

* Criar novos problemas ou atualizar os existentes no Jira
* Recuperar e modificar registos no Salesforce
* Ver ou atualizar tarefas no Asana
* Acessar dados estruturados de sistemas internos via API

<div data-with-frame="true"><figure><img src="/files/b4d7914f4b2836cb95a951a3bfa56ebb26e408b7" alt=""><figcaption><p>Ferramentas atribuídas a um Agente Personalizado</p></figcaption></figure></div>

Os administradores também podem criar ferramentas personalizadas por meio de chamadas de API ou funções JavaScript, ou um servidor MCP para Habilitar funcionalidades específicas exclusivas da sua Organização.

**Importante**: Ao criar uma ferramenta personalizada, a descrição da ferramenta se torna especialmente importante. Ela informa ao Agente Personalizado quando e como usar essa ferramenta. Essa descrição atua como o conjunto de instruções em que o modelo se baseia para decidir se invocar a ferramenta é relevante para a solicitação de um usuário, ajudando a garantir que cada ação automatizada permaneça precisa, intencional e contextualizada.

<div data-with-frame="true"><figure><img src="/files/57a30307054146ef3e31ef5f3a06b2c745b8befa" alt=""><figcaption><p>Interface de criação de Ferramenta Personalizada</p></figcaption></figure></div>

#### <mark style="color:azul;">A descrição de um Agente Personalizado define seu comportamento e como o AI Companion o usa</mark>

Ao criar um Agente Personalizado, a descrição se torna especialmente importante — ela informa ao AI Companion o que o agente faz, quando usar suas ferramentas e como ele deve se comportar dentro de um determinado contexto. Por exemplo, incluir uma linha como “Publicar resultados no canal do Slack #Engineering” ajuda o agente a entender não apenas o que fazer, mas onde e como fazer isso. Esses detalhes orientam o raciocínio do AI Companion e moldam diretamente como ele interpreta e aplica o agente.

Uma descrição forte e bem escrita ajuda a garantir que cada ação automatizada seja precisa, intencional e alinhada com a intenção da conversa. Quanto mais clara e específica for a descrição, mais eficazmente o AI Companion poderá entender o contexto, seguir as instruções e entregar resultados que correspondam às suas expectativas.

#### <mark style="color:azul;">Os Hero Prompts facilitam a execução de tarefas comuns</mark>

Os administradores podem definir Hero Prompts — prompts pré-preenchidos que atuam como atalhos selecionados para tarefas comuns ou de alto valor que os usuários costumam executar com um Agente Personalizado. Esses prompts aparecem diretamente no painel do AI Companion, permitindo que os usuários iniciem fluxos de trabalho com um único clique.

Por exemplo, um Hero Prompt poderia:

* **Resumir a atividade de tickets do turno:** Reunir métricas sobre casos novos, resolvidos e em aberto do seu CRM, além de tendências ou problemas recorrentes.
* **Fornecer o resumo de hoje do Jira**: Recuperar todos os tickets ou relatórios de bugs criados recentemente no último dia, categorizá-los por projeto, componente ou prioridade e gerar um resumo conciso destacando tendências ou problemas recorrentes. Publicar automaticamente o resumo em um canal de mensagens designado para visibilidade da equipe.
* **Mostrar oportunidades de renovação que se encerram este mês**: Consultar dados do CRM, calcular cronogramas de renovação e destacar contas que precisam de atenção.
* **Fornecer um resumo semanal de Integração**: Listar novas contratações, tarefas concluídas no Workday e etapas pendentes de Integração.

Ao predefinir essas interações, os administradores ajudam os usuários a contornar etapas redundantes de configuração, possibilitando resultados mais rápidos e consistentes com o mínimo de entrada manual.

<div data-with-frame="true"><figure><img src="/files/fa665b2e93b479111e685465564b38abef458326" alt="" width="369"><figcaption><p>Exemplo de Hero Prompts com um Agente Personalizado</p></figcaption></figure></div>

{% hint style="info" %}
**Observação**

A capacidade de um Agente Personalizado de executar essas funções de exemplo pode ser limitada por suas Ferramentas e Descrição.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://library.zoom.com/technical-library/pt/zoom-workplace/artificial-intelligence/artificial-intelligence-bluepaper/custom-ai-companion-explainer/admin-experience.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.