Como Usar Variáveis em Prompts do Copilot

Ao escrever prompts para o Copilot em aplicativos do Microsoft 365 como Word, Excel ou Outlook, você frequentemente repete o mesmo nome de projeto, intervalo de datas ou referência de cliente em várias solicitações. Essa repetição perde tempo e aumenta a chance de erros de digitação. As variáveis permitem que você defina uma única informação e a reutilize em toda uma sessão de prompt sem redigitá-la. Este artigo explica como as variáveis funcionam dentro dos prompts do Copilot, mostra a sintaxe exata a ser usada e aborda os erros comuns que quebram a substituição de variáveis.

Como as Variáveis Funcionam Dentro dos Prompts do Copilot

O Copilot no Microsoft 365 não possui um gerenciador de variáveis embutido como uma linguagem de programação. Em vez disso, as variáveis dependem do contexto da conversa. Quando você escreve um prompt que inclui um nome de variável entre chaves duplas, o Copilot lembra da definição fornecida anteriormente na mesma sessão e substitui o valor antes de gerar a resposta.

A sintaxe da variável é {{nome_da_variavel}}. O nome deve começar com uma letra e pode conter letras, números e sublinhados. Espaços e caracteres especiais diferentes de sublinhado não são permitidos. O Copilot trata o nome da variável como insensível a maiúsculas/minúsculas, então {{nome_cliente}} e {{Nome_Cliente}} se referem ao mesmo espaço reservado.

Para usar uma variável, você deve primeiro atribuir um valor a ela em um prompt anterior dentro da mesma conversa. A atribuição não requer um comando especial. Você simplesmente escreve uma declaração que associa claramente o nome da variável ao seu valor. Por exemplo, em um novo chat do Copilot no Word, você pode digitar: Definir nome_projeto = Plano de Marketing Q4. Após esse prompt, toda vez que você escrever {{nome_projeto}} em um prompt subsequente, o Copilot o substituirá por Plano de Marketing Q4.

As variáveis têm escopo de sessão. Elas persistem durante a duração da guia de conversa atual. Se você fechar a guia, atualizar a página ou iniciar um novo chat, todas as variáveis definidas serão perdidas. Você deve redefini-las na nova sessão. Esse comportamento é idêntico ao modo como o Copilot lida com o histórico da conversa.

O Que Você Precisa Antes de Usar Variáveis

Para usar variáveis, você precisa de uma licença do Copilot que inclua a interface de prompt baseada em chat nos aplicativos do Microsoft 365. Isso inclui o Copilot para Microsoft 365 e o Copilot Pro. A substituição de variáveis funciona no Word, Excel, PowerPoint, Outlook e no chat independente do Copilot em copilot.microsoft.com. Nenhum plugin ou configuração de administrador adicional é necessária. O recurso depende do modelo de compreensão de linguagem natural do Copilot, que interpreta a sintaxe de chaves como um marcador para substituição.

Passos para Definir e Usar Variáveis em Prompts do Copilot

Siga estes passos para criar e reutilizar variáveis em uma única sessão de conversa do Copilot.

1. Abra o Copilot no seu aplicativo Microsoft 365 preferido
   Inicie o Word, Excel, PowerPoint ou Outlook. Clique no ícone do Copilot na faixa de opções ou no botão do Copilot no canto superior direito da janela do aplicativo para abrir o painel do Copilot.
2. Defina uma variável no primeiro prompt
   Digite uma declaração de atribuição clara. Use o formato Definir nome_variavel = valor ou Atribuir nome_variavel = valor. Por exemplo: Definir ano_orcamento = 2025. Pressione Enter. O Copilot confirma a atribuição reafirmando a variável e seu valor na resposta.
3. Escreva um prompt que use a variável
   Na mesma conversa, digite um novo prompt que inclua a variável entre chaves duplas. Por exemplo: Resuma os dados de vendas para {{ano_orcamento}}. Não adicione espaços entre as chaves e o nome da variável.
4. Verifique se o Copilot substituiu o valor
   Revise a resposta gerada. O Copilot deve tratar {{ano_orcamento}} como 2025. Se a resposta mostrar o texto literal {{ano_orcamento}} em vez de 2025, a variável não foi reconhecida. Redefina a variável em um novo prompt e tente novamente.
5. Defina variáveis adicionais conforme necessário
   Você pode definir várias variáveis na mesma sessão. Cada variável deve ser definida em seu próprio prompt. Por exemplo, após definir ano_orcamento, digite Definir regiao = América do Norte. Em seguida, use ambas as variáveis juntas: Crie um gráfico da receita de {{regiao}} para {{ano_orcamento}}.
6. Atualize o valor de uma variável no meio da sessão
   Para alterar uma variável, basta redefini-la com um novo valor. Digite Definir ano_orcamento = 2026. O novo valor substitui o antigo para todos os prompts subsequentes na mesma sessão.

Erros Comuns e Limitações ao Usar Variáveis

O Copilot Mostra o Texto Literal {{nome_variavel}} em Vez do Valor

Isso acontece quando o Copilot não reconhece a variável porque ela nunca foi definida na sessão atual. A definição da variável deve ocorrer em um prompt anterior na mesma guia de conversa. Se você abriu um novo chat ou atualizou a página, a definição é perdida. Redefina a variável e reutilize-a no próximo prompt.

O Nome da Variável Contém Espaços ou Caracteres Especiais

O Copilot aceita apenas nomes de variáveis que começam com uma letra e contêm letras, números e sublinhados. Espaços, hífens, pontos e outros caracteres especiais quebram a sintaxe. Use sublinhados em vez de espaços. Por exemplo, use nome_cliente em vez de nome cliente ou nome-cliente.

Variáveis Definidas em um Aplicativo Não São Transferidas para Outro Aplicativo

As variáveis têm escopo na guia de conversa do aplicativo onde foram definidas. Se você definir nome_projeto no painel do Copilot no Word, essa variável não estará disponível no painel do Copilot no Excel, mesmo que ambos os aplicativos estejam abertos no mesmo computador. Você deve redefinir a variável em cada aplicativo separadamente.

Valores Longos de Variáveis Causam Truncamento

O Copilot tem um limite de caracteres por prompt. Se o valor atribuído a uma variável for muito longo, como um parágrafo inteiro de texto, o Copilot pode truncar o valor durante a substituição. Mantenha os valores das variáveis abaixo de 200 caracteres para evitar esse problema.

Variáveis Não Funcionam em Prompts de Sistema ou Modelos Predefinidos

A substituição de variáveis ocorre apenas em prompts escritos pelo usuário dentro de uma conversa ativa. Se você colar um prompt na caixa de composição do Copilot que contenha {{variavel}} mas a variável não foi definida na mesma sessão, o Copilot trata o texto como literal. As variáveis não são suportadas em plugins do Copilot, fluxos do Power Automate ou GPTs personalizados criados com o Copilot Studio, a menos que essas ferramentas incluam explicitamente um recurso de variável.

Item	Variável Definida	Variável Não Definida
Comportamento no prompt	Copilot substitui o valor	Copilot mostra o texto literal {{variavel}}
Sintaxe necessária	Declaração de atribuição anterior na sessão	Nenhuma atribuição necessária, mas a substituição falha
Escopo da sessão	Apenas na guia de conversa atual	Nunca reconhecida
Limite de caracteres no valor	Manter abaixo de 200 caracteres	Não aplicável
Persistência entre aplicativos	Não	Não

Agora você pode definir e reutilizar variáveis dentro dos prompts do Copilot para evitar redigitar nomes de projetos, datas, referências de clientes e outras informações repetidas. Comece cada sessão definindo as variáveis necessárias e, em seguida, faça referência a elas com chaves duplas em cada prompt subsequente. Para fluxos de trabalho complexos que envolvem vários aplicativos, considere salvar as definições de variáveis em um arquivo de texto separado para que você possa copiá-las rapidamente em cada nova sessão. Como próximo passo, tente combinar variáveis com o recurso de referência a arquivos do Copilot escrevendo Resuma {{nome_projeto}} usando /relatorio_Q4.docx para ver como ambos os atalhos funcionam juntos.