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

# Alter Acções

> Crie e configure fluxos de trabalho personalizados de IA com gatilhos de voz e automação

<Info>
  **Alter Actions** são fluxos de trabalho de IA personalizáveis que permitem criar assistentes especializados para tarefas específicas. Combine instruções de IA, gatilhos de voz, Tools e execução condicional para automatizar qualquer coisa no Mac.
</Info>

## O que é uma Acção Alter?

Uma ação \*\*Alter é uma automação avançada que combina:

* **Instruções de AI** - Alertas de sistema que definem como a IA se comporta
* **Triggers** - Comandos de voz, teclas de atalho ou execução condicional
* **Contexto** - Acesso a texto, arquivos, aplicativos ativos selecionados
* **Tools** - Integração configurada com seu Mac e serviços externos 2000+
* \*\* Saída\*\* - Como os resultados são exibidos (markdown, código, inserção em linha)

Pense em uma ação Alter como um "assistente de IA especializado" personalizado para uma tarefa específica.

## Abrindo o Editor de Ação

### Método 1: Barra de Menus (mais rápido)

1. Clique no ícone de menu **Alter** na barra de menus (no canto superior direito)
2. Selecione \*\* Editor de Ação\*\*

[Barra de menu](/images/tools/menu-bar-action-editor.webp)

### Método 2: Menu Opções

1. Abrir a janela do Alter
2. Clique em \*\*\*\* (três pontos) no canto superior direito
3. Selecione \*\* Editor de Ação\*\*

<img src="https://mintcdn.com/alter-95c0cbf0/4snv0BZ9quc3ATjr/images/tools/options-menu-action-editor.webp?fit=max&auto=format&n=4snv0BZ9quc3ATjr&q=85&s=c5bf6a6a244f7393bceac332c20b566c" alt=" Menu Opções" width="1768" height="1484" data-path="images/tools/options-menu-action-editor.webp" />

### Método 3: Atalho do Teclado

Pressione \*\* \*\* E\*\* (Comando + E) para abrir o Editor de Ação diretamente

<Tip>
  O atalho do teclado é o método mais rápido depois de memorizado.
</Tip>

## Action Editor Walkthrough

O Editor de Ação tem 7 seções principais, cada uma controlando diferentes aspectos de sua ação. Use o painel esquerdo para navegar entre as abas.

### 1. Configurações Gerais

Configurar metadados básicos e contexto de execução.

<img src="https://mintcdn.com/alter-95c0cbf0/4snv0BZ9quc3ATjr/images/tools/action-editor-01-general.webp?fit=max&auto=format&n=4snv0BZ9quc3ATjr&q=85&s=8c4309bb1b43fc04c392cf50663947d5" alt=" Página Geral" width="3736" height="2396" data-path="images/tools/action-editor-01-general.webp" />

**Campos:**

* **Nome** - Nome de ação legível por humanos (por exemplo, "Code Explainer")
* **Descrição** - O que esta ação faz (opcional)
* \*\* Categoria\*\* - Organize ações por tipo (código, produtividade, negócios, etc.)
* **Workspace** - Atribuir a um Workspace específico (opcional)
* **Incluir perfil** - Incluir informações de perfil de usuário no contexto de IA

\*\* Opções de visibilidade:\*\*

* \*\* Mostrar apenas quando estiver em execução\*\* - A ação só aparece se um aplicativo estiver em execução
* \*\* Mostrar apenas quando ativo\*\* - Ação só aparece se um aplicativo tem foco
* **Workspace context** - Escolha qual Workspace vê esta ação

<Note>
  Cada ação recebe um UUID exclusivo automaticamente.
</Note>

### 2. Prompt do sistema

Definir instruções e parâmetros de IA para o modelo.

<img src="https://mintcdn.com/alter-95c0cbf0/4snv0BZ9quc3ATjr/images/tools/action-editor-02-systemprompt.webp?fit=max&auto=format&n=4snv0BZ9quc3ATjr&q=85&s=06c05890a9ef858cdb89c700b5890d65" alt="System Prompt Tab" width="3736" height="2396" data-path="images/tools/action-editor-02-systemprompt.webp" />

**System Prompt** - Instruções de IA principais descrevendo o comportamento e experiência da IA.

\*\* Exemplo:\*\*

```
# IDENTITY AND PURPOSE
You are an expert software engineer who explains code clearly
and accessibly to developers of all skill levels.

# STEPS
1. Analyze the provided code
2. Identify its purpose and key components
3. Explain each section in simple terms

# OUTPUT INSTRUCTIONS
- Use markdown formatting
- Include code examples where helpful
- Keep language clear and non-technical
```

**Parâmetros** - Defina campos de entrada que os usuários podem personalizar antes da execução (inserção de texto, seleções suspensas, etc.).

### 3. Pedido do Usuário

Modelo para o prompt voltado para o usuário que é enviado para a IA.

<img src="https://mintcdn.com/alter-95c0cbf0/4snv0BZ9quc3ATjr/images/tools/action-editor-03-userprompt.webp?fit=max&auto=format&n=4snv0BZ9quc3ATjr&q=85&s=f244ed5b862f5e1da7ca3c52ae68d1b3" alt="User Prompt Tab" width="3736" height="2396" data-path="images/tools/action-editor-03-userprompt.webp" />

\*\*Usando Variáveis de Contexto: \*\*

Quebrar variáveis em `{{ }}` para inserir conteúdo dinâmico:

```
Please explain this code:

{{ textSelection }}

Explanation detail: {{ detailLevel }};
```

\*\* Variáveis de contexto disponíveis:\*\*

* `{{ textSelection }}` - Texto atualmente selecionado
* `{{ filePath }}` - Localização do ficheiro seleccionado
* `{{ clipboard }}` - Conteúdo da área de transferência
* Parâmetros personalizados definidos no Prompt do Sistema

### 4. Quando Mostrar

Controle quando e onde esta ação aparece.

<img src="https://mintcdn.com/alter-95c0cbf0/4snv0BZ9quc3ATjr/images/tools/action-editor-04-whentoshow.webp?fit=max&auto=format&n=4snv0BZ9quc3ATjr&q=85&s=9063ba8e6ffef45537c33b8d03d2a8a9" alt="Quando Mostrar a Página" width="3736" height="2396" data-path="images/tools/action-editor-04-whentoshow.webp" />

\*\* Condições de visibilidade: \*\*

* \*\* Aplicações Instaladas\*\* - Mostrar ação apenas em aplicativos específicos (VSCOde, Xcode, Safari, etc.)
* **A aplicação está em execução** - A ação requer que o aplicativo esteja em execução
* **A aplicação tem foco** - A ação só funciona quando o aplicativo está em primeiro plano
* \*\* Página do navegador Web contém\*\* - Mostrar ação ao navegar domínios específicos
* **Tem conteúdo** - Mostrar ação somente quando o contexto estiver disponível

### 5. Automação

Configurar o comportamento de execução, agendas e processamento de fundo.

<img src="https://mintcdn.com/alter-95c0cbf0/4snv0BZ9quc3ATjr/images/tools/action-editor-05-automation.webp?fit=max&auto=format&n=4snv0BZ9quc3ATjr&q=85&s=5e80d6b07624e34307e9ee8f3b65a9ba" alt=" Página de Automação" width="3736" height="2396" data-path="images/tools/action-editor-05-automation.webp" />

**Campos:**

* **Trabalho de Antecedentes** - Executar ação em segundo plano sem mostrar UI
* \*\* Horários\*\* - Executar ação em horários específicos (por exemplo, "Toda segunda-feira às 9h")
* **Quick Action** - Execute a próxima "Quick Action" automaticamente após esta terminar

Use isso para encadeamento de ação: primeira ação → saída → próxima ação executa automaticamente.

### 6. Tools

Âmbito de aplicação dos instrumentos disponíveis para esta acção.

<img src="https://mintcdn.com/alter-95c0cbf0/4snv0BZ9quc3ATjr/images/tools/action-editor-06-tools.webp?fit=max&auto=format&n=4snv0BZ9quc3ATjr&q=85&s=a2f4fd98803d4f545e16a44c27564f0b" alt="Tools Tab" width="3736" height="2396" data-path="images/tools/action-editor-06-tools.webp" />

\*\* Configuração do Tool:\*\*

* **Desativar Tools** - Ativar Tools individuais para restringir a funcionalidade
* Quando vazio: Todas as Tools estão disponíveis
* Quando configurado: Só estão disponíveis as Tools seleccionadas

\*\* Por que o escopo Tools?\*\*

* Reduzir as despesas gerais de decisão de IA (foco nas Tools relevantes)
* Acelerar a execução da acção
* Melhorar a segurança (limitar o que as ações podem acessar)

### 7. Modelo

Selecione modelo de IA e ajuste o nível de criatividade.

<img src="https://mintcdn.com/alter-95c0cbf0/4snv0BZ9quc3ATjr/images/tools/action-editor-07-model.webp?fit=max&auto=format&n=4snv0BZ9quc3ATjr&q=85&s=74a3e5feb8bcdd2f7c88c127813ad76e" alt="Modelo de Página" width="3736" height="2396" data-path="images/tools/action-editor-07-model.webp" />

**Campos:**

* **Modelo** - Escolha modelo específico de IA para esta ação
  * Deixar em branco para usar a configuração padrão do modelo do usuário
  * Ou selecione: Claude, GPT-4, modelo local, etc.

* **Temperatura** - Ajustar a criatividade vs. precisão
  * **0.0** - Determinativo (consistente, previsível)
  * **0.5** - Saldo (padrão)
  * **1.0** - Criativo (imprevisível, exploratório)

## Melhores Práticas

<CardGroup cols={2}>
  <Card title="Limpar nomes" icon="tag">
    "Code Explainer" descreve o que ele faz. Evite nomes genéricos como "Action 1".
  </Card>

  <Card title="Perguntas Específicas" icon="message">
    Seja detalhado com instruções de IA. Prompts genéricos produzem saídas genéricas.
  </Card>

  <Card title="Âmbito de aplicação Tools" icon="tool">
    Ativar apenas as Tools de que necessita. Reduz a sobrecarga e melhora a velocidade.
  </Card>

  <Card title="Usar Variáveis de Contexto" icon="brackets">
    `{{ textSelection }}` funciona sempre. Cópia/cola manual é propensa a erros.
  </Card>

  <Card title="Visibilidade Condicional" icon="eye">
    "Explicador de Código" apenas em VSCOde + Xcode reduz a desordem do menu.
  </Card>

  <Card title="Testar Antes de Partilhar" icon="check">
    Teste com dados reais antes de implantar para sua equipe.
  </Card>
</CardGroup>

## Exemplos de acções comuns

### Exemplo 1: Explicador de Código

**Setup:**

* **Nome:** Explicar o Código
* \*\* Categoria:\*\* código
* \*\* Aplicativos instalados:\*\* VSCODE, Xcode
* \*\* Prompt do Sistema: \*\* Você é um programador especialista que explica claramente o código
* \*\* Prompt do Usuário:\*\* `Please explain this code:\n\n{{ textSelection }}`
* **Consumidor:** markdown
* **Temperatura:** 0.5

### Exemplo 2: E-mail Draft Creator

**Setup:**

* \*\* Nome:\*\* Rascunho de Email
* \*\* Categoria:\*\* produtividade
* **Quando Mostrar:** Aplicativo de e- mail ativo
* \*\* Prompt do Sistema: \*\* Você é um comunicador profissional de negócios
* \*\* Prompt do Usuário:\*\* `Transform this into a professional email:\n\n{{ textSelection }}`
* **Tools:** Ativar apenas o Email
* **Consumidor:** no local
* \*\*Temperatura: \*\* 0.6

### Exemplo 3: Resumo diário agendado

**Setup:**

* **Nome:** Daily Brief
* \*\* Categoria:\*\* produtividade
* **Automação:** Horário para 9:00 da manhã diariamente
* \*\* Trabalho de Antecedentes:\*\* Activado
* \*\* Prompt do Sistema: \*\* Gerar um resumo diário de prioridades

## Ativadores de Voz

Atribuir teclas de atalho de voz para ativar ações sem mãos:

<Steps>
  <Step title="Configuração do Sistema">
    Ir para **Configurações > Ativadores de Voz**
  </Step>

  <Step title="Adicionar gatilho">
    Clique em **+ Adicionar gatilho**
  </Step>

  <Step title="Selecionar ação">
    Escolha a ação do dropdown
  </Step>

  <Step title="Atribuir Frase">
    Digite frase de gatilho (por exemplo, "explicar" para Explicador de Código)
  </Step>

  <Step title="Gravar">
    Clique em Salvar e você está pronto
  </Step>
</Steps>

\*\* Uso: \*\* Mantenha a tecla de atalho da voz + dizer frase de gatilho → A ação executa com o contexto atual

## Integração x-callback-url

Ações do gatilho Alter de \*\* qualquer aplicativo\*\* usando URLs especiais. Isso permite poderosos fluxos de trabalho de automação entre aplicativos.

### O que é x-callback-url?

x-callback-url é um protocolo de comunicação interaplicativo que permite que aplicativos acionam ações um no outro através de URLs formatadas.

* **Inbound** - Ações do Trigger Alter de outros aplicativos (Shortcuts, Notes, Safari, etc.)
* **Outbound** - Criar links em Alter que abrem outros aplicativos (Bear, OmniFocus, Drafts, etc.)

### Obtendo o URL de retorno de sua ação

<Steps>
  <Step title="Abrir o Editor de Ação">
    Imprensa \*\* \*\* E
  </Step>

  <Step title="Selecionar ação">
    Escolha a ação que deseja expor
  </Step>

  <Step title="Ir para Geral">
    Navegar para a página Geral
  </Step>

  <Step title="Encontrar URL Callback">
    Procurar a secção "URL Callback"
  </Step>

  <Step title="Copiar URL">
    Copiar o URL do `alter://`
  </Step>
</Steps>

**Formato:**

```
alter://action/{action-id}?input=VALUE&param2=VALUE
```

### Ativando ações Alter de outros aplicativos

**Exemplo 1: Pesquisa Web do Safari**

```
alter://action/ask-web?input=What+is+Alter+MacOS
```

**Exemplo 2: Explicador de Código com Entrada**

```
alter://action/explain-code?input=const+hello+%3D+%28%29+%3D%3E+%7B%7D
```

**Exemplo 3: Utilização em Atalhos da Apple**

1. Criar um Atalho Novo
2. Adicionar ação de "Abrir URL"
3. Colar o seu URL `alter://`
4. Executar o atalho para activar a acção

### Casos de Uso

<AccordionGroup>
  <Accordion icon="workflow" title="Automação de fluxo de trabalho">
    Trigger action from Calendar → Gerar notas de reunião → Criar rascunho de email
  </Accordion>

  <Accordion icon="link-2" title="Integração Multi- App">
    Botão de Noção → Trigger Alter ação → Atualizar status da tarefa
  </Accordion>

  <Accordion icon="copy" title="Transferência de Informação">
    Copiar texto → Acionar ação com callback → Abrir resultado em aplicativo externo (sem cópia manual necessária)
  </Accordion>
</AccordionGroup>

## Atalhos do Teclado

## Atalho

□ Editor de Ação Aberto
□ Nova acção □ `Cmd + N` (em editor) □
□ Salvar ação □ `Cmd + S` (no editor)
Excluir ação (em editor)
□ Ações de Pesquisa □ `Cmd + F` (no editor)

## Solução de problemas

<AccordionGroup>
  <Accordion icon="circle-exclamation" title="A ação não aparece no menu">
    * Verificar \*\* Quando Mostrar\*\* configurações
    * Verificar a aplicação está em execução/activa (se configurada)
    * Garantir que a ação é \*\* habilitado\*\*
  </Accordion>

  <Accordion icon="triangle-exclamation" title="A ação é executada mas produz um resultado ruim">
    * Revisão **Prompt do sistema** — ser mais específico
    * Ajuste \*\*Temperatura \*\* (menor para precisão, maior para criatividade)
    * Verificar **Prompt do usuário** — garantir que as variáveis estão corretas
  </Accordion>

  <Accordion icon="microphone" title="O gatilho de voz não está funcionando">
    * Verificar a tecla de atalho está configurada na Configuração
    * Verificar as permissões do microfone
    * Teste com gatilho manual primeiro
  </Accordion>

  <Accordion icon="lock" title="Tools não está disponível em acção">
    * Ir para a página **Tools**
    * Verificar as Tools não estão desactivadas
    * Verificar as permissões do sistema para a Tool
  </Accordion>
</AccordionGroup>

## Guias relacionados

* [Tools & Integrations](/apps-tools/integrations-overview) — Tools disponíveis para as suas acções
* [URL Callbacks](/workflows/url-callbacks) — Mergulho profundo na automação x-callback-url
* [Voz & Ditação](/workflows/dictation) — Configurar gatilhos de voz
* [Configurações](/how-to/settings-guide) — Configurar o modelo global e as configurações de voz

***

\*\* Pronto para construir?\*\* Abra Alter, pressione `⌘ E` e comece a criar sua primeira ação!

**Quer automatizar todos os aplicativos?** Use x-callback-urls para ativar ações do Safari, Atalhos, Notas ou qualquer aplicativo que suporte esquemas de URL.