# Instantâneos

## Visão geral

Os instantâneos permitem-lhe empacotar os seus melhores agentes de IA — juntamente com tudo o que sabem e todas as ferramentas que utilizam — num modelo reutilizável e instalar esse modelo em qualquer uma das suas subcontas com um clique.

Perfeccione a sua configuração uma vez na sua própria conta, capture-a como um snapshot e cada novo cliente começará a partir dessa configuração comprovada em vez de uma página em branco. Também pode partilhar um snapshot com uma ligação, para que qualquer pessoa com uma conta o possa instalar.

::: walkthrough snapshots
:::

Um instantâneo inclui, por agente:

- A configuração completa do agente — instruções, playbook, personalidade, definições de comportamento e resposta, horas ativas.
- **Conhecimento** (opcional): as FAQs e fontes da base de conhecimento do agente, incluindo ficheiros carregados.
- **Ferramentas** (opcional): as funções personalizadas do agente e servidores MCP ligados.
- **Biblioteca de multimédia** (opcional): as imagens, vídeos e documentos que o agente pode enviar, com as suas instruções de envio.

Os instantâneos são **congelados no momento da captura**. Se continuar a editar o agente depois, o instantâneo não se altera — capture um novo quando pretender um modelo atualizado.

> **Contas de agência no novo espaço de trabalho de Agentes.** Os instantâneos (snapshots) existem para distribuir configurações de agentes de uma agência para as suas subcontas, pelo que a página aparece assim que a sua conta de agência estiver a funcionar no novo espaço de trabalho de Agentes (as contas são movidas automaticamente — não tem de fazer nada). As subcontas também podem receber um instantâneo assim que estiverem no espaço de trabalho de Agentes; o seletor de aplicação mostra quais estão prontas. Qualquer cliente **novo** que crie assim que a sua agência estiver no espaço de trabalho começa lá automaticamente, pelo que está pronto para receber um instantâneo de imediato — sem esperas e sem nada para ativar.

---

## Onde encontrar os instantâneos

Clique em **Instantâneos** na barra lateral principal — encontra-se logo abaixo de **Subcontas**, perto da parte inferior do menu.

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-empty.png" alt="A página de Instantâneos antes de existir qualquer instantâneo, com o botão Novo instantâneo e a explicação do estado vazio"><figcaption><p>A página de Instantâneos. Antes da sua primeira captura, o estado vazio explica o conceito e sugere <strong>Criar o seu primeiro instantâneo</strong>.</p></figcaption></figure>
:::

---

## Capturar um instantâneo

1. Abra **Snapshots** e clique em **New snapshot**.
2. Dê-lhe um nome reconhecível — por exemplo, "Kit inicial imobiliário".
3. Selecione os agentes a incluir. Pode agrupar vários agentes num único instantâneo.
4. Escolha o que acompanha:
   - **Include knowledge** — FAQs e fontes da base de conhecimento (com os respetivos ficheiros).
   - **Include tools** — funções personalizadas e servidores MCP.
   - **Include media library** — as imagens, vídeos e documentos enviáveis do agente.

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-create.png" alt="A janela Novo instantâneo com um nome preenchido, dois agentes selecionados e os interruptores Incluir conhecimento e Incluir ferramentas ligados"><figcaption><p>A janela Novo instantâneo: dê-lhe um nome, selecione os agentes e escolha se o conhecimento e as ferramentas devem ser incluídos. Os agentes são congelados exatamente como estão neste momento.</p></figcaption></figure>
:::

5. Clique em **Capturar instantâneo**. A captura pode demorar algum tempo quando é incluído muito conhecimento.

O novo instantâneo aparece na lista com um resumo do seu conteúdo:

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-list.png" alt="A lista de Instantâneos a mostrar a linha do instantâneo capturado com os seus agentes, resumo de conteúdos, hora de criação e as ações Aplicar, mudar nome e eliminar"><figcaption><p>Cada linha mostra os agentes incluídos, um resumo dos conteúdos e as ações: a estrela <strong>Novos clientes</strong> (ver abaixo), <strong>Aplicar</strong>, mudar nome (lápis) e eliminar (lixo).</p></figcaption></figure>
:::

---

## Aplicar um instantâneo

1. Clique em **Aplicar** num snapshot.
2. Selecione as contas onde pretende instalar — qualquer uma das suas subcontas ou a sua própria conta de agência (o que lhe dá uma cópia nova de tudo).

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-apply.png" alt="A janela Aplicar snapshot com a lista Instalar em mostrando a conta da agência e uma conta de cliente ambas selecionadas, o interruptor Ignorar contas que já têm este snapshot ligado e um botão Aplicar a 2 contas"><figcaption><p>A janela Aplicar. Selecione uma ou várias contas — e tome nota do lembrete: os agentes instalados começam em pausa e os calendários/OAuth devem ser ligados novamente no destino.</p></figcaption></figure>
:::

3. Clique em **Aplicar a N contas**.

É criada uma cópia nova de cada agente no instantâneo — além do seu conhecimento e ferramentas — na conta de destino. Aplicar o mesmo instantâneo duas vezes cria uma segunda cópia; nada é substituído.

### Os agentes instalados iniciam em pausa

Os agentes chegam à conta de destino **desativados**, propositadamente: alguns aspetos são específicos da conta e precisam de ser configurados no destino antes de o agente entrar em funcionamento:

- **Canais** — ligue os canais WhatsApp / Instagram / outros da própria conta de destino e aponte-os para o novo agente.
- **Calendário e marcações** — se o agente original efetuava marcações, volte a ligar um calendário na conta de destino e reative as marcações.
- **Integrações ligadas que utilizam OAuth** (por exemplo, um servidor MCP que autorizou com um botão "Ligar") — por motivos de segurança, estas ligações nunca são copiadas, pelo que a conta de destino autoriza as suas próprias. As ferramentas que utilizam uma chave de API simples continuam a funcionar imediatamente.

Assim que os canais estiverem ligados, altere o estado do agente para ativo na página **Agentes de IA** da conta de destino.

### Aplicar a vários clientes de uma só vez

A lista **Instalar em** permite-lhe selecionar tantas contas quantas desejar. Utilize **Selecionar todas as subcontas** para aplicar o modelo a toda a sua base de clientes de uma só vez e, em seguida, clique em **Aplicar a N contas**. Cada conta é processada sucessivamente e a janela mostra o resultado por conta — instalado, ignorado ou falhado com o motivo — para que uma conta que não pôde ser configurada nunca impeça as outras.

**Ignorar contas que já têm este snapshot** está ativado por predefinição: uma conta que já recebeu este snapshot exato é ignorada em vez de receber uma segunda cópia. Desative-o se pretender deliberadamente outra cópia. As cópias instaladas antes de setembro de 2026 não são reconhecidas por esta verificação, pelo que as contas com modelos aplicados antes dessa data são tratadas como novas.

---

## Instalar automaticamente um Snapshot em cada novo cliente

Se inicia sempre os clientes com a mesma configuração, não precisa de aplicar o snapshot manualmente de cada vez. Marque um snapshot como **predefinido** e cada nova conta de cliente que criar chegará com o mesmo já instalado.

1. Abra **Snapshots**.
2. Clique na estrela na coluna **Novos clientes** no snapshot que pretende.

A linha marcada com estrela apresenta um emblema de **Predefinido**. Apenas um snapshot pode ser o predefinido — marcar outro fará com que a definição mude para esse. Clique novamente na estrela para a desativar, e as novas contas voltarão a chegar vazias.

Isto aplica-se a todas as formas como uma conta de cliente é criada:

- Cria-a manualmente na página **Subcontas**.
- A sua integração cria-a através da API.
- Um cliente compra através da sua própria ligação de checkout e a sua conta é criada automaticamente.

Este último ponto é o objetivo da funcionalidade: um cliente pode pagar no seu site e chegar ao seu painel de controlo personalizado com o seu agente, base de conhecimento, ferramentas e multimédia já presentes, sem que tenha de fazer nada.

Algumas coisas que vale a pena saber:

- Os agentes instalados **iniciam em pausa**, exatamente como acontece com uma aplicação manual — primeiro liga os canais do cliente e, depois, ativa o agente.
- A instalação ocorre logo após a criação da conta. Se não for possível concluir por qualquer motivo, a conta do cliente é criada e utilizável na mesma — chega apenas vazia, e pode aplicar o snapshot manualmente.
- Eliminar o snapshot marcado com estrela limpa a predefinição automaticamente.

---

## Partilhar um Snapshot com uma Ligação

Pode entregar um snapshot a qualquer pessoa com uma conta na plataforma — uma agência parceira, um cliente que gere a sua própria conta ou a comunidade — sem que essa pessoa seja uma das suas subcontas. Nada específico da conta é transferido com o snapshot e pode parar a partilha a qualquer momento.

1. Clique em **Partilhar** num snapshot.
2. Escolha quem pode instalá-lo:
   - **Qualquer pessoa com a ligação**.
   - **Apenas membros do Champions Circle** — a ligação só funciona para contas que sejam membros da comunidade.
3. Clique em **Criar ligação** e copie-a.

Antes de enviar a ligação, leia a lista de verificação **Antes de partilhar** na mesma janela. Esta lista inclui:

- **Campos de preenchimento** que serão solicitados ao instalador (ver abaixo).
- **Funções personalizadas a rever** — o endereço web de cada função é apresentado, uma vez que aponta para os seus sistemas. Quaisquer valores de cabeçalho que a função envie (chaves API, tokens) são apagados na cópia instalada; os nomes dos cabeçalhos permanecem para que o instalador saiba o que preencher. O instalador vê a mesma lista e é instruído a rever essas funções antes de ligar o agente.
- **Servidores MCP que precisam da sua chave novamente** — as chaves API para os seus servidores MCP ligados nunca são incluídas numa instalação partilhada. Elas chegam desligadas na conta do instalador, e o instalador introduz a sua própria chave.

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-share.png" alt="A janela Partilhar este snapshot com a ligação de instalação e o botão Copiar, a escolha Quem pode instalá-lo definida como Qualquer pessoa com a ligação, a lista de verificação Antes de partilhar e as ações Nova ligação e Parar partilha"><figcaption><p>A janela Partilhar após <strong>Criar ligação</strong>: copie a ligação, escolha quem pode instalá-la, leia a lista de verificação e utilize <strong>Nova ligação</strong> ou <strong>Parar partilha</strong> quando precisar de cortar o acesso.</p></figcaption></figure>
:::

A linha mostra quantas vezes o snapshot foi instalado. **Nova ligação** dá-lhe uma ligação nova e faz com que a antiga deixe de funcionar; **Parar partilha** desativa a ligação por completo. Ambas deixam intacta qualquer cópia que já tenha sido instalada.

### Campos de preenchimento

Escreva `{{company_name}}`, `{{support_email}}`, `{{website}}`, `{{booking_link}}` ou qualquer outro `{{word}}` nas instruções, FAQs ou descrições de multimédia do agente e este tornar-se-á um campo que o instalador preenche antes da instalação. Os valores do instalador substituem os campos em todo o texto; o seu snapshot original permanece inalterado.

`{{first_name}}` e `{{personal_context}}` são as variáveis de mensagem próprias da IA, pelo que são deixadas intactas e nunca convertidas num campo de preenchimento.

---

## Instalar um Snapshot que Partilharam Consigo

Abra a ligação que lhe foi enviada enquanto tem sessão iniciada (ou inicie sessão quando solicitado — será redirecionado para a página de instalação posteriormente). Verá o nome do snapshot, quem o partilhou, os agentes que contém e o que está no seu interior, e depois:

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-install.png" alt="A página de instalação de um snapshot partilhado, mostrando o nome do snapshot, quem o partilhou, os dois agentes incluídos, o seletor de instalação com a conta do próprio instalador selecionada e o botão Instalar"><figcaption><p>A página de instalação. Pode ver o que está incluído e quem o partilhou, escolher onde o instalar e clicar em <strong>Instalar</strong>.</p></figcaption></figure>
:::

1. Preencha quaisquer campos que o autor tenha deixado para si, como o nome da sua empresa ou o website. Todos eles são opcionais.
2. Escolha onde o instalar — na sua própria conta ou numa das suas subcontas, caso gerencie uma agência.
3. Clique em **Instalar**.

Os agentes são copiados para a conta que escolheu e **iniciam em pausa**, exatamente como um snapshot aplicado a partir da página de Snapshots. Antes de os ativar:

- Ligue os seus próprios canais e aponte-os para os novos agentes.
- Reveja quaisquer funções personalizadas listadas no ecrã de confirmação — estas chamam os endereços web do autor.
- Introduza a sua própria chave em qualquer servidor MCP aí listado e, em seguida, ative-o.
- Volte a ligar um calendário se o agente marcar reuniões.

A instalação conta para o limite de agentes da sua conta, tal como qualquer outro agente que crie.

---

## Gerir Instantâneos

- **Renomear** — o ícone de lápis numa linha.
- **Eliminar** — remove o instantâneo e os seus ficheiros guardados. As contas às quais o aplicou não são afetadas: tudo o que foi instalado permanece instalado.

---

## O que não está incluído

- Ligações de canais e números de telefone (sempre específicos da conta).
- Calendários e ligações de marcações.
- Inícios de sessão OAuth para integrações ligadas.
- Contactos, conversas e histórico de conversação — os snapshots transportam a sua *configuração*, nunca dados de clientes.
- Modelos de mensagens WhatsApp (estes são aprovados por conta e devem ser recriados no destino).
- Chaves de API de servidores MCP e valores de cabeçalho de funções personalizadas, quando um snapshot é instalado a partir de uma ligação de partilha (dentro da sua própria agência, estes são copiados).

## Relacionado

- [Gerir Subcontas de Cliente](sub-accounts.md)
- [Agentes de IA](../ai-agents/ai-agents.md)