Esta é uma tradução automática do documento original em inglês. Em caso de conflito entre esta tradução e a versão original em inglês, a versão em inglês prevalecerá. Ler a versão original em inglês


Variáveis: Personalize Seus Prompts

Variáveis são espaços reservados que são preenchidos automaticamente com suas informações, a data atual, sua localização ou qualquer outra coisa que você definir. Use-as em mensagens, habilidades e configurações de modo para personalizar respostas e automatizar informações repetitivas.

Como usar variáveis

Digite uma variável em sua mensagem ou skill com chaves duplas, assim:

Envie um e-mail de agradecimento para {{email}}

ou em um prompt de skill:

Ajude-me a agendar uma reunião para {{currentDate}} com minha equipe

Quando você a envia, a variável é substituída pelo seu valor real.

Variáveis do seu Perfil (Globais)

Elas estão sempre disponíveis, em todos os lugares. Defina-as em Configurações > Personalização e Privacidade > Personalização:

Variável O que vai aqui
{{userName}} Seu nome
{{occupation}} Seu cargo
{{email}} Seu endereço de e-mail
{{phoneNumber}} Seu número de telefone
{{homeAddress}} Sua cidade ou endereço residencial
{{workAddress}} Seu local de trabalho
{{preferredLanguage}} Seu idioma (para a IA escrever)

Exemplo: "Rascunhe um e-mail dizendo que estou disponível em {{workAddress}} após as 15h e posso ser contatado em {{phoneNumber}}"

Variáveis de Sistema Preenchidas Automaticamente (Somente Leitura)

Elas são atualizadas automaticamente — você não pode editá-las:

Variável O que você obtém
{{currentDate}} Data de hoje (por exemplo, "20 de janeiro de 2026")
{{currentTime}} Hora atual (por exemplo, "14:30 PST")
{{currentDateTime}} Data e hora juntas
{{userTimezone}} Seu fuso horário (por exemplo, "America/Los_Angeles")
{{currentUrl}} A URL da página web que você está visualizando
{{currentPageTitle}} O título da página web que você está visualizando
{{currentLocation}} Sua cidade e estado (requer permissão)
{{currentPreciseLocation}} Endereço completo com coordenadas (requer permissão)
{{currentCity}}, {{currentState}}, {{currentCountry}} Partes individuais de localização
{{currentCountryCode}} Código de país ISO (por exemplo, "BR")
{{currentPostalCode}} CEP / código postal
{{currentNeighborhood}} Bairro ou subúrbio
{{currentLatitude}}, {{currentLongitude}} Coordenadas GPS brutas
{{uiLanguage}} O idioma em que o Caiioo é exibido

As variáveis de localização vêm de uma única consulta de geolocalização — conceda permissão uma vez e cada campo será preenchido em conjunto. O nome do local é computado no seu dispositivo a partir de um banco de dados integrado, para que suas coordenadas não sejam enviadas para lugar nenhum apenas para preenchê-las. O Compartilhamento de Localização (em Configurações > Personalização e Privacidade > Personalização) tem dois níveis: Compartilhar Localização da Cidade preenche os campos gerais ({{currentLocation}}, cidade/estado/país), enquanto Compartilhar Localização Precisa também preenche o bairro, código postal e coordenadas ({{currentPreciseLocation}}).

Exemplo: "Resuma esta página: {{currentUrl}}"

Variáveis Específicas do Modo

Cada modo pode ter suas próprias variáveis. Por exemplo, o modo Workplace tem {{taskingSystem}} e {{communicationsPlatform}}.

Defina-as em Configurações > Ferramentas, Modos e Apps > Modos de Agente enquanto estiver nesse modo.

Sobreposições de Variáveis por Conversa

A partir da v0.9.722, as variáveis de modo não persistem mais entre as conversas. Em vez disso, cada conversa carrega sua própria sobreposição de variáveis. Isso é útil quando você está trabalhando em vários projetos, assuntos ou clientes no mesmo modo.

Exemplo: Você está no modo Trabalho. Uma conversa é para o "Projeto Acme", onde você define {{taskingSystem}} como Jira. Outra conversa é para o "Projeto Beta", onde você o define como Asana. Elas não se sobrescrevem mais — cada conversa lembra suas próprias configurações.

Isso se aplica a todas as variáveis de modo. Quando você altera uma variável em uma conversa, isso afeta apenas aquela conversa e não vazará para outras conversas no mesmo modo.

Apps do Hub também podem ser instalados com um diálogo de variáveis que exibe um botão no compositor para esse app, para que cada app instalado tenha sua própria interface de variáveis que você pode configurar sem mergulhar nas configurações.

Criar Variáveis Personalizadas

Quer reutilizar algo pessoal que não está na lista padrão? Crie uma variável personalizada:

  1. Acesse Configurações > Personalização e Privacidade > Personalização para variáveis disponíveis em todos os lugares, ou Configurações > Ferramentas, Modos e Apps > Modos de Agente para variáveis restritas a um único modo
  2. Clique em "Adicionar Variável"
  3. Dê a ela um nome útil (por exemplo, {{myCompanyName}} ou {{customerServiceEmail}})
  4. Defina o seu valor
  5. Variáveis em nível de perfil estão disponíveis em qualquer lugar; variáveis em nível de modo só são resolvidas dentro daquele modo

Dica de sintaxe: Tanto {{varName}} quanto {{ varName }} funcionam — espaços dentro das chaves não são problema.

Veja Também

  • Skills — Use variáveis em seus prompts reutilizáveis
  • Modos e Personalidades — Variáveis específicas do modo para diferentes fluxos de trabalho

This guide is maintained by the Caiioo team using Slate, our built-in editor.