---
title: "O que é o Orylo?"
description: "Um lugar nativo no Mac para os Agents e as APIs de modelos que você já usa."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/overview"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# O que é o Orylo?
Um lugar nativo no Mac para os Agents e as APIs de modelos que você já usa.
## Seu trabalho, com seus assistentes
O Orylo reúne Agents locais, APIs de modelos, conversas e ferramentas em um único app nativo para macOS. Abra um Composer leve ao lado do seu trabalho, use a janela completa de conversa ou registre uma ideia pelo Notch.
Você escolhe o Assistant e o contexto que deseja compartilhar. O Orylo não é uma assinatura de modelo e não substitui o ambiente de execução, o login ou os limites de uso do próprio Agent.
## Escolha por onde começar
| Quando quiser… | Use |
| --- | --- |
| Fazer uma pergunta ao lado do app atual | Composer |
| Acompanhar várias conversas ou revisar o trabalho | A janela de conversa |
| Execute uma Action reutilizável adequada ao seu contexto atual | Ações |
| Registrar uma ideia enquanto explora seu trabalho | Notch e Narração |
| Crie ou configure recursos do Orylo descrevendo o que você precisa | Create with Chat |
| Continue trabalhando com seu Mac a partir de outro dispositivo | Remote Web / Messages |
## Disponibilidade e demonstração no navegador
Baixe a versão mais recente do Orylo para Apple silicon ou Intel na página de download. [Orylo](https://orylo.io/pt-BR/download)
A demonstração no navegador usa conteúdo de exemplo e respostas simuladas. Ela não se conecta aos seus Agents, não lê seus arquivos nem concede permissões de acesso ao desktop. Este guia descreve a experiência implementada no Mac; as opções disponíveis podem variar conforme o Assistant.
## Continue explorando
- [Sua primeira conversa](https://orylo.io/pt-BR/docs/quickstart)
- [Conecte um Assistant](https://orylo.io/pt-BR/docs/assistants)
- [Privacidade e dados](https://orylo.io/pt-BR/docs/privacy-security)
- [Create with Chat](https://orylo.io/pt-BR/docs/create-with-chat)
- [Configure o Remote Access](https://orylo.io/pt-BR/docs/remote-access)
---
---
title: "Sua primeira conversa"
description: "Configure um Assistant, adicione um pouco de contexto e envie sua primeira solicitação."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/quickstart"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Sua primeira conversa
Configure um Assistant, adicione um pouco de contexto e envie sua primeira solicitação.
## Antes de começar
macOS 26 ou posterior · Apple Silicon e Intel. Baixe a versão mais recente do Orylo para Apple silicon ou Intel na página de download. [Orylo](https://orylo.io/pt-BR/download)
- Para usar um Agent local, instale-o e faça login nele primeiro. Teste uma solicitação nesse Agent antes de conectá-lo ao Orylo.
- Para usar uma API de modelo, tenha em mãos o endpoint e as credenciais do seu provedor. O acesso ao provedor e as cobranças de uso são separados do Orylo.
- Faça login no Orylo quando solicitado para verificar o acesso da sua conta. Sua conta não sincroniza conversas nem arquivos locais.
## Envie uma solicitação
1. **Crie um Assistant** — Abra os Ajustes e adicione um Agent Assistant ou Chat Assistant. Execute a verificação de conexão e ative o Assistant. Se a configuração falhar, preserve seu rascunho e resolva a conexão primeiro.
2. **Abra o Composer** — Use o atalho configurado para o Composer ou abra o Orylo pelo Dock ou pela barra de menus. Você pode conferir e alterar o atalho nos Ajustes.
3. **Escolha o contexto** — Selecione seu Assistant. Para um Agent que trabalha com o contexto de um projeto, escolha o espaço de trabalho antes da primeira mensagem. Digite uma pergunta e adicione um pequeno anexo de texto ou arquivo.
4. **Revise e envie** — Confira o Assistant, o espaço de trabalho e os anexos e pressione Return. Por exemplo: “Resuma estas notas em três próximos passos.”
## Confira o resultado
Leia a resposta na janela de conversa. Abra Atividade quando precisar inspecionar o trabalho das ferramentas e revise as permissões solicitadas antes de concedê-las. Uma resposta dizendo que a tarefa foi concluída não substitui a verificação do resultado.
Continue na mesma conversa para manter o contexto. Fechar a janela preserva seu rascunho e não encerra o Orylo nem necessariamente interrompe o trabalho em andamento.
## Continue explorando
- [Conecte um Assistant](https://orylo.io/pt-BR/docs/assistants)
- [Textos, arquivos e contexto](https://orylo.io/pt-BR/docs/context-attachments)
- [Solução de problemas](https://orylo.io/pt-BR/docs/troubleshooting)
- [Create with Chat](https://orylo.io/pt-BR/docs/create-with-chat)
---
---
title: "Conecte um Assistant"
description: "Entenda os Agent Assistants e Chat Assistants, as verificações de conexão e as configurações padrão."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/assistants"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Conecte um Assistant
Entenda os Agent Assistants e Chat Assistants, as verificações de conexão e as configurações padrão.
## Escolha um tipo de Assistant
| Tipo | Use para | Lembre-se |
| --- | --- | --- |
| Agent Assistant | Trabalho em projetos com um Agent local, como Codex ou Claude Code | Ferramentas, arquivos e recursos de sessão dependem do Agent. |
| Chat Assistant | Conversas por meio de uma API de modelo local ou na nuvem | Sem ferramentas de Agent ou recursos de espaço de trabalho. O provedor define as capacidades do modelo. |
## Conecte e verifique
1. **Prepare a origem** — Instale e autentique um Agent local seguindo as instruções de seu desenvolvedor ou configure um provedor de modelos. O Orylo não inclui um instalador geral de Agents de terceiros.
2. **Crie o Assistant** — Escolha a origem nos Ajustes, dê um nome claro ao Assistant e defina suas instruções. Você também pode pedir ajuda na configuração a um Agent Assistant já configurado; confira os ajustes propostos antes de salvar.
3. **Verifique a disponibilidade** — Execute a verificação. Uma verificação bem-sucedida ativa um Assistant recém-criado; se falhar, a configuração é mantida para a solução de problemas. Verifique novamente após corrigir a origem.
> **Estar conectado não significa ter acesso ilimitado**
> A conexão com um Agent não garante que o login no provedor, a assinatura, a cota ou a próxima solicitação funcionarão. Se as solicitações falharem, teste o acesso ao provedor no próprio Agent.
## Defina padrões reutilizáveis
Salve no Assistant as instruções, um espaço de trabalho padrão quando houver suporte e os Skills ou ferramentas MCP atribuídos a ele. As opções de modelo e raciocínio só aparecem quando a origem oferece suporte.
Os padrões se aplicam a novas conversas. Uma conversa pode manter suas próprias opções de modelo; seu espaço de trabalho fica fixo após a primeira mensagem. Um Chat Assistant pode alternar entre os modelos ativados do seu provedor dentro de uma conversa.
## Continue explorando
- [Use Skills](https://orylo.io/pt-BR/docs/skills)
- [Conecte ferramentas MCP](https://orylo.io/pt-BR/docs/mcp)
- [Solução de problemas](https://orylo.io/pt-BR/docs/troubleshooting)
- [Create with Chat](https://orylo.io/pt-BR/docs/create-with-chat)
- [Orylo Intelligence](https://orylo.io/pt-BR/docs/orylo-intelligence)
---
---
title: "Create with Chat"
description: "Descreva o que você precisa e crie e ajuste configurações do Orylo com um Agent."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/create-with-chat"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Create with Chat
Descreva o que você precisa e crie e ajuste configurações do Orylo com um Agent.
## Transforme um pedido em uma configuração salva
Create with Chat abre uma conversa comum com a Skill de criação integrada apropriada selecionada e um rascunho pronto para editar. O pedido não é enviado automaticamente. As opções voltadas a conexões se chamam Connect with Chat.
Use esse recurso para criar um Assistant reutilizável, uma Action contextual, uma Skill, uma Team ou um modelo de Team, ou uma tarefa agendada. Você pode continuar na mesma conversa para ajustar as configurações compatíveis.
| Onde | O que você pode pedir |
| --- | --- |
| Assistants / Agents | Crie um Assistant com instruções e recursos existentes ou conecte um Agent. |
| Actions / Skills | Crie uma Action ou um Action Group, ou desenvolva e importe um pacote completo de Skill. |
| Teams / Team Templates | Defina um modelo de colaboração e crie uma Team com Assistants do tipo Agent elegíveis. |
| Scheduled Tasks (tarefas agendadas) | Descreva o pedido, o destino de execução, o fuso horário e o agendamento. |
| MCP / Remote | Conecte ferramentas MCP, configure o Remote Access ou obtenha ajuda para configurar canais de mensagens. |
## Crie, revise e experimente
1. **Tenha um Assistant do tipo Agent pronto** — Configure e habilite manualmente seu primeiro Assistant do tipo Agent. Um Assistant do tipo Chat não pode executar essas ferramentas de configuração, embora uma AI Action salva possa usar um Assistant do tipo Chat.
2. **Abra o menu de criação do recurso** — No menu de adição ou criação do recurso, escolha Create with Chat ou Connect with Chat. Por exemplo, abra Settings → Actions e o menu de adição. A criação manual continua disponível.
3. **Descreva o resultado e os limites** — Para uma Action, descreva quando ela deve aparecer, a entrada, o Assistant e para onde o resultado deve ir. Para um agendamento, especifique o fuso horário e o destino. Revise o rascunho antes de enviar.
4. **Revise a configuração que foi salva** — Confira as configurações retornadas ou o link de detalhes. Continue a conversa para fazer alterações compatíveis; teste separadamente quando estiver pronto. Salvar uma Action não a executa, criar uma Team não envia uma tarefa e salvar um agendamento não equivale a usar Run Now (executar agora).
## Comece com um pedido concreto
A criação de Skills inclui a importação do pacote validado para a Library. Ela não atribui automaticamente a Skill a um Assistant nem sobrescreve outra Skill com o mesmo nome. Consulte [Skills](https://orylo.io/pt-BR/docs/skills).
- “Crie uma Action que reescreva o texto selecionado com mais clareza, preserve o idioma e mostre uma prévia em vez de substituí-lo.”
- “Crie uma Skill para revisar notas de versão e importe-a para minha Library.”
- “Ajude a conectar um servidor MCP ao Orylo, mas deixe que eu revise sua origem e suas permissões antes da instalação.”
## Ajuda não significa permissão irrestrita
As ferramentas de criação são habilitadas pela Skill de criação selecionada em uma conversa comum, não em qualquer conversa. Execuções de Teams, tarefas agendadas e Actions não recebem essas ferramentas de configuração.
Fazer login, inserir segredos, conceder permissões do macOS e aprovar o pareamento remoto continuam sendo etapas suas. Insira credenciais nos campos seguros da interface nativa, não na conversa. Instalação, exposição pública e mensagens de teste exigem sua autorização; uma configuração salva ou um indicador verde de conexão não comprovam o sucesso de uma solicitação real.
## Continue explorando
- [Conecte um Assistant](https://orylo.io/pt-BR/docs/assistants)
- [Orylo Actions sensíveis ao contexto](https://orylo.io/pt-BR/docs/actions)
- [Use Skills](https://orylo.io/pt-BR/docs/skills)
- [Configure o Remote Access](https://orylo.io/pt-BR/docs/remote-access)
---
---
title: "Escreva uma solicitação"
description: "Use o Composer para solicitações pontuais sem perder de vista seu trabalho."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/instant-chat"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Escreva uma solicitação
Use o Composer para solicitações pontuais sem perder de vista seu trabalho.
## Abra o Composer
Use o atalho do Composer configurado nos Ajustes. A janela de entrada rápida normalmente aparece ao lado do cursor; outras posições estão disponíveis nos Ajustes. O Notch oferece outro acesso ao rascunho de uma nova conversa.
Abrir o Composer não significa que o conteúdo da área de transferência será enviado automaticamente. Revise o texto e os anexos visíveis antes de enviar.
## Escreva e refine
- Return envia. Shift, Option ou Control + Return insere uma nova linha. Confirmar uma sugestão do método de entrada não envia a solicitação.
- Use Markdown para organizar o texto. Use @ para escolher um Skill disponível ou um membro do Team quando houver suporte.
- Use o menu + para adicionar contexto ou inserir um Prompt Favorito. Prompts com variáveis pedem os valores necessários antes da inserção; inserir não envia a solicitação.
- Em um Composer vazio, as setas para cima e para baixo percorrem os prompts recentes da sessão atual do app.
## Mantenha rascunhos separados
Cada conversa existente mantém seu próprio rascunho. Nova conversa, Composer rápido e Notch compartilham o rascunho de nova conversa. Ocultar e reabrir a interface não descarta esse rascunho.
Escolha o Assistant e, para trabalhar com um Agent, o espaço de trabalho antes da primeira mensagem. Trocar o Assistant pode alterar as opções de modelo disponíveis e a forma como os anexos são tratados.
Um Composer vazio e sem foco se recolhe à barra de ferramentas. Clique ou digite uma letra, número ou símbolo no painel ativo para expandir e escrever. Atalhos e outros campos mantêm seu comportamento; a âncora de rolagem das mensagens não muda.
## Continue explorando
- [Textos, arquivos e contexto](https://orylo.io/pt-BR/docs/context-attachments)
- [Conversas e espaços de trabalho](https://orylo.io/pt-BR/docs/conversations)
- [Atalhos de teclado](https://orylo.io/pt-BR/docs/shortcuts)
---
---
title: "Textos, arquivos e contexto"
description: "Revise o material que você compartilha e entenda o que é realmente anexado."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/context-attachments"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Textos, arquivos e contexto
Revise o material que você compartilha e entenda o que é realmente anexado.
## Adicione apenas o que for útil
Cole um texto ou uma imagem, escolha arquivos pelo menu + ou use uma ação de captura. Os anexos de texto e arquivo ficam visíveis e podem ser removidos. Você pode visualizar os anexos antes de enviar.
A captura automática da seleção vem desativada por padrão. Quando ativada nos Ajustes, ela lê o texto ou os arquivos selecionados ao acionar o atalho correspondente. Ela nunca substitui silenciosamente uma falha na leitura da seleção por conteúdo antigo da área de transferência.
## Entenda arquivos e pastas
- Anexos de arquivos e imagens usam cópias locais do conteúdo no momento da captura, de modo que a prévia e o anexo enviado se referem ao mesmo conteúdo capturado, mesmo que o original seja alterado depois.
- Um anexo de pasta fornece um caminho de diretório; anexá-lo não lê automaticamente todos os arquivos dentro dele. Um Agent com acesso a ferramentas pode acessar arquivos de acordo com suas permissões.
- Um rascunho aceita até 8 imagens e 20 arquivos; cada cópia capturada está limitada a 50 MB. O Assistant pode ter limites adicionais.
- Anexos duplicados são detectados pelo conteúdo. Remova um anexo antes de enviar se ele não deve ser compartilhado.
## Confira como o Assistant recebe o conteúdo
O envio de imagens e arquivos depende do Assistant selecionado. As imagens podem ser enviadas com o texto extraído, apenas como texto ou como imagens, de acordo com as capacidades do Assistant e sua preferência de OCR.
A configuração opcional de inserir texto selecionado no Composer coloca esse texto diretamente na sua solicitação editável, em vez de criar um anexo de referência separado. Revise-o com cuidado, especialmente quando a origem contiver instruções ou comandos.
## Continue explorando
- [Capturas de tela e OCR](https://orylo.io/pt-BR/docs/capture-ocr)
- [Narre o que você vê](https://orylo.io/pt-BR/docs/narration)
- [Privacidade e dados](https://orylo.io/pt-BR/docs/privacy-security)
---
---
title: "Conversas e espaços de trabalho"
description: "Encontre seu trabalho, mantenha o contexto do projeto estável e explore outro caminho."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/conversations"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Conversas e espaços de trabalho
Encontre seu trabalho, mantenha o contexto do projeto estável e explore outro caminho.
## Encontre e organize conversas
Use a barra lateral para filtrar por Assistant, espaço de trabalho, Team ou etiquetas. Pesquise uma conversa e use Command + F para pesquisar dentro da conversa aberta.
Arquive conversas concluídas para manter a lista ativa organizada. Conversas arquivadas podem ser restauradas; a exclusão permanente exige confirmação. O histórico local não é sincronizado pela sua conta Orylo.
## Várias conversas em uma janela
Use o botão de layout no cabeçalho para dividir à esquerda, à direita, acima ou abaixo. São até três colunas com dois painéis cada, incluindo layouts assimétricos. Arraste as divisórias para ajustar o tamanho.
A divisão abre um rascunho com o Assistant, a configuração do modelo e a pasta de trabalho de origem, sem copiar texto ou anexos. Só existe um rascunho de nova conversa; se já estiver aberto, você volta a ele. A mesma conversa não aparece duas vezes.
Abra uma conversa à direita ou abaixo pela barra lateral, ou arraste-a para um painel: no centro ela substitui a conversa; na borda ela abre naquela direção. Com vários painéis, arraste um título para mover ou trocar posições. Fechar um painel não exclui a conversa nem interrompe a tarefa.
O painel ativo recebe seleções da barra lateral e comandos da conversa. Mudar o foco mantém a posição de leitura; entrada e execução são independentes. A barra direita aberta acompanha o espaço do Agent; ao focar um Chat Assistant, mantém o último espaço. Ações de cabeçalhos inativos aparecem ao passar o cursor e funcionam no primeiro clique.
Cada painel exige pelo menos 450 × 450 pontos. A janela aumenta quando necessário e recolhe a expansão automática ao fechar painéis. O cálculo usa a tela onde a janela está e as barras abertas, sem estreitá-las automaticamente. Pode faltar espaço antes de seis painéis. Em tela cheia, vale o tamanho atual. Layout e rascunhos são restaurados ao reiniciar, conforme o espaço disponível.
## Mantenha o espaço de trabalho consistente
Uma conversa com um Agent mantém o espaço de trabalho selecionado antes da primeira mensagem. Inicie uma nova conversa quando precisar de outro diretório. Chat Assistants não têm seletor de espaço de trabalho.
Novas conversas podem herdar o Assistant e as opções atuais. Os padrões de um Assistant são pontos de partida, não uma forma de alterar silenciosamente o projeto de uma conversa existente.
## Acompanhe o trabalho e as permissões
A resposta mostra o progresso enquanto o Assistant trabalha. Atividade contém os detalhes das ferramentas e as perguntas de acompanhamento compatíveis. Selecionar uma resposta não a envia: revise e envie suas respostas explicitamente.
As solicitações de permissão explicam o que está sendo autorizado e o alcance dessa autorização. Escolha a permissão mais restrita que atenda à necessidade. Fechar uma pergunta não é o mesmo que negar uma solicitação de ferramenta.
## Explore uma ramificação
Crie uma ramificação a partir de uma resposta concluída para explorar outra direção ou Assistant, mantendo a conversa original. O contexto recente é transferido automaticamente, sem ativar o Orylo Intelligence nem gerar um resumo.
O histórico completo continua salvo localmente. Agents locais podem ler uma cópia completa quando necessário. Chat Assistants recebem um trecho limitado com as omissões indicadas; forneça os detalhes essenciais que faltarem na próxima mensagem.
## Continue explorando
- [Revise arquivos e alterações](https://orylo.io/pt-BR/docs/change-review)
- [Trabalhe com Teams](https://orylo.io/pt-BR/docs/teams)
---
---
title: "Revise arquivos e alterações"
description: "Inspecione o trabalho de um Agent sem tratar toda alteração relatada como verificada."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/change-review"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Revise arquivos e alterações
Inspecione o trabalho de um Agent sem tratar toda alteração relatada como verificada.
## Abra a barra lateral de revisão
Em uma conversa com um Agent, abra a barra lateral direita e escolha Revisar alterações ou Explorador de arquivos. Navegue por textos, Markdown, imagens e diferenças entre arquivos sem sair da conversa.
O leitor não é um editor de arquivos. Abra um arquivo em seu aplicativo padrão quando precisar editá-lo. Chat Assistants não disponibilizam essa barra lateral de projeto.
## Escolha o escopo
Não use a visualização Última rodada como prova de todas as alterações no sistema de arquivos. Compare o repositório de trabalho e inspecione o resultado quando for importante verificar a totalidade das alterações.
| Escopo | O que mostra |
| --- | --- |
| Última rodada | Alterações concluídas em arquivos relatadas pelo Agent nessa rodada; a lista pode estar incompleta. |
| Sem commit | As alterações ainda sem commit no repositório de trabalho. |
| Fora da área de preparação | Alterações ainda não adicionadas à área de preparação do Git. |
| Na área de preparação | Alterações já adicionadas à área de preparação do Git. |
## Use as ações do Git com atenção
O menu de ações do Git permite atualizar, adicionar tudo à área de preparação ou retirar tudo dela, fazer commit, fetch, push e pull. Essas ações se aplicam ao repositório Git inteiro que contém o espaço de trabalho atual.
Um commit inclui apenas o conteúdo da área de preparação. O pull aceita somente fast-forward. Leia o resultado e resolva conflitos em vez de presumir que a ação solicitada deu certo.
## Continue explorando
- [Conversas e espaços de trabalho](https://orylo.io/pt-BR/docs/conversations)
- [Trabalhe com Teams](https://orylo.io/pt-BR/docs/teams)
- [Permissões e controle](https://orylo.io/pt-BR/docs/permissions)
---
---
title: "Trabalhe com Teams"
description: "Dê funções distintas aos assistentes e acompanhe suas contribuições em um só lugar."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/teams"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Trabalhe com Teams
Dê funções distintas aos assistentes e acompanhe suas contribuições em um só lugar.
## Crie um Team
1. **Escolha um estilo de colaboração** — Comece com um modelo integrado ou salvo. Escolha colaboração regular, Revisão em dupla ou Discussão moderada conforme o trabalho.
2. **Atribua assistentes e funções** — Escolha o Assistant que vai exercer cada função e confira as instruções compartilhadas e de cada função. Revisão em dupla exige exatamente dois participantes.
3. **Confira os espaços de trabalho e comece** — Defina um espaço de trabalho padrão e ajuste os diretórios individuais dos membros quando necessário. As conversas já existentes dos membros mantêm seus diretórios. Criar o Team, por si só, não envia uma tarefa.
## Entenda os modos
O modo de colaboração é fixado na criação do Team. Um Team pode continuar com novas solicitações; você não precisa de uma etapa de revisão separada para pedir outra revisão.
| Modo | Como o trabalho é compartilhado |
| --- | --- |
| Colaboração | Um coordenador e os membros dividem uma tarefa e trocam resultados. |
| Revisão em dupla | Um autor pede comentários a um revisor e decide como revisar ou resumir. |
| Discussão moderada | Os participantes trocam evidências e pontos de vista; um moderador reúne conclusões e divergências. |
## Acompanhe as contribuições individuais
Use a visualização do Team e as conversas dos membros para inspecionar quem está trabalhando e o que cada membro produziu. Abra a conversa do membro relevante quando precisar responder diretamente ou inspecionar seu contexto.
Um modelo salvo descreve funções reutilizáveis; ele não é o mesmo que um Team em execução. Alterações no modelo afetam Teams futuros, não os já existentes. O acesso às ferramentas continua dependendo de cada Assistant e de suas permissões.
## Continue explorando
- [Conecte um Assistant](https://orylo.io/pt-BR/docs/assistants)
- [Conversas e espaços de trabalho](https://orylo.io/pt-BR/docs/conversations)
- [Revise arquivos e alterações](https://orylo.io/pt-BR/docs/change-review)
- [Create with Chat](https://orylo.io/pt-BR/docs/create-with-chat)
---
---
title: "Use Skills"
description: "Reutilize instruções e métodos de trabalho entre seus assistentes."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/skills"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Use Skills
Reutilize instruções e métodos de trabalho entre seus assistentes.
## Monte uma biblioteca pequena e útil
Um Skill reúne instruções e recursos de apoio para uma tarefa específica. Use Descoberta para encontrar Skills compatíveis de Agents locais e Biblioteca para organizar os Skills que você traz para o Orylo.
Inspecione as instruções e a origem de um Skill antes de usá-lo. Um Skill não é uma barreira de segurança e não concede permissões nem ferramentas por conta própria.
## Use um Skill em uma solicitação
1. **Atribua Skills reutilizáveis** — Escolha nos ajustes do Assistant os Skills que ele deve ter disponíveis. Mantenha o conjunto relevante para a função desse Assistant.
2. **Selecione um Skill explicitamente** — Use @ no Composer ou o seletor de Skills disponível para referenciar um Skill na solicitação. A referência permanece no ponto em que você a inseriu.
3. **Revise antes de enviar** — Confira a solicitação e as referências. Se o Skill precisar de uma ferramenta ou arquivo, verifique se o Assistant escolhido realmente tem acesso.
## Crie e aprimore Skills
Você pode trabalhar com um Agent configurado para criar ou refinar um Skill para uma tarefa recorrente. Revise as instruções e os recursos produzidos antes de adicioná-lo ou atribuí-lo.
Alterar um Skill não modifica retroativamente as respostas já geradas. Teste o Skill revisado com uma pequena solicitação e confira o resultado.
## Continue explorando
- [Conecte ferramentas MCP](https://orylo.io/pt-BR/docs/mcp)
- [Conecte um Assistant](https://orylo.io/pt-BR/docs/assistants)
- [Orylo Actions sensíveis ao contexto](https://orylo.io/pt-BR/docs/actions)
- [Create with Chat](https://orylo.io/pt-BR/docs/create-with-chat)
---
---
title: "Conecte ferramentas MCP"
description: "Gerencie as conexões de ferramentas em um só lugar e atribua apenas o que cada Assistant precisa."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/mcp"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Conecte ferramentas MCP
Gerencie as conexões de ferramentas em um só lugar e atribua apenas o que cada Assistant precisa.
## Adicione uma conexão de ferramenta
Nos Ajustes, use Servidores MCP para encontrar configurações locais compatíveis ou adicionar um servidor à Biblioteca. Revise uma configuração importada de JSON ou Git antes de aceitá-la.
Os assistentes de conexão podem ajudar a encontrar e configurar um serviço. Insira as credenciais nos campos específicos dos ajustes, não em uma solicitação de conversa. Instalar um servidor externo e autorizar seu serviço continuam sendo etapas separadas.
## Teste, ative e atribua
1. **Teste a conexão** — Confirme que o servidor configurado responde. Uma configuração salva não comprova uma conexão bem-sucedida.
2. **Ative o servidor** — Confira as ferramentas disponibilizadas e as credenciais necessárias antes de ativar o uso.
3. **Atribua a um Assistant** — Escolha quais Assistants e ferramentas podem usar a conexão. Serviços não atribuídos não ficam disponíveis para todas as conversas.
## Conheça os limites
As ferramentas MCP atribuídas pelo Orylo podem coexistir com a configuração MCP do próprio Agent. Remover o acesso no Orylo não remove automaticamente uma conexão separada configurada diretamente nesse Agent.
A integração atual é voltada a ferramentas. Não são oferecidos OAuth integrado de MCP, Resources, Prompts, instalação de pacotes de servidores nem conversão automática de anexos multimodais. Siga as regras de privacidade e autorização do serviço conectado.
## Continue explorando
- [Conecte um Assistant](https://orylo.io/pt-BR/docs/assistants)
- [Use Skills](https://orylo.io/pt-BR/docs/skills)
- [Privacidade e dados](https://orylo.io/pt-BR/docs/privacy-security)
- [Create with Chat](https://orylo.io/pt-BR/docs/create-with-chat)
- [Orylo Computer Use](https://orylo.io/pt-BR/docs/computer-use)
---
---
title: "Orylo Computer Use"
description: "Deixe seus assistentes trabalharem com apps do Mac e Chrome, com acesso aprovado por você e controle que pode ser interrompido."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/computer-use"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Orylo Computer Use
Deixe seus assistentes trabalharem com apps do Mac e Chrome, com acesso aprovado por você e controle que pode ser interrompido.
## O que ele faz
Um Assistant com Computer Use atribuído pode ler interfaces compatíveis, clicar em controles, inserir texto e operar abas do Chrome. O recurso está integrado ao Orylo, sem instalação separada de Node ou Bun. As ações disponíveis dependem do app e do suporte a ferramentas do assistente.
## Ativar para um assistente
Abra Ajustes → MCP Servers → Library. Encontre Computer Use em Built into Orylo, ative e atribua ao Assistant desejado. Ele não é atribuído a todos por padrão. Na conversa, informe claramente o app e a tarefa.
## Aprovar o acesso
Confira o app exibido no cartão de autorização. A aprovação vale para a sessão atual. A interação nativa precisa da permissão Acessibilidade do macOS; capturas e observação visual também podem exigir Gravação de Tela. Autorize o Orylo em Ajustes do Sistema → Privacidade e Segurança quando solicitado. Confirme pessoalmente o acesso de depuração remota do Chrome. Se o Orylo abrir essa configuração, ative a opção e conclua a confirmação do Chrome.
## Prévia e fim do controle
Com alvos ativos, abra a prévia pelo ícone de tela ao lado do uso de tokens no Composer. Alterne entre alvos ou clique no título para voltar ao app ou à aba. Fechar a prévia não interrompe o controle. Use End Control para parar aquele alvo ou interrompa a conversa para parar a execução atual. Ações já realizadas não são desfeitas. Se você interagir com o app controlado, novas entradas automáticas ficam pausadas até que a proteção permita retomar após uma nova observação.
## Observar mudanças
A partir do Orylo 0.1.9, peça ao assistente para observar um app ou uma aba e continuar a conversa quando detectar uma mudança relevante. Defina alvo, condição e próximo passo. No Composer, veja tarefas ativas, abra seus alvos ou pare cada tarefa. Fechar a prévia não para a observação. As tarefas não sobrevivem à reinicialização do Orylo; janelas ocultas ou minimizadas podem não permitir observação visual.
## Experimente um pedido delimitado
“Leia este rascunho no Notas e sugira três títulos mais claros. Não edite ainda.” Ou: “Observe esta aba do Chrome e me avise quando a exportação terminar. Não baixe nem envie nada.” São exemplos de pedidos, não garantias de suporte a todos os apps e páginas.
## Privacidade e solução de problemas
O assistente pode receber texto da interface, capturas solicitadas ou imagens de observação, processados pelo Agent ou provedor de modelos configurado. Isso não significa que toda a IA roda localmente. Essas solicitações não passam pelo Orylo Backend. Se faltarem ferramentas, confira atribuição e ativação. Se o acesso falhar, confira a aprovação do app, as permissões do macOS e a conexão do Chrome. Revise alterações parciais antes de tentar novamente. Remover a atribuição MCP revoga o acesso pelo Orylo; permissões do macOS são gerenciadas separadamente.
## Continue explorando
- [Conecte ferramentas MCP](https://orylo.io/pt-BR/docs/mcp)
- [Conecte um Assistant](https://orylo.io/pt-BR/docs/assistants)
- [Permissões e controle](https://orylo.io/pt-BR/docs/permissions)
- [Privacidade e dados](https://orylo.io/pt-BR/docs/privacy-security)
---
---
title: "Orylo Actions sensíveis ao contexto"
description: "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."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/actions"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# 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.
## 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
1. **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.
2. **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.
3. **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.
## Compartilhar e personalizar definições de Actions
Actions e Action Groups permitem importar e exportar JSON. Antes de usar uma definição importada, revise as condições, instruções, comandos e o destino da saída. As referências a Assistants precisam ser resolvidas no Mac de destino; ter o mesmo nome de exibição não basta.
O formato JSON também aceita condições de exclusão (None Of), ainda indisponíveis no editor visual. No momento, não é possível exportar um comando com diretório de trabalho local fixo. As definições portáteis não incluem entradas capturadas, histórico de execução nem preferências locais de ordenação.
## Execute e acompanhe uma execução
1. **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.
2. **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.
3. **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.
## Continue explorando
- [Create with Chat](https://orylo.io/pt-BR/docs/create-with-chat)
- [Textos, arquivos e contexto](https://orylo.io/pt-BR/docs/context-attachments)
- [Use Skills](https://orylo.io/pt-BR/docs/skills)
- [Permissões e controle](https://orylo.io/pt-BR/docs/permissions)
- [Orylo Intelligence](https://orylo.io/pt-BR/docs/orylo-intelligence)
---
---
title: "Agende tarefas recorrentes"
description: "Configure um agendamento local e inspecione cada execução separadamente."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/scheduled-tasks"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Agende tarefas recorrentes
Configure um agendamento local e inspecione cada execução separadamente.
## Crie um agendamento
Abra Tarefas Agendadas na barra lateral de conversas. Use o menu + para criar uma tarefa manualmente ou por meio de uma conversa de configuração. Especifique a solicitação, o Assistant, a conversa de destino, o horário e o fuso horário.
Escolha um agendamento único, diário ou semanal, com limite de repetições ou sem término definido. Uma execução pode usar uma conversa existente ou iniciar uma nova. Salvar um agendamento ativo habilita acionamentos futuros; isso não executa um teste imediatamente.
## Entenda quando as tarefas são executadas
Escolha um fuso horário fixo com atenção, especialmente ao viajar. Confira o próximo horário agendado em vez de presumir que ele acompanha o fuso horário atual do Mac.
> **Os agendamentos são executados no seu Mac, não na nuvem**
> O Orylo precisa estar em execução e o Mac precisa estar acordado. Execuções perdidas são ignoradas por padrão; você pode optar por recuperar a execução perdida mais recente dentro de uma hora.
## Pause e inspecione
Pause um agendamento para impedir acionamentos futuros. Uma execução já assumida pode continuar; interrompê-la exige uma ação separada.
Abra o histórico de execuções para inspecionar sucessos, falhas e a conversa resultante. O estado ativo, pausado ou concluído de um agendamento é diferente do resultado de uma execução individual.
## Continue explorando
- [Conversas e espaços de trabalho](https://orylo.io/pt-BR/docs/conversations)
- [Conecte um Assistant](https://orylo.io/pt-BR/docs/assistants)
- [Solução de problemas](https://orylo.io/pt-BR/docs/troubleshooting)
- [Create with Chat](https://orylo.io/pt-BR/docs/create-with-chat)
---
---
title: "Orylo Intelligence"
description: "Deixe seus Assistants cuidarem dos pequenos detalhes e torne Orylo mais útil no dia a dia."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/orylo-intelligence"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Orylo Intelligence
Deixe seus Assistants cuidarem dos pequenos detalhes e torne Orylo mais útil no dia a dia.
## Configurar o Orylo Intelligence
Abra Ajustes → Orylo Intelligence, selecione um recurso, escolha um Assistant e ative-o. Cada recurso tem seu próprio Assistant e requisitos de geração opcionais para idioma, estilo ou foco. Deixe em branco para usar as instruções integradas.
Títulos e tags vêm ativados, mas precisam de um Assistant configurado. Os demais recursos vêm desativados.
Você pode escolher um Assistant específico ou o padrão. Abra os ajustes do Assistant para selecionar o modelo e seu esforço de raciocínio padrão; as opções disponíveis dependem do modelo. Esses ajustes também afetam outros usos desse Assistant. Para separar as configurações, crie um Assistant dedicado ao Intelligence.
## Títulos de conversas
Depois que você envia a primeira mensagem, o Orylo gera um título curto para facilitar a busca. Títulos definidos manualmente têm prioridade. Se a geração falhar, o título existente é mantido.
- **Entrada:** Um trecho da primeira mensagem que você envia; os arquivos anexos não são lidos.
- **Saída:** Um título descritivo de até 60 caracteres baseado na tarefa ou no assunto do seu pedido.
- **Assistant e esforço de raciocínio:** Recomendamos um Chat Assistant para este recurso; Agent Assistants também são aceitos. Nos ajustes do Assistant escolhido, selecione um esforço de raciocínio baixo, como Low, se o modelo oferecer essa opção. Caso contrário, mantenha os valores padrão.
## Tags existentes
Após uma resposta bem-sucedida, o Orylo pode atribuir tags relevantes da sua lista. Crie as tags primeiro. Ele não inventa tags nem restaura as que você removeu manualmente; se nenhuma for adequada, nenhuma será atribuída.
- **Entrada:** Trechos de até seis mensagens recentes e os nomes das tags existentes.
- **Saída:** Uma seleção de tags relevantes, ou nenhuma se não houver uma adequada.
- **Assistant e esforço de raciocínio:** Recomendamos um Chat Assistant para este recurso; Agent Assistants também são aceitos. Nos ajustes do Assistant escolhido, selecione um esforço de raciocínio baixo, como Low, se o modelo oferecer essa opção. Caso contrário, mantenha os valores padrão.
## Sugestões de Actions
O recurso encontra fluxos repetidos em novas conversas do mesmo espaço de trabalho. Precisa de pelo menos duas conversas independentes e analisa após um período de inatividade, no máximo uma vez por dia. Considera as Actions existentes para sugerir criações ou melhorias.
Revise e edite as sugestões nos ajustes deste recurso. Continue com o Action Creator para abrir um rascunho em um chat com um Agent; envie-o e confirme a configuração final. Uma sugestão nunca cria nem executa uma Action automaticamente.
Gerar a sugestão não exige ferramentas. Criar a Action com o Action Creator é uma etapa separada que exige um Agent Assistant com ferramentas.
- **Entrada:** Trechos de até 12 conversas novas no mesmo espaço de trabalho e o catálogo de Actions existentes.
- **Saída:** Uma proposta editável para criar ou melhorar uma Action, com referências às conversas que a fundamentam; não é uma Action executável.
- **Assistant e esforço de raciocínio:** Recomendamos um Chat Assistant para este recurso; Agent Assistants também são aceitos. Nos ajustes do Assistant escolhido, selecione um esforço de raciocínio baixo, como Low, se o modelo oferecer essa opção. Caso contrário, mantenha os valores padrão.
## Sugestões da próxima mensagem
Após uma nova resposta bem-sucedida, uma conversa elegível com pelo menos duas respostas concluídas pode mostrar uma sugestão no campo vazio. Ela segue o idioma da conversa, incluindo chinês. Tab transforma a sugestão em um rascunho editável, sem enviá-lo. Sua digitação tem prioridade.
O Remote Web pode exibir sugestões geradas no Mac; no celular, toque no botão para usá-las. Abrir uma conversa não gera uma sugestão. Ela pode reaparecer ao reabrir a mesma conversa sem alterações durante a sessão do app, mas desaparece ao reiniciar o Orylo.
- **Entrada:** Até 12 mensagens recentes concluídas na conversa atual, dentro de um limite de contexto.
- **Saída:** Uma sugestão curta no idioma da conversa, ou nenhuma se não houver uma próxima mensagem útil e clara.
- **Assistant e esforço de raciocínio:** Recomendamos um Chat Assistant para este recurso; Agent Assistants também são aceitos. Nos ajustes do Assistant escolhido, selecione um esforço de raciocínio baixo, como Low, se o modelo oferecer essa opção. Caso contrário, mantenha os valores padrão.
## Privacidade e solução de problemas
Os recursos usam trechos limitados das conversas, sem ler anexos ou o histórico privado do Agent. Um modelo remoto recebe o texto necessário; um Assistant no dispositivo processa tudo no Mac. As tarifas normais do serviço escolhido podem ser aplicadas.
Se nada aparecer, confira se o recurso está ativado, se o Assistant está disponível e as condições de execução no painel de informações. Falta de contexto, ausência de uma sugestão útil ou falha na solicitação podem não produzir resultado. Falhas do Intelligence não bloqueiam o chat normal.
## Continue explorando
- [Conecte um Assistant](https://orylo.io/pt-BR/docs/assistants)
- [Orylo Actions sensíveis ao contexto](https://orylo.io/pt-BR/docs/actions)
- [Conversas e espaços de trabalho](https://orylo.io/pt-BR/docs/conversations)
---
---
title: "Use o Notch"
description: "Mantenha uma ideia ou o progresso de um Assistant por perto sem abrir uma janela completa."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/notch"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Use o Notch
Mantenha uma ideia ou o progresso de um Assistant por perto sem abrir uma janela completa.
## Um acesso, três visualizações
O acesso opcional pelo Notch reúne Composer, Narração e uma visão geral dos Assistants. É um ponto de acesso adicional, não um sistema de conversas separado. Você pode usar o Orylo sem um recorte físico de câmera na tela.
O Composer no Notch compartilha o rascunho de nova conversa com o Composer rápido. Abri-lo não troca uma conversa existente na janela de trabalho nem captura automaticamente a seleção atual.
## Veja o trabalho de relance
A visão geral dos Assistants mostra os assistentes disponíveis e seus trabalhos ativos ou não lidos. Selecione um Assistant para escrever ou uma tarefa para retornar à conversa correspondente. Assistentes indisponíveis não aparecem na visão geral.
Fixar mantém o Notch aberto. Desafixar libera essa configuração; afastar o cursor pode então recolhê-lo. Recolher preserva um rascunho inacabado ou uma sessão de Narração.
## Continue em uma conversa
Envie o rascunho revisado para continuar na janela completa de conversa. O Notch serve para começar e acompanhar o trabalho; respostas mais longas, arquivos e trabalho com Teams ficam na conversa.
## Continue explorando
- [Escreva uma solicitação](https://orylo.io/pt-BR/docs/instant-chat)
- [Narre o que você vê](https://orylo.io/pt-BR/docs/narration)
- [Conversas e espaços de trabalho](https://orylo.io/pt-BR/docs/conversations)
---
---
title: "Narre o que você vê"
description: "Reúna notas faladas e contexto selecionado enquanto percorre seu trabalho."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/narration"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Narre o que você vê
Reúna notas faladas e contexto selecionado enquanto percorre seu trabalho.
## Inicie uma Narração
1. **Abra a Narração** — Abra a visualização Narração no Notch e inicie uma sessão. Conceda apenas as permissões necessárias para as entradas que você usa.
2. **Descreva o que está vendo** — Fale enquanto observa os apps ou as páginas relevantes. Adicione capturas ou imagens selecionadas quando um detalhe visual for importante. Pause quando precisar deixar algo de fora.
3. **Pare e revise** — Inspecione as etapas, os textos, as imagens e o contexto de página disponível que foram coletados. Remova tudo o que não quiser compartilhar.
## Entenda o contexto coletado
Durante a gravação, as informações disponíveis sobre o app, a janela e a página do navegador ajudam a organizar as etapas. Uma mudança na URL da página pode criar uma etapa distinta mesmo sem fala ou captura de tela.
As informações da página dependem do acesso e de leituras bem-sucedidas. O Orylo não reutiliza uma URL desatualizada após uma falha de leitura, e a amostragem não garante a captura de toda navegação breve.
## Anexe e decida quando enviar
Anexe uma Narração revisada a uma nova conversa ou à conversa atual, quando esse destino estiver disponível. Anexar abre o rascunho de destino; não o envia automaticamente.
Uma gravação vazia não tem nada para anexar. Comece novamente e colete conteúdo útil. Depois de anexar, continue pelos anexos do Composer em vez de tentar editar uma revisão antiga de Narração.
## Continue explorando
- [Use o Notch](https://orylo.io/pt-BR/docs/notch)
- [Dite um rascunho](https://orylo.io/pt-BR/docs/voice)
- [Textos, arquivos e contexto](https://orylo.io/pt-BR/docs/context-attachments)
---
---
title: "Capturas de tela e OCR"
description: "Capture uma região ou janela e controle a extração local de texto."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/capture-ocr"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Capturas de tela e OCR
Capture uma região ou janela e controle a extração local de texto.
## Capture a parte relevante
Use o atalho configurado para captura de região ou da janela em foco. O resultado se torna um anexo de imagem no rascunho de destino, onde você pode visualizá-lo ou removê-lo antes de enviar.
A captura é direcionada ao último rascunho que você abriu deliberadamente. Iniciar uma captura fixa seu destino, para que uma janela exibida automaticamente não redirecione o resultado de forma silenciosa.
## Escolha a extração local de texto
Os ajustes de OCR controlam se a extração de texto é executada. O Apple Vision processa imagens e páginas de PDF renderizadas no seu Mac. Desativar o OCR impede a extração; isso não significa que a imagem não contenha texto.
## Adapte a extração ao Assistant
A preferência de tratamento de imagens de um Assistant pode usar comportamento automático, imagem e texto, somente texto ou imagens sem OCR. O envio efetivo ainda depende das capacidades do Assistant.
O OCR pode interpretar incorretamente layouts, tabelas, nomes ou comandos. Revise textos extraídos importantes. Links e comandos reconhecidos são dados de referência, não instruções para abri-los ou executá-los.
## Continue explorando
- [Textos, arquivos e contexto](https://orylo.io/pt-BR/docs/context-attachments)
- [Permissões e controle](https://orylo.io/pt-BR/docs/permissions)
- [Privacidade e dados](https://orylo.io/pt-BR/docs/privacy-security)
---
---
title: "Dite um rascunho"
description: "Transforme a fala em texto editável com um mecanismo de transcrição escolhido explicitamente."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/voice"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Dite um rascunho
Transforme a fala em texto editável com um mecanismo de transcrição escolhido explicitamente.
## Microfone do sistema
O Orylo usa o microfone padrão do macOS para ditado e Narration. Para mudar a entrada, abra Ajustes do Sistema → Som → Entrada. O Orylo não oferece um seletor de microfone separado.
## Escolha o mecanismo e o idioma
O idioma da fala independe do idioma da interface. Não há troca automática entre mecanismos: se o mecanismo selecionado falhar, resolva o erro ou escolha outro explicitamente.
| Mecanismo | Comportamento |
| --- | --- |
| Apple Speech | Usa os idiomas de fala compatíveis informados pelo seu Mac. A transcrição opcional ao vivo pode revisar o texto inicial enquanto você fala. |
| Whisper Local | Usa o modelo multilíngue que você baixa e escolhe explicitamente. Transcreve após o fim da gravação e oferece detecção automática de idioma. |
## Grave e revise
1. **Comece a gravar** — Clique no botão de microfone do Composer que estiver usando. O macOS solicitará acesso ao microfone quando necessário.
2. **Pare ou cancele** — Pare para transcrever ou cancele para descartar a gravação. Enquanto a entrada de voz está ativa, Escape a cancela antes de fechar a janela.
3. **Edite o rascunho** — Revise nomes, números e pontuação no texto editável antes de enviar. Transcrever não envia automaticamente.
## Mantenha o destino claro
O Composer do Notch e a janela de conversa têm estados de gravação independentes. Sair de uma conversa cancela sua gravação ou transcrição ativa em vez de escrever em outro rascunho.
O Whisper preserva o idioma falado em vez de traduzi-lo. Escolher um idioma não garante um sistema de escrita chinês específico.
## Continue explorando
- [Narre o que você vê](https://orylo.io/pt-BR/docs/narration)
- [Permissões e controle](https://orylo.io/pt-BR/docs/permissions)
- [Escreva uma solicitação](https://orylo.io/pt-BR/docs/instant-chat)
---
---
title: "Privacidade e dados"
description: "Saiba o que fica no seu Mac, o que é enviado a um Assistant e o que sua conta armazena."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/privacy-security"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Privacidade e dados
Saiba o que fica no seu Mac, o que é enviado a um Assistant e o que sua conta armazena.
## O trabalho local permanece local por padrão
Conversas, cópias capturadas de anexos, configurações locais dos Assistants, Teams, Ações são armazenados no seu Mac. Eles não são sincronizados pela sua conta Orylo.
Armazenamento local não significa que todo Assistant funciona offline. Um Agent ou provedor de modelos pode enviar sua solicitação aos próprios serviços, de acordo com sua configuração e suas políticas.
## Quando você envia uma solicitação
O Assistant escolhido recebe a solicitação e o contexto fornecido a ele, incluindo instruções aplicáveis, anexos selecionados. Inspecione o rascunho e a configuração do Assistant antes de compartilhar material sensível.
O backend de contas do Orylo não intermedeia solicitações, respostas, arquivos, capturas ou espaços de trabalho dos Agents. Ferramentas e provedores externos aplicam suas próprias regras de privacidade e retenção.
## O que os serviços de conta online armazenam
Os serviços online do Orylo cuidam de identidade, direito de acesso adquirido, licenciamento de dispositivos e feedback. Os registros dos dispositivos incluem um identificador de instalação, uma chave pública, horários de ativação e a configuração mais recente do app e do Mac, usada para estatísticas de compatibilidade.
A configuração inclui versão do macOS, arquitetura e modelo do chip, identificador do modelo do Mac e versão/build do app. O Orylo não coleta o número de série do hardware nem o nome do computador para licenciamento. Os registros dos dispositivos são removidos quando a conta é excluída.
## Compartilhe menos, de forma consciente
Remova anexos desnecessários e confira as permissões das ferramentas. Os diagnósticos opcionais de feedback excluem prompts, respostas, caminhos de arquivos, conteúdo de arquivos, títulos de janelas, tokens, chaves de API e variáveis de ambiente.
Leia a [Política de Privacidade](https://orylo.io/pt-BR/privacy) para consultar os termos formais. Excluir conteúdo local não retira dados já enviados a um Agent ou serviço externo.
## Continue explorando
- [Permissões e controle](https://orylo.io/pt-BR/docs/permissions)
- [Conta e dispositivos](https://orylo.io/pt-BR/docs/account)
---
---
title: "Permissões e controle"
description: "Entenda o acesso ao macOS e as permissões separadas usadas por um Agent."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/permissions"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Permissões e controle
Entenda o acesso ao macOS e as permissões separadas usadas por um Agent.
## Conceda acesso ao sistema quando necessário
Use Ajustes do Sistema → Privacidade e Segurança para revisar ou alterar o acesso. O Orylo lê o estado real de autorização do macOS; ele não contorna as permissões do sistema.
| Permissão | Por que é necessária |
| --- | --- |
| Acessibilidade | Ler a seleção atual para os recursos de contexto ativados e as ações compatíveis. |
| Microfone | Gravar rascunhos por voz ou entrada falada. |
| Gravação de Tela | Capturar regiões da tela ou janelas quando o macOS exigir essa permissão. |
## Revise separadamente as solicitações de ferramentas do Agent
Um Agent pode pedir permissão para usar ferramentas, comandos, diretórios ou hosts. Leia a operação solicitada e escolha um escopo adequado: uma vez, nesta sessão, sempre ou negar, quando essas opções estiverem disponíveis.
A permissão de sessão não é compartilhada entre membros do Team. Na implementação atual, a permissão “sempre”, válida entre conversas, é apagada quando o Orylo é encerrado. Formulários de entrada obrigatórios ainda precisam ser preenchidos a cada vez.
## Retome o uso após alterar uma permissão
1. **Confira a permissão específica** — Abra a seção correspondente de Privacidade e Segurança e ative o Orylo se quiser usar o recurso.
2. **Volte à origem** — Selecione o texto, coloque a janela em foco ou abra o Composer novamente. Não presuma que uma captura anterior que falhou foi preservada.
3. **Tente a ação novamente** — Execute a operação novamente. Algumas alterações do sistema exigem reiniciar o app. Restrições em dispositivos gerenciados podem exigir ajuda do administrador.
## Continue explorando
- [Privacidade e dados](https://orylo.io/pt-BR/docs/privacy-security)
- [Orylo Actions sensíveis ao contexto](https://orylo.io/pt-BR/docs/actions)
- [Solução de problemas](https://orylo.io/pt-BR/docs/troubleshooting)
- [Orylo Computer Use](https://orylo.io/pt-BR/docs/computer-use)
---
---
title: "Conta e dispositivos"
description: "Gerencie login, acesso e Macs ativados sem sincronizar seu trabalho."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/account"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Conta e dispositivos
Gerencie login, acesso e Macs ativados sem sincronizar seu trabalho.
## Use a mesma conta
Use Apple ou Google para fazer login no Mac e na [página da conta](https://orylo.io/pt-BR/account). Conclua a autorização no navegador e volte ao app quando solicitado.
Use a mesma identidade de login para seu direito de acesso. Um endereço privado de retransmissão da Apple e um endereço do Google não são tratados automaticamente como a mesma conta. Não há etapa de inserção de chave de licença.
## Entenda o acesso
O primeiro login elegível inicia um período de teste de sete dias, uma única vez por conta. Ao fim do teste, o envio de solicitações e a Barra de Ações exigem acesso válido adquirido por compra; o histórico e os ajustes continuam disponíveis.
Assinaturas de provedores e uso de APIs são separados. O Orylo não inclui créditos de modelos. Confira a tela de compra atual e os [Termos de Serviço](https://orylo.io/pt-BR/terms) para conhecer a oferta e as condições de reembolso, em vez de se basear em um preço copiado para este guia.
O fim do direito a atualizações não é o mesmo que o fim de um direito de uso adquirido e válido para a versão coberta.
## Gerencie seus Macs
Uma licença pessoal permite até dois Macs ativos, com até quatro ativações em um período móvel de 30 dias, incluindo as duas primeiras. Durante um período de teste válido ou um acesso válido adquirido por compra, desative um Mac antigo na página da conta e use Atualizar acesso no app do Mac que deseja ativar.
A desativação não devolve uma ativação à contagem do período móvel, não apaga o trabalho local nem revoga imediatamente uma verificação offline já armazenada em cache. O acesso offline em um Mac desativado pode durar até essa verificação expirar, no máximo 72 horas. O término do período de teste pode encerrar o acesso antes disso.
## Continue explorando
- [Sua primeira conversa](https://orylo.io/pt-BR/docs/quickstart)
- [Privacidade e dados](https://orylo.io/pt-BR/docs/privacy-security)
- [Solução de problemas](https://orylo.io/pt-BR/docs/troubleshooting)
---
---
title: "Atalhos de teclado"
description: "Tenha as ações frequentes por perto e confira os atalhos configuráveis nos Ajustes."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/shortcuts"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Atalhos de teclado
Tenha as ações frequentes por perto e confira os atalhos configuráveis nos Ajustes.
## Confira seus atalhos globais
Os atalhos de Composer, Ações e captura podem ser configurados. Os Ajustes mostram seus atalhos atuais; altere um atalho se outro app já o utilizar.
As dicas de entrada do app mostram atalhos que você ainda não usou. Um atalho exibido em uma captura de tela ou em um guia antigo pode não corresponder à sua configuração.
## Enquanto escreve
| Ação | Teclas |
| --- | --- |
| Enviar a solicitação | Return |
| Inserir uma nova linha | ⇧ + Return |
| Cancelar a entrada de voz ativa ou ocultar a janela de entrada | Esc |
| Percorrer prompts recentes em um Composer vazio | ↑ + ↓ |
| Negrito | ⌘ + B |
| Itálico | ⌘ + I |
| Código em linha | ⌘ + E |
## Na janela de conversa
Control + Option + D não é um atalho global. Command + Q encerra o Orylo; fechar uma janela não.
| Ação | Teclas |
| --- | --- |
| Pesquisar na conversa | ⌘ + F |
| Abrir a janela de trabalho do Orylo | ⌘ + 0 |
| Fechar a janela sem encerrar o app | ⌘ + W |
| Ativar ou desativar o rascunho por voz enquanto o Orylo está com o foco do teclado | ⌃ + ⌥ + D |
## Continue explorando
- [Escreva uma solicitação](https://orylo.io/pt-BR/docs/instant-chat)
- [Conversas e espaços de trabalho](https://orylo.io/pt-BR/docs/conversations)
- [Dite um rascunho](https://orylo.io/pt-BR/docs/voice)
---
---
title: "Configure o Remote Access"
description: "Pareie outro dispositivo com o Orylo em execução no seu Mac, por uma rede local confiável ou por sua própria conexão HTTPS."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/remote-access"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Configure o Remote Access
Pareie outro dispositivo com o Orylo em execução no seu Mac, por uma rede local confiável ou por sua própria conexão HTTPS.
## Remote Access é uma conexão com seu Mac
O Remote Access disponibiliza a interface do Remote Web a partir do seu Mac. Ele não é a demonstração no navegador do orylo.io, um Agent hospedado na nuvem nem um serviço de compartilhamento de tela por área de trabalho remota. Seu Mac precisa permanecer online, sem entrar em repouso e com o Orylo em execução.
Abra Settings → Remote. Remote Access controla as conexões pelo navegador; Messages controla os canais de mensagens. Seus controles de ativação são independentes: fechar Settings ou desabilitar o acesso pelo navegador não interrompe os canais de mensagens.
| Conexão | Uso e requisitos |
| --- | --- |
| Rede local | O celular e o Mac precisam conseguir se comunicar em uma rede local confiável. HTTP não é criptografado; não o exponha diretamente à internet pública. |
| HTTPS remoto | Use seu próprio proxy ou túnel HTTPS para alcançar o serviço de escuta no Mac. Configurar um endereço HTTPS no Orylo não instala um proxy, não cria um certificado nem comprova que o Mac pode ser acessado de fora da rede. |
## Conecte-se pela rede local
1. **Habilite o Remote Access** — Nas configurações do Mac, confira o endereço local e a porta, confirme que está ciente de que a conexão pela rede local não é criptografada e habilite o acesso. Comece com dispositivos na mesma rede e que consigam se comunicar.
2. **Pareie o dispositivo** — Escolha Pair a device (parear um dispositivo), abra o convite exibido ou leia o código QR no dispositivo desejado e aprove esse dispositivo no Mac. Não compartilhe o convite publicamente.
3. **Faça uma solicitação de teste inofensiva** — Abra uma conversa no Remote Web, verifique o Assistant e o espaço de trabalho e envie uma pequena solicitação de teste. Confira a resposta real; um serviço de escuta disponível, sozinho, não comprova o pareamento nem a execução do Agent.
## Acesse o Mac fora de casa
Para usar HTTPS, primeiro coloque o serviço de escuta do Mac em funcionamento e depois configure seu proxy ou túnel e a origem HTTPS externa exata nas configurações de Remote. Preserve o host e a origem externos ao passar pelo proxy; não desative as verificações de certificado ou de origem para corrigir erros de conexão.
Connect with Chat pode ajudar a inspecionar a configuração e preparar a configuração de um proxy. Você ainda precisa autorizar a exposição pública, inserir segredos com segurança e aprovar o dispositivo. Faça um pareamento separado para o endereço HTTPS; um pareamento pela rede local não equivale a um login por HTTPS.
Teste a partir da rede externa que pretende usar, como os dados móveis do celular com o Wi-Fi desligado. Uma solicitação à URL pública feita pelo Mac não comprova que o celular consegue acessá-la.
## Entenda a autorização e a desconexão
Um dispositivo Web pareado pode acessar todo o espaço de trabalho de conversas, incluindo conversas existentes, futuras e arquivadas — não apenas uma conversa selecionada. Pareie somente dispositivos confiáveis. O login na conta Orylo é separado dessa aprovação do dispositivo.
Revogue o acesso de um dispositivo indesejado nas configurações de Remote. A revogação remove o acesso desse dispositivo; ela não solicita o cancelamento de todas as tarefas em execução no Mac. Encerrar o acesso não exclui o histórico de conversas do app nativo.
Se o endereço mudar, use o endereço atual ou a alternativa por IP exibida no Mac e faça o pareamento novamente quando necessário. Verifique o repouso do Mac, o isolamento de rede, o roteamento da VPN e o status do proxy antes de alterar credenciais. O horário da última conexão não é um indicador de conectividade em tempo real.
## Continue explorando
- [Trabalhe no Remote Web](https://orylo.io/pt-BR/docs/remote-web)
- [Canais de mensagens compatíveis](https://orylo.io/pt-BR/docs/message-channels)
- [Create with Chat](https://orylo.io/pt-BR/docs/create-with-chat)
- [Privacidade e dados](https://orylo.io/pt-BR/docs/privacy-security)
---
---
title: "Trabalhe no Remote Web"
description: "Continue as conversas do app nativo do Mac pelo celular ou navegador, com arquivos, revisão do trabalho e tarefas agendadas."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/remote-web"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Trabalhe no Remote Web
Continue as conversas do app nativo do Mac pelo celular ou navegador, com arquivos, revisão do trabalho e tarefas agendadas.
## O mesmo trabalho, outro ponto de acesso
Depois de [parear seu dispositivo](https://orylo.io/pt-BR/docs/remote-access#pair-device), o Remote Web usa as mesmas conversas, Assistants, espaços de trabalho, histórico e ambiente de execução do Mac. Ele não envia uma segunda cópia para o backend da conta Orylo.
Navegar pela interface Web não altera a conversa selecionada no Mac nem sobrescreve o rascunho do Composer. Enviar uma solicitação ou realizar uma ação explícita afeta a conversa de destino no seu Mac.
| Área | O que você pode fazer |
| --- | --- |
| Conversas | Navegar, pesquisar, criar, renomear, arquivar ou restaurar conversas e adicionar ou remover suas etiquetas. Escolha entre os Assistants e espaços de trabalho já disponíveis no Mac. |
| Composer | Enviar texto e anexos compatíveis; escolher as opções de modelo, Skills e prompts favoritos disponíveis. O Assistant selecionado determina o que pode processar. |
| Mensagens e controle | Ler e copiar respostas, visualizar anexos, interromper uma execução específica, responder a perguntas compatíveis e aprovar ou negar solicitações compatíveis de forma pontual. |
| Revisão do trabalho | Em espaços de trabalho de Agents, inspecionar alterações e visualizar arquivos na barra lateral direita. As ações Git disponíveis operam no repositório do Mac; a prévia de arquivos não é um editor. |
| Teams e ramificações | Ler atividades existentes de Teams e conversas dos membros. Criar uma ramificação a partir de uma resposta concluída elegível, com o histórico completo ou um resumo editável; a criação e o gerenciamento de Teams continuam no Mac. |
| Tarefas agendadas | Usar o calendário e os detalhes das tarefas para criar, editar, pausar, retomar, executar ou excluir tarefas. Elas continuam sendo executadas pelo agendador do Mac. |
## Continue uma tarefa pelo celular
1. **Escolha a conversa** — Abra o painel lateral esquerdo e selecione a conversa ou crie uma com um Assistant disponível. Um espaço de trabalho é um diretório no Mac, não uma pasta no celular.
2. **Adicione apenas o contexto necessário** — Revise o Assistant, as opções de modelo, o texto e os anexos antes de enviar. O menu de adição oferece anexos e itens disponíveis da Library. Confira os limites de anexos exibidos.
3. **Revise o resultado** — Acompanhe a resposta e inspecione arquivos ou alterações quando houver suporte. Se uma solicitação exigir uma decisão de permissão ou uma alteração de configuração sem suporte na interface Web, conclua essa etapa no Mac.
## Recursos disponíveis e limitações
O Remote Web não transforma o celular em uma área de trabalho remota nem oferece acesso irrestrito aos arquivos do Mac. A navegação por arquivos se limita ao espaço de trabalho autorizado no Mac. Operações de escrita do Git exigem ações explícitas; confira seu escopo antes de fazer commit, push ou pull.
As permissões do Mac e as políticas do Agent continuam valendo. O navegador oferece apenas as decisões pontuais compatíveis, não uma autorização geral que substitua as permissões. Se uma interrupção de rede deixar o resultado de uma operação incerto, confira o estado resultante antes de repeti-la.
A qualidade da conexão, os teclados de dispositivos móveis, os anexos e o comportamento específico de cada plataforma precisam ser verificados nos seus dispositivos reais; a demonstração do site não valida uma conexão Remote real.
## Continue explorando
- [Configure o Remote Access](https://orylo.io/pt-BR/docs/remote-access)
- [Canais de mensagens compatíveis](https://orylo.io/pt-BR/docs/message-channels)
- [Revise arquivos e alterações](https://orylo.io/pt-BR/docs/change-review)
- [Agende tarefas recorrentes](https://orylo.io/pt-BR/docs/scheduled-tasks)
---
---
title: "Canais de mensagens compatíveis"
description: "Acesse o Orylo pelo iMessage, Telegram, Discord, WeChat, Slack ou Feishu/Lark — com autorização explícita para cada chat."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/message-channels"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Canais de mensagens compatíveis
Acesse o Orylo pelo iMessage, Telegram, Discord, WeChat, Slack ou Feishu/Lark — com autorização explícita para cada chat.
## Escolha um canal
Abra Settings → Remote → Messages. Cada canal tem seu próprio controle de ativação e sua própria configuração de conexão; não é necessário habilitar o Remote Web. Seu Mac precisa permanecer sem entrar em repouso, conectado e com o Orylo em execução.
Essas integrações de canais estão implementadas na versão atual do app para Mac, mas isso não é uma promessa de disponibilidade universal nas plataformas. As políticas dos provedores, o acesso regional, a instalação de apps e as permissões continuam se aplicando. Verifique a configuração e uma troca real de mensagem e resposta com sua própria conta.
| Canal | Configuração | Escopo das conversas |
| --- | --- | --- |
| iMessage | Use o app Mensagens neste Mac, instale o auxiliar opcional do Orylo quando solicitado e conceda as permissões necessárias do macOS. | Chats individuais conectados explicitamente; não é uma caixa de entrada com todo o seu histórico do Mensagens. |
| Telegram | Adicione as credenciais do seu bot com segurança nas configurações do Mac; a integração usa polling, não webhook. | Mensagens diretas aprovadas com bots; é possível configurar vários bots. |
| Discord | Instale seu bot e insira suas credenciais com segurança; os usuários precisam conseguir enviar mensagens a ele. | Mensagens diretas aprovadas com bots, não mensagens de canais de servidores ou de grupos; há suporte a vários bots. |
| WeChat pessoal | Use o login nativo do iLink por código QR e confirme no WeChat. | Chats privados autorizados, não grupos do WeChat; as respostas exigem um contexto válido de mensagem recebida recentemente. |
| Slack | Instale seu app do Slack com os escopos e eventos necessários e o Socket Mode; Connect with Chat pode ajudar a preparar a configuração. | Mensagens diretas aprovadas, além de @menções em canais explicitamente aprovados, com threads de conversa separadas. |
| Feishu / Lark | Configure as permissões, os eventos, as credenciais e a conexão persistente do app para a região correta. | Chats privados aprovados; pode ser necessária a aprovação da plataforma ou da organização. |
## Conecte e verifique um chat
As mensagens de um chat autorizado usam a conversa vinculada no app nativo do Orylo. Alterar o vínculo não reescreve o histórico antigo, e o histórico anterior do chat não é importado nem reprocessado como novas tarefas. Consulte a ajuda do canal para ver os comandos de gerenciamento de conversas compatíveis; os comandos privados do Slack usam o prefixo /orylo.
1. **Prepare o canal** — Use a configuração nativa do canal para inserir um token no campo apropriado ou fazer login por código QR. Para permissões de apps em várias etapas, instalação ou diagnóstico, escolha Connect with Chat. Insira segredos somente nos campos seguros da interface nativa, não na conversa.
2. **Autorize o contato desejado** — Para parear um bot, envie uma mensagem privada e compare o código de pareamento retornado com a solicitação no Mac antes de aprovar. No iMessage, use o fluxo nativo de novo chat. Selecione ou crie a conversa desejada no Orylo e confirme o Assistant e o espaço de trabalho.
3. **Envie uma nova solicitação de teste** — A mensagem inicial de pareamento do bot não é executada nem reprocessada como tarefa. Após a autorização, envie uma nova solicitação inofensiva e confira a resposta final. Uma conexão de transporte estabelecida ou um envio de teste bem-sucedido não comprovam que o Agent consegue concluir o trabalho.
## Menções em canais do Slack são uma exceção explícita
Depois que você aprova um canal do Slack no Mac, qualquer membro desse canal pode acionar o Orylo com uma @menção. Cada thread recebe sua própria conversa no app nativo, e as respostas permanecem nessa thread. Decida se esse acesso para todos os membros do canal é adequado antes de aprová-lo.
Orylo não importa o histórico do canal nem envia ao Agent mensagens comuns ou respostas em threads que não mencionem o bot. Uma thread de canal não pode ser vinculada a uma conversa existente e não aceita comandos de gerenciamento de chats privados. Desconectar uma thread revoga as conexões desse bot em todo o canal; o histórico nativo é preservado.
O Slack pode exigir permissões de aplicativo mais amplas que as regras de processamento de mensagens do Orylo. Orylo pode consultar a mensagem inicial de uma conversa em thread para dar um título a ela, mas não a envia ao Agent como contexto. Confira as permissões realmente solicitadas pelo aplicativo antes de instalá-lo.
## Saiba o que passa pelo canal
Os canais entregam respostas de texto finais, em vez de uma saída token por token. O suporte a anexos recebidos depende do canal e do Assistant; uma falha em um anexo obrigatório faz com que a entrada seja rejeitada, em vez de enviar silenciosamente apenas sua legenda. Não presuma que todo anexo do app nativo ou resultado com conteúdo avançado possa ser devolvido por todas as plataformas.
Canais de mensagens não concedem aprovação automática a solicitações de permissão do Agent. Conclua no Mac as aprovações sem suporte no canal; uma simples mensagem de “sim” não é permissão para ignorá-las. Use o Remote Web quando precisar dos controles interativos compatíveis que ele oferece.
Somente chats autorizados são conectados, mas as mensagens que você envia e as respostas entregues por uma plataforma também passam por essa plataforma. O armazenamento prioritariamente local do Orylo não torna local um serviço externo de mensagens nem garante criptografia de ponta a ponta. Desabilitar um canal interrompe esse ponto de acesso, não o app nativo do Mac nem todas as suas tarefas.
## Continue explorando
- [Configure o Remote Access](https://orylo.io/pt-BR/docs/remote-access)
- [Trabalhe no Remote Web](https://orylo.io/pt-BR/docs/remote-web)
- [Create with Chat](https://orylo.io/pt-BR/docs/create-with-chat)
- [Permissões e controle](https://orylo.io/pt-BR/docs/permissions)
---
---
title: "Solução de problemas"
description: "Comece pela etapa que falha, preserve seu rascunho e confira o resultado antes de tentar novamente."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/troubleshooting"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Solução de problemas
Comece pela etapa que falha, preserve seu rascunho e confira o resultado antes de tentar novamente.
## O Assistant se conecta, mas não consegue responder
1. **Teste a origem** — Para um Agent local, faça uma solicitação na CLI ou no cliente do próprio Agent. Confira ali o login, as credenciais de API, a assinatura e a cota.
2. **Verifique novamente no Orylo** — Abra os ajustes do Assistant, inspecione o motivo da falha e execute a verificação novamente após corrigir a origem. Confira o modelo e as opções configurados.
3. **Use uma solicitação pequena** — Tente texto simples sem anexos. Reintroduza o contexto original aos poucos para distinguir uma falha de conexão de uma entrada não compatível ou de um limite de tamanho.
## A seleção, as capturas de tela ou a voz não aparecem
- Confirme que a captura automática da seleção está ativada se esse for o recurso que você espera usar; ela vem desativada por padrão.
- Confira a permissão correspondente do macOS e tente novamente no app de origem. O conteúdo da área de transferência não é usado como alternativa quando a seleção não pode ser lida.
- Para fala, verifique o mecanismo escolhido explicitamente, o idioma compatível e o modelo Whisper baixado. O Orylo não troca de mecanismo silenciosamente.
- Para OCR, confira a opção global e a preferência de imagens do Assistant. Revise a imagem original quando a extração falhar.
## Uma tarefa agendada não foi executada
Confira se o Orylo estava em execução, se o Mac estava acordado, se o agendamento estava ativado e se o fuso horário e a próxima execução estavam corretos. Inspecione o histórico de execuções em busca de uma tentativa que falhou antes de iniciar outra.
Execuções perdidas são ignoradas por padrão. Pausar acionamentos futuros não interrompe uma execução já ativa.
## O login ou o acesso do dispositivo está bloqueado
Confirme que a mesma identidade Apple ou Google é usada no site e no Mac. Confira o status do teste ou da compra e a lista de dispositivos ativos e use Atualizar acesso no app.
Ao atingir o limite de ativações, desativar um Mac não restaura uma ativação consumida no período móvel. Siga as ações e os prazos disponíveis na página da conta.
## Peça ajuda com segurança
Use [Enviar feedback](https://orylo.io/pt-BR/feedback) ou envie um e-mail para support@orylo.io com a operação, o erro visível, a versão do app/macOS e passos concisos para reproduzir o problema. O envio de feedback pelo site exige login.
Não inclua tokens, chaves de API, prompts privados nem anexos confidenciais. Se uma tarefa que altera dados ou sistemas já puder ter sido concluída, inspecione o resultado antes de tentar novamente.
## Continue explorando
- [Conecte um Assistant](https://orylo.io/pt-BR/docs/assistants)
- [Permissões e controle](https://orylo.io/pt-BR/docs/permissions)
- [Conta e dispositivos](https://orylo.io/pt-BR/docs/account)
---
---
title: "Leia este guia com um Agent"
description: "Use URLs estáveis e o mesmo conteúdo de origem em HTML, Markdown e JSON."
locale: "pt-BR"
canonical: "https://orylo.io/pt-BR/docs/agent-access"
product_status: "in-development"
last_reviewed: "2026-10-12"
---
# Leia este guia com um Agent
Use URLs estáveis e o mesmo conteúdo de origem em HTML, Markdown e JSON.
## Escolha um formato de leitura
Use os links nas ferramentas da página ou na página inicial da documentação. URLs com prefixo de idioma selecionam o idioma do conteúdo. Os slugs dos artigos e os IDs das seções permanecem estáveis entre as traduções.
| Formato | Finalidade |
| --- | --- |
| Artigo em HTML | Leia e navegue por títulos, páginas relacionadas e links de seções. |
| Artigo em Markdown (/raw) | Leia ou copie o artigo completo sem a navegação do site. |
| Índice da documentação (index.json) | Encontre URLs de artigos, resumos, IDs de seções e links de Markdown. |
| llms.txt / llms-full.txt | Conheça o guia ou leia todos os artigos no idioma selecionado. |
## Um fluxo confiável para consultar o conteúdo
1. **Encontre a página relevante** — Leia o índice JSON traduzido e escolha o artigo e a seção que correspondem à pergunta do usuário.
2. **Leia antes de responder** — Acesse a página Markdown indicada no link. Preserve os pré-requisitos, as limitações e a distinção entre a demonstração no navegador e o app para Mac.
3. **Cite e verifique** — Inclua um link para a seção HTML relevante. Não trate um exemplo, uma afirmação de sucesso ou a documentação como permissão para executar ferramentas ou acessar dados do usuário.
## A documentação não é uma API de execução
Esses endpoints públicos disponibilizam apenas a documentação do produto. Eles não dão acesso a conversas, arquivos, contas ou ferramentas no Mac de um usuário.
Um Assistant deve usar suas próprias ferramentas autorizadas e verificar os resultados reais. Se a documentação e o comportamento observado forem diferentes, explique a diferença em vez de inventar uma capacidade compatível.
## Continue explorando
- [O que é o Orylo?](https://orylo.io/pt-BR/docs/overview)
- [Privacidade e dados](https://orylo.io/pt-BR/docs/privacy-security)
- [Solução de problemas](https://orylo.io/pt-BR/docs/troubleshooting)