> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tess.im/llms.txt
> Use this file to discover all available pages before exploring further.

# Mencionar arquivos e agentes com @ no chat

> Digite @ na caixa do chat para colocar arquivos da conversa dentro da frase como chips ou acionar outro agente sem sair do chat atual.

Ao digitar `@` na caixa de mensagem do chat, a Tess abre um menu único para referenciar **Arquivos** que já estão na conversa ou, no início de uma mensagem vazia, acionar **Agentes** sem sair do chat atual.

## Quando cada seção aparece

O conteúdo do menu muda conforme o ponto em que você digita `@` e as permissões da sua conta.

| Seção | Quando aparece | O que faz ao selecionar |
| - | - | - |
| **Arquivos** | Sempre que você digita `@` no início da mensagem ou depois de um espaço, no primeiro envio, nas mensagens seguintes e ao editar uma mensagem anterior | Insere o chip do arquivo na posição do cursor para você continuar escrevendo a frase |
| **Agentes** | Apenas quando o `@` (e a busca logo após ele, sem espaços) é o único texto na caixa principal do chat e o recurso **External Agent Chat** está ativo | Limpa o `@` do campo e direciona o turno para o agente escolhido |

## Mencionar um arquivo na frase

**1. Digite @ onde o arquivo entra na frase**

No início da mensagem ou após um espaço, digite `@`. Para filtrar a lista, continue digitando parte do nome do arquivo logo após o `@`, sem espaço. Arquivos cujo nome começa com o trecho digitado aparecem primeiro, seguidos pelos que contêm esse trecho.

**2. Identifique o arquivo pelo ícone ou miniatura**

Na seção **Arquivos**, imagens mostram uma miniatura e os demais documentos exibem o ícone do formato com a extensão preservada no final, mesmo quando o nome é longo.

**3. Escolha o item no menu**

Use as setas `↑` e `↓` e pressione `Enter`, ou clique no arquivo desejado. Pressione `Esc` ou `Tab` para fechar o menu sem inserir nada. O arquivo entra no cursor como um chip, já seguido de um espaço.

**4. Envie a mensagem**

Mencionar um arquivo que já está na conversa apenas referencia esse documento no ponto exato do texto, sem reenviar o conteúdo. Quando a Tess cita esse arquivo na resposta, ele aparece como um link com o nome do arquivo.

> [!NOTE]
>
> A lista de **Arquivos** do menu `@` reúne os anexos enviados nas mensagens da conversa e os arquivos gerados nela. Documentos cadastrados diretamente na Base de Conhecimento fixa de um agente no Agent Studio ainda são consultados pelo agente normalmente, mas não entram no menu `@` da conversa.

## Como funcionam os chips de arquivo no texto

> [card] Posição exata na frase
>
> Arquivos escolhidos com `@`, arrastados, colados (`Ctrl+V` ou `⌘V`) ou enviados em **+** > **Adicionar fotos e arquivos** aparecem como chips no cursor. Você pode arrastar um chip para outro ponto do texto.

> [card] Progresso no botão de envio
>
> Enquanto novos anexos carregam, o botão de enviar fica bloqueado, exibe um anel de progresso e informa ao passar o mouse quantos arquivos do lote já estão prontos, inclusive ao editar uma mensagem.

> [card] Remover da mensagem sem excluir
>
> Clicar no `×` de um chip tira a referência apenas daquela mensagem, sem apagar o arquivo enviado. Usar o botão **Melhorar prompt** (varinha) mantém todos os chips da mensagem.

> [card] Aviso de acesso ou falha
>
> Se você não tiver acesso a um arquivo referenciado ou a verificação falhar, passar o mouse sobre o chip explica o motivo. Remova o chip com `×` ou envie o arquivo novamente para liberar o envio.

## Acionar outro agente com @

Quando o addon **External Agent Chat** está habilitado para você no workspace, digitar `@` em uma caixa de chat vazia exibe a seção **Agentes** abaixo dos arquivos da conversa:

1. Com a caixa principal do chat vazia, digite `@` para ver os agentes recentes ou digite `@` seguido do nome para buscar.
2. Navegue com as setas do teclado ou clique no agente desejado. Agentes privados ou que não permitem menção a partir de outro chat não podem ser selecionados.
3. Escreva o seu pedido normalmente. A resposta daquele turno virá do agente selecionado, mantendo o histórico da conversa atual.

Para ativar ou conhecer mais sobre esse módulo na sua conta, veja [Addons](https://docs.tess.im/pt/addons.md).

## Exemplos práticos no chat

* `Compare @[relatorio-q3.pdf] com @[previsao-q4.xlsx] e liste as variações acima de 10%.`
* `Use o tom de voz de @[manual-marca.pdf] para reescrever a proposta abaixo.`
* `Extraia os prazos de @[contrato-fornecedor.docx] e monte uma tabela por responsável.`

Veja também: [Usando o Chat](https://docs.tess.im/pt/chat.md) · [Base de Conhecimento](https://docs.tess.im/pt/chat/kb.md) · [Arquivos Suportados](https://docs.tess.im/pt/supported-files.md) · [Addons](https://docs.tess.im/pt/addons.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.