---
id: "canvas.mencionar-cartoes"
titulo: "Mencionar cartões"
resumo: "Aponte um cartão dentro de uma conversa ou de um terminal do Canvas sem sair do que você estava escrevendo."
idioma: "pt-br"
tipo: "guia"
categoria: "telas"
aplicavelDesde: "0.0.16"
capabilities: ["canvas.mentions.cards"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/canvas/mencionar-cartoes/"
fonte: "pt-br/canvas/mencionar-cartoes.md"
caminhoPublico: "docs/publica/pt-br/canvas/mencionar-cartoes.md"
hashFonte: "sha256:6c79dc7b48133cb5a91e1dc4c55d4e7ef4de0af8026942f81cd5042f999ee027"
hashDestaPagina: "sha256:6c79dc7b48133cb5a91e1dc4c55d4e7ef4de0af8026942f81cd5042f999ee027"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
Quando você quer que um agente olhe para outro cartão do quadro, não precisa descrever onde ele está: dá para **apontar** para o cartão dentro do próprio texto que você está escrevendo.

## Como funciona

1. Digite **`>`** no começo de uma linha.
2. A lista de cartões aparece, com o nome, o assistente e o tipo de cada um.
3. Continue digitando para filtrar. A lista mostra no máximo **oito** opções; quando há mais, ela avisa quantos ficaram de fora.
4. Escolha com o teclado ou com o clique.

O gatilho é o `>` **no começo de uma linha** — no meio de uma frase ele é só o caractere `>`. O que você digitou como filtro é apagado junto com o `>`, e a menção entra no lugar.

## Onde funciona

| Onde | O que acontece ao escolher |
|---|---|
| **Compositor do cartão de conversa** | O texto da menção é inserido no que você está escrevendo, preservando a posição do cursor. |
| **Cartão de terminal** | A menção é **colada no terminal**, como se você a tivesse digitado. O `>` e o filtro são apagados. |

## Teclado

- **Tab** e as **setas** navegam pela lista.
- **Enter** escolhe a opção destacada.
- **Esc** fecha a lista sem inserir nada.
- **Espaço** tem papel próprio na lista, para não atrapalhar quem está escrevendo.

## Limites

- **No terminal, a menção depende de a sessão estar viva.** Se o terminal ainda não estiver pronto, aparece o aviso "Este terminal ainda não está pronto. Tente de novo em um instante." — espere e repita em vez de insistir.
- **A lista é limitada a oito opções.** Se o cartão que você quer não aparece, continue digitando: o filtro é que traz o resto, não a rolagem.
- **A menção é texto, não um vínculo.** Ela coloca o nome do cartão no que você escreveu; não cria uma linha no quadro nem avisa o outro cartão.
- **Sem equivalente na linha de comando:** mencionar é uma ação de quem está escrevendo na tela.