Orylo Actions sensíveis ao contexto
Faça Actions reutilizáveis aparecerem no contexto certo, combine as entradas necessárias e escolha exatamente como elas são executadas e entregam os resultados.
Seções deste artigo
Actions para o seu contexto atual
Uma Orylo Action combina três decisões: quando está disponível, o que faz e para onde vai seu resultado. A Action Bar compara seu contexto atual com as regras de cada Action habilitada; você não precisa copiar tudo para uma nova conversa primeiro.
Ser sensível ao contexto significa comparar o contexto capturado com as regras que você configurou — não observar a tela continuamente nem executar uma Action automaticamente. Você escolhe qual Action compatível executar.
| Contexto | O que fornece |
|---|---|
| Texto selecionado | O texto que você selecionou; útil para reescrever, traduzir ou usar Promptize. |
| Arquivos, pastas ou imagens | Arquivos ou imagens selecionados, ou caminhos de pastas, conforme a entrada configurada. |
| Página da web | A URL da página atual — não uma cópia automática do conteúdo da página. |
| Janela em foco | A identificação do app, o título da janela quando disponível e uma captura de tela sob demanda; a captura exige permissão. |
| Aplicativo | A identificação do app ativo, incluindo uma condição opcional para um app específico. |
Defina quando uma Action aparece
Escolha um Primary Context (contexto principal): ele é obrigatório e define a entrada principal. Adicione condições All Of (todas) quando todos os contextos adicionais precisarem estar presentes, ou Any Of (qualquer uma) quando pelo menos uma alternativa precisar estar presente. AI Actions recebem todos os contextos configurados que estiverem de fato disponíveis, não apenas a primeira alternativa correspondente.
Por exemplo, exija Selected Text (texto selecionado) e Web Page (página da web) para oferecer uma Action somente quando houver texto e uma URL de página disponíveis ao mesmo tempo. Para restringir uma Action a um app específico, torne Application (aplicativo) uma condição obrigatória e escolha o app; uma condição opcional de Application, sozinha, não garante exclusividade.
Essas regras controlam a disponibilidade. Elas não concedem acesso a arquivos nem permissão de gravação da tela. Se uma Action não aparecer, verifique se está habilitada, os contextos obrigatórios, o app de origem e as permissões de captura.
Escolha a operação e o resultado
Para resultados de IA, escolha o painel de resultados, a área de transferência, o Composer, a substituição da seleção de texto original ou nenhuma entrega automática. A saída de comandos em segundo plano pode ir para o painel, a área de transferência ou o Composer; abrir um novo Terminal não coleta a saída no Orylo. Abrir uma página da web simplesmente abre a URL configurada.
Personalize o nome, a descrição, o ícone, o estado de habilitação e a ordem da Action, além de seu comportamento. Revise os comandos antes de executá-los: eles são executados no seu Mac e não se tornam seguros apenas por fazerem parte de uma Action.
| Operação | Personalização e limites |
|---|---|
| AI Action | Escolha um Assistant e as instruções. Ele recebe o contexto principal e os contextos extras configurados que estiverem disponíveis. Assistants do tipo Chat geram respostas a partir do conteúdo fornecido; Assistants do tipo Agent podem usar suas ferramentas configuradas. |
| Open Web Page (abrir página da web) | Defina um modelo de URL. O texto selecionado ou a URL de uma página pode preencher o marcador de contexto, com codificação adequada para URL. As condições extras apenas determinam a disponibilidade; elas não são passadas para a URL. |
| Run Command (executar comando) | Defina o script, o diretório de trabalho, o tempo limite e a execução em segundo plano ou em um novo Terminal. Apenas a entrada principal é passada como dados; atualmente, entradas de app/janela não fornecem texto de contexto ao script. |
Use Create with Chat — ou configure por conta própria
Descreva o fluxo de trabalho
Abra Settings → Actions → menu de adição → Create with Chat. Especifique a entrada principal, o contexto obrigatório, a operação, o Assistant quando necessário e a forma de entrega. Para criar, você precisa de um Assistant do tipo Agent que já esteja funcionando.
Confira a definição proposta
Peça uma prévia e confirme as condições de correspondência, as instruções ou o comando, o Assistant de destino e o destino da saída. Salve apenas a configuração desejada; salvar não executa a Action.
Teste com um exemplo pequeno
Volte ao app e ao contexto pretendidos, abra a Action Bar e execute intencionalmente a Action salva. Ajuste-a em Settings ou continue a conversa de criação. A opção Create Manually (criar manualmente) também está disponível.
Organize as opções com Action Groups
Um Action Group é um menu de alternativas, não uma sequência que executa todas as Actions contidas nele. Por exemplo, um grupo para texto selecionado pode oferecer uma explicação por IA, uma pesquisa na web e um comando local. Você abre o grupo e escolhe uma Action.
As Actions do grupo compartilham sua entrada e suas condições de exibição, mas podem usar operações e destinos de resultado diferentes. Grupos não podem conter outros grupos. Um grupo totalmente desabilitado não tem nenhuma opção utilizável.
Execute e acompanhe uma execução
Prepare o contexto
Selecione o texto, os arquivos, a pasta ou a imagem de que você precisa, ou coloque o app ou a janela relevante em foco. Abra a Action Bar com o atalho configurado em Settings.
Escolha uma Action compatível
Confira sua finalidade antes de executar. Uma AI Action usa uma sessão de execução separada, não o histórico da conversa aberta. Não presuma que ela carrega o contexto de uma conversa anterior.
Confira o progresso e a saída
Abra Action Executions (execuções de Actions) na Action Bar expandida para ver execuções em andamento, resultados recentes, saídas parciais e erros. Ocultar a barra não cancela uma execução; interrompa-a explicitamente nos detalhes da execução.
Mantenha o controle da entrega e das permissões
A substituição automática só está disponível para uma AI Action cuja entrada principal seja texto selecionado. Ela depende do app de origem e de a seleção original ainda ser válida e editável. Se a entrega falhar, confira o resultado preservado em vez de executar novamente uma tarefa que possa ter efeitos colaterais.
Actions não oferecem um fluxo interativo de aprovação de permissões. Solicitações que exigem uma nova aprovação não são autorizadas silenciosamente; use uma conversa normal para trabalhos que precisam dessa interação. As permissões existentes do Agent continuam valendo.
Os registros de execução são temporários, válidos apenas para a sessão atual do app. Eles não são um histórico permanente de conversa e não persistem após reiniciar o app. Copie ou salve os resultados que precisar manter. As sugestões opcionais de Actions ficam desativadas por padrão e geram rascunhos para revisão, não Actions habilitadas ou executadas automaticamente.