Guia do usuário do Orkas
Comece com uma tarefa e conheça cada recurso principal pelos controles visíveis no app desktop. Privacidade, segurança e perguntas frequentes ficam em uma seção separada.
# Diga diretamente o que você quer fazer
Abra uma nova tarefa e descreva o resultado em uma ou duas frases. Se houver várias tarefas, liste uma por linha. O Orkas ajuda a dividi-las e pergunta apenas pelos detalhes importantes que faltarem.
Por exemplo:
- Resuma este relatório e liste as decisões que preciso tomar.
- Compare estas três opções e recomende uma dentro do meu orçamento.
- Transforme estas notas em uma apresentação para a revisão da próxima semana.
Você também pode perguntar ao Commander como usar o Orkas. Em solicitações compatíveis, ele oferece um atalho que abre ao clicar ou conclui a alteração pelo fluxo dedicado; credenciais, autorizações e confirmações importantes continuam sob sua ação.
# Sua primeira tarefa
Uma boa solicitação informa o resultado, os materiais, o público ou uso e os limites importantes de formato, prazo ou aprovação.
Abra uma nova tarefa
Inicie uma nova tarefa na área principal de conversa.
Descreva o resultado
Explique como é um resultado bem-sucedido e quais restrições importam.
Adicione apenas o material relevante
Anexe um arquivo ou selecione agente, habilidade, conector ou fonte da biblioteca quando necessário.
Escolha a execução
Use o modelo exibido na entrada. Para adicionar um agente CLI externo, use “Conectar agentes” no rodapé da barra lateral ou “Equipe de IA” > “+ Criar” > “Externo”.
Acompanhe o progresso
Responda decisões, detalhes faltantes, permissões ou formulários para a tarefa continuar.
Revise o resultado
Abra ou baixe a saída e peça uma revisão específica na mesma tarefa quando o contexto ainda servir.
# Configuração de modelos
O Orkas oferece duas formas de usar modelos de chat: escolher um modelo oficial gerenciado pelo Orkas e disponível para sua conta, ou conectar um provedor que você já usa. A escolha muda capacidade, velocidade, custo, cobrança e o caminho da solicitação.
O que oferece
- Os modelos oficiais incluem Orkas-1.5 e Orkas-1.5 Pro. A seleção atual de modelos avançados abrange DeepSeek V4, a série GPT-5.6, a série Claude 5, Gemini 3.6 Flash e Kimi K3; a lista exibida no Orkas é sempre a referência atual.
- Modelos configurados pelo usuário permitem conectar seu provedor por OAuth ou chave de API, ou adicionar um endpoint compatível com OpenAI usando o ID exato do modelo.
- Os modelos de chat compartilham o seletor da tarefa. Busca, imagem, vídeo e texto para fala são configurados separadamente, enquanto agentes CLI externos usam a configuração da própria CLI.
Ideal para
- Você quer acesso gerenciado a modelos atuais sem configurar uma chave de provedor.
- Você quer usar sua conta, cobrança, endpoint ou modelo específico de um provedor.
- A tarefa exige outro perfil de raciocínio, código, visão, velocidade ou custo.
Comece aqui
- Abra “Configurações da conta” > “Modelos”. Ative um “Modelo oficial” disponível ou adicione e teste um provedor em “Modelos configurados pelo usuário”.
- Na tarefa, abra o controle de modelo e escolha o modelo oficial ou a configuração de provedor salva que deseja usar.
- Configure busca, imagem, vídeo ou texto para fala em seu próprio grupo somente quando a tarefa precisar desse serviço.
# Projetos
Um projeto oferece um espaço compartilhado para uma meta contínua, para que tarefas relacionadas partam do mesmo contexto sem reconstruí-lo em cada conversa.
O que oferece
- Mantenha juntos a meta, instruções estáveis, formato preferido e memória do projeto.
- Reutilize agentes, fontes da biblioteca e outros recursos usados com frequência no trabalho.
- Organize tarefas, conversas, pendências e automações do projeto em um só lugar.
Ideal para
- Um objetivo exige várias tarefas, como lançar um produto, manter uma pesquisa ou produzir conteúdo ao longo do tempo.
- As próximas tarefas devem usar o mesmo contexto, regras, formato preferido, agentes ou referências.
- Tarefas, pendências e automações agendadas pertencem ao mesmo trabalho contínuo.
Comece aqui
Crie ou abra um projeto, descreva o objetivo contínuo e adicione apenas instruções e recursos que devem valer para várias tarefas.
- Coloque nas instruções do projeto as regras que devem valer para tarefas futuras (até 4000 caracteres).
- Coloque orientações temporárias na tarefa atual.
- Adicione apenas agentes e fontes usados regularmente neste projeto e revise memória e pendências conforme o trabalho muda.
- No Orkas 1.7.0, peça ao Commander para gerenciar pendências de um Projeto existente. Em um chat comum, informe o nome do Projeto; se houver ambiguidade, confirme o destino antes de salvar alterações. Isso não move a conversa para o Projeto.
# Automações
A automação transforma uma instrução bem definida em trabalho executado uma vez no futuro ou em uma agenda recorrente, sem iniciar manualmente a mesma tarefa toda vez.
O que oferece
- Agende uma execução única ou repita a cada poucas horas, diariamente, semanalmente ou mensalmente, com data final ou limite de execuções opcional.
- Vincule a automação a um projeto para usar seu contexto e recursos estáveis em cada execução.
- Use modelos e conectores configurados, revise resultados anteriores e pause execuções futuras sem apagá-los.
Ideal para
- Você precisa de relatório, resumo, coleta ou revisão a cada poucas horas, diariamente, semanalmente ou mensalmente.
- Uma verificação recorrente deve usar sempre o mesmo contexto de projeto ou serviço conectado.
- Uma tarefa única precisa rodar em um horário futuro específico, sem depender de você lembrar.
Comece aqui
Abra “Automático”, escreva a instrução como deverá ser entendida na execução, escolha agenda, condição de término e projeto opcionais e o dispositivo, salve e ative. Revise o primeiro resultado antes de depender das próximas execuções.
# Agentes
Um agente é um especialista reutilizável que assume um tipo de trabalho com função, método, padrão de qualidade, capacidades e memória próprios.
O que oferece
- Transforme expectativas profissionais recorrentes em um especialista selecionável, sem repeti-las toda vez.
- Defina fluxo, entradas necessárias, padrões de entrega, memória e acesso às capacidades relevantes.
- Use um agente executado pelo Orkas ou conecte uma CLI local compatível, como Codex, Claude Code ou OpenCode.
Ideal para
- Você precisa com frequência da mesma perspectiva especializada, como pesquisa, design de produto, análise de dados ou revisão de conteúdo.
- O trabalho deve manter padrões de qualidade, capacidades específicas ou contexto ligado à função.
- Você quer que uma CLI externa local, como Codex, Claude Code ou OpenCode, assuma uma tarefa.
Comece aqui
- Abra “Equipe de IA” e escolha “+ Criar” para definir um agente do Orkas; depois, revise fluxo, entradas, padrões e memória.
- Selecione um agente na entrada da tarefa quando esse especialista deve assumir o trabalho. Adicione apenas agentes que contribuam para o resultado.
- Para usar Codex, Claude Code, OpenCode ou outra CLI compatível, instale e autentique a CLI e escolha “Conectar agentes” ou “Equipe de IA” > “+ Criar” > “Externo”.
- Nos detalhes do agente externo, use as configurações de execução para escolher as opções compatíveis de modelo, raciocínio e permissão. “Pedir permissão” encaminha a solicitação nativa da CLI para a confirmação do Orkas, mostra a ação ou o caminho selecionado e devolve a decisão à CLI. O OpenCode usa Acesso total fixo e oculta o seletor de permissão.
- Para Claude Code, Codex e OpenCode, use os detalhes do agente para manter o espaço de trabalho padrão ou escolher um diretório de projeto. Durante uma tarefa, peça para trocar de projeto e escolha outra pasta existente.
# Habilidades
Uma habilidade empacota como executar um trabalho repetível — passos, verificações, referências e resultado esperado — para reutilizar o mesmo método em tarefas e agentes diferentes.
O que oferece
- Preserve um método comprovado, checklist, modelo e regras de saída em um fluxo reutilizável.
- Aplique o mesmo método em tarefas e agentes sem criar outra identidade de especialista.
- Crie manualmente, por URL ou pasta, importe um ZIP local de habilidade ou instale uma opção existente no Marketplace.
Ideal para
- Os mesmos passos, modelo, verificações ou formato de saída devem ser usados com frequência.
- Vários agentes ou tarefas devem seguir um único método de trabalho.
- Você quer transformar um guia, URL ou pasta local em um fluxo reutilizável.
Comece aqui
- Abra “Habilidades” e escolha “+ Criar” para começar manualmente, por URL ou pasta. Conclua a conversa de edição antes de usar.
- Selecione a habilidade na tarefa, descreva o resultado normalmente e inclua as entradas necessárias ao fluxo.
- Explore o Marketplace quando quiser usar um fluxo existente em vez de criar um do zero.
# Conectores
Um conector dá ao Orkas acesso autorizado a um serviço externo, permitindo usar dados atuais ou executar ações permitidas sem exportar arquivos repetidamente.
O que oferece
- Leia informações atuais da conta ou do espaço de trabalho conectado quando a tarefa precisar.
- Crie, atualize, envie ou execute outras ações compatíveis dentro do acesso autorizado.
- Conecte um serviço do catálogo pelo fluxo de autorização ou adicione um servidor MCP personalizado confiável.
Ideal para
- A tarefa precisa de informações atuais que mudam em um serviço externo.
- O Orkas deve criar, atualizar, enviar ou realizar outra ação nesse serviço com sua autorização.
- Um fluxo recorrente deve usar o mesmo espaço de trabalho ou conta conectada sem exportar arquivos toda vez.
Comece aqui
- Abra “Conectores”, conecte um serviço do catálogo, conclua a autorização e confirme o estado conectado.
- Para um servidor confiável fora do catálogo, use “Adicionar servidor MCP” e revise o endereço remoto ou comando local antes de conectar.
- Selecione o conector apenas nas tarefas necessárias e indique claramente o que o Orkas pode ler ou fazer.
No Orkas 1.7.0, as ações dos conectores seguem Configurações da conta > Geral > Permissões de operações locais, inclusive nas chamadas de agentes CLI externos. Leituras reconhecidas e edições comuns dispensam confirmação. Cauteloso e Padrão pedem confirmação para ações sensíveis ou não classificadas; Confiável executa as ações disponíveis sem confirmação. Ações proibidas continuam indisponíveis.
# Biblioteca
A biblioteca transforma documentos de referência e materiais estáveis em conhecimento reutilizável. Após o processamento, o Orkas recupera os trechos mais relevantes para uma pergunta ou tarefa sem reenviar e procurar manualmente nos mesmos arquivos.
O que oferece
- Faça perguntas rápidas e obtenha respostas baseadas em políticas, manuais, pesquisas, notas ou materiais de produto já processados.
- Compare, resuma, extraia ou escreva com uma coleção selecionada sem localizar manualmente cada trecho.
- Reutilize as mesmas fontes em tarefas futuras, projetos e dispositivos sincronizados compatíveis.
Ideal para
- Você quer busca e perguntas rápidas baseadas em fontes como políticas, manuais, pesquisas, materiais de produto ou notas de reunião.
- Várias tarefas precisam comparar, resumir, extrair ou escrever com a mesma coleção de fontes.
- O material deve continuar disponível para tarefas futuras ou outro dispositivo sincronizado, não apenas como anexo de uso único.
Comece aqui
- Abra “Biblioteca”, adicione fontes compatíveis, use nomes reconhecíveis e aguarde o processamento terminar.
- No Commander ou em uma tarefa de projeto, selecione apenas as fontes relevantes para a pergunta atual.
- Faça uma pergunta direta ou descreva o resultado. Quando a resposta precisar ficar restrita ao material, peça explicitamente para usar somente as fontes selecionadas.
# Meus aplicativos
Meus aplicativos transforma resultados interativos compatíveis em ferramentas reutilizáveis que você abre sem localizar e reabrir a conversa original.
O que oferece
- Salve painéis, calculadoras, formulários, rastreadores e outros resultados interativos compatíveis em um só lugar.
- Abra e use diretamente um app salvo depois que a tarefa de origem terminar.
- Volte à tarefa de origem para revisões, preserve uma nova versão quando necessário e exporte dados quando o app permitir.
Ideal para
- O Orkas cria um painel, calculadora, formulário, rastreador ou outra ferramenta interativa reutilizável.
- Você quer manter um resultado fácil de abrir depois que a tarefa terminar.
- Você precisa preservar uma versão útil e voltar à tarefa de origem para revisões futuras.
Comece aqui
Quando o resultado oferecer salvar, guarde o aplicativo elegível em “Meus aplicativos”. Volte à tarefa de origem para revisões, salve nova versão quando necessário e exporte dados importantes quando disponível.
# Sincronização em nuvem
A sincronização em nuvem mantém dados compatíveis do Orkas disponíveis em computadores conectados à mesma conta, permitindo continuar sem exportar e importar manualmente.
O que oferece
- Leve tarefas, projetos, agentes, habilidades e fontes da biblioteca compatíveis para outros dispositivos conectados.
- Continue o mesmo fluxo em outro computador depois que as alterações terminarem de sincronizar.
- Mantenha fora da sincronização dados locais, incluindo chaves de API de modelos e anexos de tarefas.
Ideal para
- Você usa o Orkas em mais de um computador e quer que o trabalho compatível acompanhe sua conta.
- Uma tarefa, projeto, agente, habilidade ou fonte da biblioteca criada em um dispositivo deve estar disponível em outro.
- Você quer continuar um fluxo em outro dispositivo conectado sem exportar e importar manualmente.
Comece aqui
Abra “Configurações da conta” > “Dados”, ative a sincronização em cada dispositivo participante, mantenha o Orkas aberto durante o primeiro envio e aguarde a conclusão antes de editar o mesmo item em outro computador.
Saiba antes de depender dela
- Mantenha o Orkas aberto e conectado até uma grande alteração terminar de sincronizar e não edite o mesmo item em outro dispositivo antes disso.
- Anexos da tarefa não são sincronizados com ela. Adicione um arquivo compatível à biblioteca quando precisar reutilizá-lo em outro dispositivo sincronizado.
- As chaves de API dos modelos permanecem no dispositivo configurado e não são sincronizadas com a nuvem.
- Desativar a sincronização em um dispositivo interrompe sincronizações futuras nele; isso não exclui os dados da nuvem.
# Privacidade e segurança
O Orkas é local-first, mas modelos, conectores, agentes CLI externos, sincronização opcional e compartilhamento podem enviar ou armazenar os dados necessários. As chaves de modelo ficam no dispositivo configurado e os anexos não sincronizam com a tarefa. Revise conta, serviços, modo de permissão e confirmação antes de trabalho sensível. Veja os limites atuais em Segurança e Confiança.
# Perguntas frequentes
Como inicio uma tarefa no Orkas?
Abra uma nova tarefa e descreva o resultado desejado. Se houver várias, liste uma por linha. Adicione apenas os arquivos ou recursos necessários e acompanhe o estado até a conclusão.
Quando devo usar anexo, biblioteca ou projeto?
Use um anexo para uma conversa, a biblioteca para materiais reutilizáveis e um projeto quando várias tarefas compartilham instruções, fontes, memória ou automações.
O que verificar quando uma tarefa não roda?
Verifique primeiro o estado visível. Você pode pedir ao Commander que inspecione o estado sanitizado compatível do app e ofereça um atalho para a tela relevante. Responda às perguntas pendentes, restaure recursos indisponíveis e só repita depois de confirmar se uma ação externa já ocorreu.
Onde gerencio modelos, permissões, memória, sincronização e dados da conta?
Abra a conta no rodapé da barra lateral e escolha “Configurações da conta”. Use “Conta” para plano e créditos restantes, “Dados” para memória e sincronização, “Modelos” para chat e serviços e “Geral” para permissões, notificações, idioma e atualizações.