OrkasOrkas
Início › Documentação

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.

1

Abra uma nova tarefa

Inicie uma nova tarefa na área principal de conversa.

2

Descreva o resultado

Explique como é um resultado bem-sucedido e quais restrições importam.

3

Adicione apenas o material relevante

Anexe um arquivo ou selecione agente, habilidade, conector ou fonte da biblioteca quando necessário.

4

Escolha a execução

Use o modelo exibido na entrada. Para adicionar um agente CLI externo, use “Conectar agente de código” na página “Equipe de IA” ou o seletor @ de agentes no compositor.

5

Acompanhe o progresso

Responda a pedidos de decisão, detalhes, permissão ou formulário. O Codex pode mostrar um painel de perguntas acima do campo de mensagem enquanto trabalha: escolha ou digite cada resposta e selecione Enviar resposta. O rascunho permanece ao trocar de tarefa. Você pode responder enquanto a execução atual da CLI aceitar entradas. Selecione Cancelar para fechar uma pergunta sem resposta, sem enviar uma resposta nem parar a tarefa. A pergunta continua fechada após trocar de tarefa ou recarregar. Se o cancelamento falhar, o rascunho é mantido para tentar novamente. O painel também fecha após responder ou ao fim da execução. A resposta enviada permanece na conversa. Envie uma nova mensagem para continuar após o fim da execução. Nas perguntas do Claude Code, escolha opções ou digite uma resposta própria e confirme as seleções múltiplas.

6

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.

Mantenha o controle: Use “Parar tarefa” quando a direção atual não deve continuar. Parar não desfaz ações já concluídas.

As mensagens na fila oferecem Enviar agora quando disponível, Editar e Cancelar. Editar devolve a mensagem, os anexos, as referências e os recursos à caixa de entrada principal. As próximas mensagens aguardam enquanto as respostas em andamento continuam. Use o botão de confirmação para salvar na mesma posição, Esc para manter a mensagem original ou Cancelar na linha da mensagem na fila para cancelá-la sem enviar. Ao concluir, seu rascunho anterior é restaurado. As edições permanecem ao trocar de tarefa ou recarregar a janela; se o salvamento falhar, o texto fica disponível para tentar novamente.

Use @ ou o painel de destinatários para escolher agentes; os selecionados aparecem no topo para remoção. As menções são inseridas na posição do cursor. Um @ no início substitui o destinatário atual; o texto anterior ao primeiro @ vai para o destinatário atual, e cada @ posterior inicia uma nova instrução. Menções adjacentes compartilham a descrição seguinte. Após o envio ser aceito, um único destinatário permanece selecionado; com vários, a próxima mensagem volta ao Commander. Quando Commander transfere a tarefa, o agente responsável é selecionado. Uma delegação temporária mantém o destinatário até o agente pedir sua participação; um formulário seleciona seu agente. Perguntar sobre o formulário não o envia. Uma transferência explícita para Commander também muda o destinatário; uma escolha manual posterior tem prioridade.

# 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.

Para um endpoint personalizado com suporte a Responses, selecione OpenAI Responses no campo Protocolo. Use a URL base da API; /responses no final é removido automaticamente. As configurações existentes mantêm o protocolo selecionado.

O que oferece

  • Os Modelos integrados do Orkas incluem Orkas-1.5 e Orkas-1.5 Pro. A seleção atual de modelos avançados abrange DeepSeek V4.1 Flash, a série GPT-6, a série Claude 5, Gemini 3.8 Flash e Kimi K3; a lista exibida no Orkas é sempre a referência atual.
  • Com “Sua própria API Key”, você pode conectar seu provedor por OAuth ou chave de API, ou adicionar um endpoint compatível com OpenAI ou Anthropic usando o ID exato do modelo. Para usar um plano do ChatGPT, escolha OpenAI Codex e autorize sua conta; a opção OpenAI usa uma chave de API cobrada separadamente do plano. Para um plano do Claude, escolha Anthropic e autorize sua conta; a opção de chave de API é cobrada separadamente.
  • 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. O seletor compartilhado permanece visível, mas desativado, quando todos os destinatários são agentes CLI externos.

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

  1. Abra “Configurações da conta” > “Modelos”. Ative um dos “Modelos integrados do Orkas” ou adicione e teste um provedor em “Sua própria API Key”.
  2. Na tarefa, abra o controle de modelo e escolha o modelo oficial ou a configuração de provedor salva que deseja usar.
  3. Configure busca, imagem, vídeo ou texto para fala em seu próprio grupo somente quando a tarefa precisar desse serviço.
Disponibilidade e dados: A disponibilidade de modelos oficiais pode depender de login, créditos e acesso da conta. As chaves de seu provedor ficam neste dispositivo, e essas chamadas vão diretamente para ele. Consulte a lista do app para a seleção mais recente. Chat executado pelo Orkas: Este modelo requer uma janela de contexto de pelo menos 32000 tokens. Escolha um modelo com uma janela maior.

# 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 em “Metas e regras” 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.
  • Criar ou editar uma pendência não associa uma conversa. Após iniciar a execução com sucesso, abra “Conversa da tarefa” no cartão para voltar à execução mais recente. Uma nova execução iniciada com sucesso atualiza o vínculo; falhas ao iniciar ou mudanças apenas de status não o alteram.

Adicionar uma tarefa existente a um Projeto

Em uma tarefa fora de um Projeto, abra o menu de três pontos e escolha Adicionar ao projeto. Selecione um Projeto existente e clique em Mover, ou escolha Novo projeto e confirme o nome. A ação fica desativada durante a execução; aguarde o término ou pare a tarefa e espere o trabalho restante terminar. O histórico e os anexos acompanham a tarefa.

Os Agents participantes vêm selecionados; desmarque os que não deseja adicionar. Tarefas apenas com o Commander não exibem a seção de Agents. Desmarcar um Agent não remove um membro já existente no Projeto.

Se alguns Agents não puderem ser adicionados, a tarefa e os membros adicionados com sucesso permanecem no Projeto. A mensagem informa quantas adições falharam; abra o Projeto para verificar os membros.

O Commander também pode fazer isso sozinho na resposta que entrega um resultado: um pedido recorrente se torna uma Automação, e o trabalho voltado a um objetivo mais longo ganha um Projeto novo com as primeiras tarefas, com esta conversa movida para ele. Para desfazer, diga isso na mesma conversa ou escolha Remover do projeto, a entrada que uma tarefa dentro de um Projeto mostra em vez de Adicionar ao projeto.

Compartilhar um Projeto

Como proprietário, abra Membros > Convidar membros, revise o que será compartilhado e crie e copie o link de convite. Confira as vagas e a validade exibidas. Os convidados abrem o Orkas pelo link e confirmam a entrada com a conta desejada.

Metas e regras, memória, arquivos, pendências e seus anexos são compartilhados. Tarefas e automações permanecem privadas. Agents personalizados exigem Compartilhar; Agents CLI continuam privados. Cadeados indicam conteúdo privado em Projetos compartilhados. Membros podem editar qualquer pendência; o avanço automático processa apenas as próprias. Em A fazer, use Todos / Minhas à direita da barra do quadro para filtrar o trabalho compartilhado; os itens pessoais continuam visíveis. Por projeto exibe o controle no projeto compartilhado selecionado; Por status, quando há qualquer projeto compartilhado.

O conteúdo é salvo localmente antes da publicação em segundo plano; salvar não confirma a entrega aos membros. A sincronização pessoal é separada. Use Atualizar no canto superior direito para buscar alterações e reenviar mudanças pendentes. Revise os conflitos do Projeto antes de escolher uma cópia. Os links de convite não esperam os uploads. Eles podem continuar após uma interrupção ou reinicialização; pause a sincronização ou tente novamente na área de membros. O conteúdo está sendo sincronizado. Você pode trabalhar com Agents locais.

Sair ou ser removido mantém uma cópia pessoal, remove Agents de outros membros e pendências não atribuídas a você, e pausa as automações. Entrar novamente cria outro Projeto compartilhado. Encerrar compartilhamento interrompe a colaboração de todos e remove os dados compartilhados na nuvem; cópias baixadas permanecem.

# 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.

Condições de execução: A automação usa o horário local do dispositivo atribuído. A data final inclui o dia local; o limite conta execuções agendadas, não “Executar agora”. O dispositivo e os acessos necessários devem estar disponíveis. Desativar interrompe execuções futuras sem apagar resultados anteriores.

# 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 agente” 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 agente de código” na página “Equipe de IA”.
  • 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.
  • Durante uma tarefa, Claude Code, Codex, OpenCode, Hermes e OpenClaw podem usar apenas o navegador integrado dessa conversa. Você pode mudar para outras páginas do Orkas enquanto o agente continua trabalhando no navegador da tarefa. Outras conversas e navegadores externos ficam fora desse acesso. Em Detalhes da tarefa > Navegador, interaja diretamente com a página. A IA aguarda enquanto você interage e pode continuar após 10 segundos sem atividade, quando teclas pressionadas, arrastos e composição de texto terminarem. O agente pode ler valores comuns de formulários, preencher e enviar campos incluindo senhas, códigos e dados de cartão, e carregar arquivos da pasta de trabalho ou dos anexos da tarefa. Valores sensíveis não são retornados ao modelo. Downloads da tarefa não exigem autorização adicional por site. Conclua CAPTCHA e outras verificações solicitadas pelo site; a retomada automática do controle não reinicia uma tarefa encerrada. Uploads e downloads não têm limite adicional de quantidade ou tamanho no navegador; os limites do site continuam válidos. Após terminar, escolha Devolver controle à IA para retomar imediatamente. Autorize permissões ou escolha a tela quando solicitado. Redefinir permissões do site na barra do navegador limpa as escolhas sem recarregar o formulário. A IA envia arquivos pelo caminho e salva downloads comuns nos anexos da tarefa, sem abrir um seletor. Anexe arquivos externos à conversa. Seletores nativos do sistema de arquivos são cancelados durante o controle pela IA; opere o site manualmente se não houver upload ou download comum. A IA pode permitir ou negar que a tela permaneça ligada nesta solicitação. Outras permissões do site ainda exigem sua decisão.

Se o CLI estiver abaixo da versão mínima, atualize-o no painel de conexão, nos detalhes do agente ou no botão com o nome do CLI no rodapé do balão de erro. O progresso aparece no botão e o resultado ao lado. Tente a tarefa novamente após o sucesso. Versões compatíveis se adaptam automaticamente; altere modelos selecionados indisponíveis nas configurações de execução.

Para um agente executado pelo Orkas, peça ao Commander ou na conversa de edição do agente para salvar as habilidades disponíveis que ele deve usar por padrão. Após a edição ser concluída, a lista permanece entre tarefas e reinicializações. As habilidades são lidas e usadas quando necessário: não são executadas automaticamente, não carregam todas as instruções de uma vez e não impedem a descoberta de outras habilidades compartilhadas elegíveis. Selecionar uma habilidade em uma tarefa não altera a lista salva. Agentes CLI externos usam sua própria configuração de habilidades.

Para tarefas apenas de áudio, selecione VoiceStudio em AI Team e forneça um roteiro ou gravação. Peça narração, transcrição, cortes ou mixagem com música fornecida. A narração envia o roteiro ao serviço de síntese de voz configurado; a transcrição e a edição usam componentes incluídos, sem downloads no primeiro uso. Mantenha o projeto e os áudios juntos para revisar trechos ou a mixagem. Repare ou atualize o Orkas se faltar um componente necessário.

# 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 habilidade” 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.
  • Para pausar uma habilidade, abra o menu ⋯ do cartão em Habilidades e escolha Desativar; use Excluir para remover uma que você criou e desinstale as habilidades do Marketplace no próprio Marketplace.
ZIP de habilidade local: Anexe-o a uma nova tarefa e peça explicitamente ao Orkas para importar a habilidade. O ZIP não é um documento comum legível pelo modelo. Para várias habilidades, revise a lista e escolha as necessárias; solicite todas explicitamente. A importação ocorre em lotes, com falhas separadas. Instalar não verifica a execução nem migra outros componentes dos plugins.

# 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” ou peça ao Commander para conectar ou reconectar um serviço na tarefa atual. A autorização simples só exige abrir a entrada de conexão e dar seu consentimento. Para configurações adicionais, o Commander usa o guia e a assistência no navegador. “Pedir ajuda ao Commander” no painel inicia uma tarefa separada. Os valores protegidos não são enviados. Confirme o estado conectado ao terminar. Para Feishu/Lark, DingTalk, WeCom ou Xero já conectado, abra o menu de três pontos do cartão e escolha “Autorizar novamente” quando necessário. A conexão e os recursos selecionados são mantidos; depois, volte à tarefa.
  • Não conectado não significa incompatível: confira primeiro o catálogo disponível. 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. Expanda Ver detalhes para conferir a operação e os parâmetros. Permitir uma vez aprova apenas a operação atual; Permitir nesta tarefa aprova todas as próximas operações desta conta do conector, inclusive exclusões, até a tarefa terminar ou parar. Reconectar revoga essa aprovação, sem alterar as permissões globais.

Acesso: Use campos protegidos de autorização, não uma tarefa comum, para credenciais. Desconectar interrompe o acesso futuro, mas não apaga conteúdo do serviço externo.

# 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

  1. Abra “Biblioteca”, adicione fontes compatíveis, use nomes reconhecíveis e aguarde o processamento terminar.
  2. No Commander ou em uma tarefa de projeto, selecione apenas as fontes relevantes para a pergunta atual.
  3. 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.
Escolha a entrada certa: Use anexo de tarefa para um arquivo necessário uma única vez. Adicionar uma fonte à biblioteca não faz todas as tarefas usá-la automaticamente. Anexos de tarefa, biblioteca e biblioteca do projeto aceitam Excel antigo (.xls) para leitura e prévia do conteúdo.

# Aplicativos

Aplicativos transforma resultados interativos compatíveis em ferramentas reutilizáveis que você abre sem localizar e reabrir a conversa original.

O que oferece

  • Aplicativos > Criar: descreva a ideia, crie, revise e salve.
  • Abra e use diretamente um app salvo depois que a tarefa de origem terminar.
  • Em Aplicativos, escolha Editar para revisar em uma nova tarefa. Atualizar aplicativo original mantém sua identidade; Salvar novo aplicativo cria uma cópia independente. Atualizar substitui o código e mantém dados compatíveis. Se o original foi excluído, salva um novo aplicativo. Após salvar uma cópia, as próximas atualizações desse resultado usam a cópia.

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.
  • Em Aplicativos, escolha Editar para revisar em uma nova tarefa. Atualizar aplicativo original mantém sua identidade; Salvar novo aplicativo cria uma cópia independente. Atualizar substitui o código e mantém dados compatíveis. Se o original foi excluído, salva um novo aplicativo. Após salvar uma cópia, as próximas atualizações desse resultado usam a cópia.

Comece aqui

Em Aplicativos, escolha Editar para revisar em uma nova tarefa. Atualizar aplicativo original mantém sua identidade; Salvar novo aplicativo cria uma cópia independente. Atualizar substitui o código e mantém dados compatíveis. Se o original foi excluído, salva um novo aplicativo. Após salvar uma cópia, as próximas atualizações desse resultado usam a cópia.

Estes recursos do host estão disponíveis apenas para aplicativos locais: Apps criados para Orkas podem usar o modelo configurado, arquivos selecionados, armazenamento do app, Library global e conectores ativos quando solicitados e permitidos. Chamadas de modelo podem gerar custos, mas não exigem consentimento separado do app. Ações sensíveis de conectores seguem o modo de permissão; Confiável não pede confirmação. Permitir durante este uso vale para essa conta do conector e tipo de operação até fechar o app. Ao reabrir, a confirmação será solicitada quando necessária. A exportação cria um novo arquivo. Cada app tem um espaço privado para dados e arquivos. Apps com armazenamento em nuvem podem sincronizá-lo quando a mesma conta ativa a sincronização em cada dispositivo; caches ficam locais. Salvar não significa que o envio terminou. Dados de apps antigos não migram automaticamente, e cópias salvas continuam independentes. Feche e reabra após mudar de conta ou configurar modelos. Apps antigos e HTML exportado isoladamente não recebem essas funções automaticamente.

Publique pelo menu de Aplicativos; a página mostra sua disponibilidade de publicação. Recursos exclusivos do desktop bloqueiam a publicação. Escolha adaptar para publicação na web para abrir uma tarefa de edição; revise e envie o pedido preenchido. O menu de apps publicados oferece Atualizar publicação quando o código está neste dispositivo, e Retirar publicação. Excluir fica oculto até a retirada da publicação terminar, inclusive em apps suspensos. Retirar publicação exclui permanentemente os dados online; o código e os dados locais permanecem. Arquivos publicados e dados online compartilham o armazenamento da conta com a sincronização e a colaboração em projetos. Os detalhes da publicação mostram o uso dos arquivos, do banco de dados e o total. Excluir registros só libera espaço após a recuperação do armazenamento.

Apps podem carregar scripts e recursos externos e chamar serviços externos diretamente. Esses serviços recebem os dados enviados pelo app; chamadas diretas não usam os diálogos de permissão dos conectores. Scripts externos têm as capacidades do app. A autenticação do serviço e as regras de origem do navegador continuam valendo.

# 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.

Quando a adesão expira, a sincronização para. Em Configurações da conta > Dados, consulta a data de eliminação e escolhe “Renovar e retomar”. Os dados locais ficam guardados. Se os dados na nuvem foram eliminados, volta a ativar a sincronização após renovar.

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.
Dados na nuvem: Para remover dados da nuvem, use a ação específica em “Configurações da conta” > “Dados” e leia a confirmação, pois a mudança pode afetar todos os dispositivos sincronizados.

Limpar tarefas antigas

Em Configurações da conta > Dados, abra a limpeza do histórico e escolha 7, 14, 30, 60, 90 ou 180 dias (padrão: 30). Abra a lista, selecione projetos ou tarefas e confirme na mesma página. Nada é selecionado inicialmente. Ao confirmar a limpeza, as tarefas em execução ou na fila são interrompidas automaticamente. Você pode abrir a conversa de uma tarefa nesta lista e voltar para continuar a limpeza.

Filtre todo o histórico por tempo e limpe por projeto ou tarefa.

O histórico, os anexos e os resultados incorporados vão para a lixeira local e podem ser restaurados. Com a sincronização ativada, as tarefas também são excluídas dos outros dispositivos. O espaço só é liberado ao esvaziar a lixeira. Tarefas fixadas, não lidas, com rascunhos e execuções de automações também podem ser selecionadas. Rascunhos não enviados são excluídos; as configurações das automações são mantidas.

# 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.