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

# Devin Apps

> Devin Apps são web apps que o Devin cria e executa na própria máquina, em uma URL estável. Saiba como criar, compartilhar, fixar, atualizar e pagar por eles.

Um Devin App é um web app que o Devin cria para você e mantém em execução na própria máquina. Pode ser uma ferramenta interna, um painel, um formulário, um tracker ou uma demo. Cada App tem uma URL estável que você pode compartilhar com sua equipe.

Os Apps são executados da mesma forma que as [prévias do Browser](https://docs.devinenterprise.com/pt-BR/work-with-devin/browser-previews.md). Uma prévia serve para visualizar o trabalho em andamento em uma sessão e atende à maioria dos casos. Já um App é para algo que sua equipe continua usando depois que o trabalho da sessão termina.

> [!NOTE]
>
> Os Devin Apps estão sendo liberados gradualmente. Se **Apps** não aparece na sua barra lateral, o recurso ainda não foi ativado para você.

## Como os Devin Apps funcionam

* **O App é executado na máquina do Devin.** O Devin faz o build do App em uma sessão e o executa a partir da máquina dessa sessão. Nada é implantado em um host de terceiros.
* **Qualquer stack funciona.** O Devin pode usar o framework e a linguagem mais adequados à tarefa, desde que o resultado sirva HTTP em uma porta.
* **Seus dados ficam na máquina.** O App pode usar o banco de dados que você preferir, como SQLite ou Postgres, rodando na mesma máquina. Arquivos e uploads também ficam armazenados lá.
* **A URL é estável.** A URL de um App tem o formato `https://<name>--<id>.preview.devinapps.com`. Ela permanece a mesma em todas as atualizações, e renomear o App não a altera. O Devin conhece a URL e a envia para você quando o App estiver no ar.
* **Os Apps são privados.** Todos que abrem um App precisam fazer login no Devin. Você escolhe quem tem acesso. Os Apps nunca são públicos.
* **Uma sessão gerencia o App.** A sessão que faz o build do App também publica as alterações posteriores. Para alterar um App, envie uma mensagem para a sessão correspondente.

## Casos de uso

* **Versões beta e de homologação do seu produto.** O Devin pode executar a stack real da sua empresa na máquina dele: seu frontend, seu backend, seu banco de dados e quaisquer workers. Por isso, um Devin App é um ótimo lugar para hospedar uma cópia beta ou de homologação do seu app, que os colegas de equipe podem abrir por um link, sem precisar configurar uma hospedagem separada.
* **Ferramentas internas.** Painéis de administração, formulários de requisição, filas de aprovação e pequenas ferramentas que substituem uma planilha compartilhada.
* **Dashboards.** Métricas, integridade do plantão, filas de suporte ou números de vendas, extraídos das suas próprias fontes de dados e atualizados periodicamente conforme um agendamento.
* **Acompanhamento de rollouts.** Uma página que mostra o andamento de uma migração, de um lançamento ou do rollout de uma feature flag, e o que ainda falta.
* **Demos e protótipos.** Uma versão funcional de uma ideia que as pessoas podem explorar antes de você desenvolver a versão definitiva.

## Criar um App

1. Abra [**Apps**](https://app.devin.ai/apps) na barra lateral.
2. Descreva o que o App deve fazer. Você também pode começar a partir de um template de prompt.
3. Envie o prompt.

Você será direcionado para uma nova sessão do Devin. Se tiver alguma dúvida, o Devin pergunta já na primeira mensagem; depois, cria o App e o coloca no ar. O App aparece imediatamente em **Apps** com a respectiva URL, e o status fica como **Building** até a primeira versão entrar no ar.

Você também pode pedir um App em qualquer sessão, por exemplo: "crie isto como um Devin App". Se o Devin já tiver mostrado uma prévia do Browser, você pode pedir que ele publique essa prévia como um App.

## Suspensão, retomada e faturamento

A máquina do Devin entra em suspensão quando ninguém a está usando. Quando alguém abre o App, a máquina é reativada e exibe a página. O primeiro carregamento após uma suspensão pode levar alguns segundos. A máquina volta a entrar em suspensão 5 minutos após a última requisição.

O faturamento de um App é baseado no tempo em que a máquina permanece ativa. Um App que ninguém acessa não consome nada enquanto a máquina está em suspensão. Criar e alterar o App é um trabalho comum de sessão e é faturado como qualquer outra sessão. Consulte [Uso](https://docs.devinenterprise.com/pt-BR/admin/billing/usage.md).

## Compartilhar um App

Clique em **Share** em um App para copiar o link dele ou alterar quem pode abri-lo. **General access** tem três níveis:

| Nível | Quem pode abrir o App |
| - | - |
| **Only people with access** | O criador, os administradores da organização e as pessoas que você adicionar |
| **Organização** | Todos na sua organização e qualquer pessoa que você adicionar |
| **Enterprise** | Membros de todas as organizações da sua empresa |

Você também pode adicionar pessoas, grupos ou organizações específicos e escolher o que cada um pode fazer: abrir o App, editar as configurações dele ou compartilhá-lo com outras pessoas.

Os administradores da organização podem definir o nível de compartilhamento padrão de todos os Apps da organização em **Sharing defaults**.

## Encontrar e fixar Apps

A página Apps lista os Apps que você pode abrir e oferece pesquisa, categorias e filtros. Você pode fixar os que mais usa. Há dois tipos de fixação:

* **Pin for me** mantém um App no topo da sua página inicial de Apps.
* **Pin for everyone** coloca um App no topo da página inicial de Apps de toda a organização. Somente administradores da organização podem fazer isso.

Se você gostou de um App de outra pessoa, use **Use as a starting point** para criar um novo App com base nele.

## Como atualizar um App

Abra o App, clique em **Edit in session** e diga ao Devin o que mudar. O Devin faz a alteração, gera o build de uma nova versão e a coloca no ar. A URL continua a mesma.

Cada atualização gera uma nova versão. A página do App lista todas elas em **Deployments**, com o status, uma descrição e o commit de cada uma. Se uma nova versão não conseguir iniciar, a versão anterior continua no ar. Para voltar a uma versão mais antiga, peça à sessão que implante essa versão novamente.

A página do App também mostra as visualizações de página das últimas 24 horas, 7 dias ou 30 dias.

O criador do App e os administradores da organização podem abrir as configurações dele para renomeá-lo, editar a descrição, definir uma foto de capa, tirá-lo do ar ou excluí-lo. Tirar um App do ar preserva o histórico dele. Ao excluí-lo, a URL deixa de funcionar. Nenhuma das duas ações afeta a sessão.

## Como o Devin cria Apps

O Devin segue um conjunto de instruções nativas ao criar um App. Estes são os pontos que vale a pena conhecer:

* **Ele executa um build de produção.** O Devin desenvolve com um servidor de desenvolvimento e confere o trabalho em uma prévia do Browser. Quando o App está funcionando, ele gera o build e executa o build de produção, e não o servidor de desenvolvimento.
* **Ele mantém o código no git.** O Devin faz commit antes de cada implantação, para que cada versão corresponda a um commit. Se o App estiver em um dos seus repositórios, o Devin faz push dos commits ou abre um PR.
* **Ele mantém os dados fora da pasta de build.** Arquivos de banco de dados e arquivos importados ficam fora da pasta que é recriada, para que uma atualização ou um rollback não os apague.
* **Ele usa a sua marca.** A menos que você peça um visual específico, o Devin procura o design system da sua empresa nos seus repositórios e usa as cores, fontes e componentes dele. Ele informa de onde veio a identidade visual. Se não encontrar nenhum design system, usa um estilo padrão simples.
* **Ele faz perguntas logo de início.** É comum as pessoas saírem depois de enviar um pedido, então o Devin pergunta tudo o que precisa já na primeira resposta.
* **Ele não deixa uma versão quebrada.** Se uma implantação falhar, o Devin lê o erro, corrige o problema e implanta novamente.
* **Ele cria uma miniatura.** Após uma implantação, o Devin tira uma captura de tela do App para usar no cartão dele na página Apps.

Você pode substituir qualquer um desses comportamentos no seu prompt. Por exemplo, você pode especificar a stack, o banco de dados ou o visual que deseja.

## Como manter um App atualizado com automações

Um App não precisa esperar que você peça alterações. Uma [automação](https://docs.devinenterprise.com/pt-BR/product-guides/automations.md) pode acionar o Devin para que ele atualize o App por você. Duas configurações comuns:

* **Por agendamento.** O Devin é acionado a cada hora, todo dia ou toda semana, busca dados atualizados e atualiza o App. Isso funciona bem para dashboards e relatórios.
* **A cada push.** Se o App acompanha uma branch em um dos seus repositórios, o Devin o reimplanta sempre que a branch é alterada.

Peça à sessão do App para configurar isso. O Devin cria a automação e você só precisa aprová-la uma vez. Você também pode criá-la por conta própria na página Automações e configurá-la para enviar mensagens à sessão do App.

> [!WARNING]
>
> Cada execução de automação é uma sessão do Devin e é faturada como tal. Um App atualizado a cada poucos minutos pode custar muito mais do que o próprio App. Para manter o custo baixo:
>
> * Execute a automação com menos frequência. A maioria dos dashboards não precisa ser atualizada com intervalos menores do que de hora em hora ou diariamente.
> * Escolha um modelo de baixo custo para as sessões da automação.
> * Mantenha o trabalho enxuto. Peça ao Devin para escrever um script que busque apenas os dados novos e para executar esse script a cada atualização, para que ele não precise resolver o problema do zero todas as vezes.
> * Defina um limite de gastos por sessão na automação. Consulte [Limites e salvaguardas](https://docs.devinenterprise.com/pt-BR/product-guides/automations.md#limits-and-safeguards).

## Segredos e outros serviços

Um App pode ler e gravar dados em outros serviços. O Devin configura isso da mesma forma que em qualquer sessão.

* **Chaves de API para outros serviços.** Adicione a chave como um [segredo](https://docs.devinenterprise.com/pt-BR/product-guides/secrets.md) e informe ao Devin a qual serviço ela se destina. O Devin fornece a chave ao servidor do App, e o App chama o serviço a partir dele. Mantenha as chaves no lado do servidor do App. Tudo o que é enviado ao navegador fica visível para qualquer pessoa que possa abrir o App.
* **A API do Devin.** Um App pode chamar a [API do Devin](https://docs.devinenterprise.com/pt-BR/api-reference/overview.md) com um [token de acesso pessoal](https://docs.devinenterprise.com/pt-BR/api-reference/personal-access-tokens.md) ou uma chave de usuário de serviço. Assim, você pode criar suas próprias ferramentas com base no Devin, como uma página que inicia sessões a partir de um formulário ou um painel com as sessões da sua equipe. Um token de acesso pessoal age em seu nome, então todos que usam o App agem com as suas permissões. Compartilhe um App como esse com cautela.
* **Login.** Todos que abrem um App já fizeram login no Devin, então a maioria dos Apps não precisa de login próprio.

Os segredos ficam na máquina do Devin junto com o restante do App. Eles não fazem parte das configurações de compartilhamento do App, e quem pode abrir o App não consegue lê-los, a menos que o App os exiba.

## Quando um App está offline

Um App depende da sua sessão. Tenha em mente o seguinte:

* **Arquivar ou encerrar a sessão deixa o App offline.** O Devin avisa você antes de arquivar uma sessão que executa um App. Desarquive ou retome a sessão para colocar o App no ar novamente.
* **Nada reinicia automaticamente um servidor que travou.** Se o servidor do App parar, a URL exibirá uma página de erro até que o Devin o inicie novamente. Abra a sessão do App e peça ao Devin para implantá-lo de novo.
* **Um App sem versão ativa exibe uma página offline.** É isso que você vê antes da conclusão da primeira implantação ou depois que alguém deixa o App offline.

Em todos os casos, a solução é abrir a sessão do App na página Apps e pedir ao Devin para implantá-lo.

## Limites

* Os apps não podem ser públicos. Os visitantes sempre precisam fazer login no Devin.
* Os apps não podem registrar o próprio service worker, por isso o modo offline para PWAs não está disponível.
* O App é executado em uma única máquina. Ele é indicado para ferramentas internas e dashboards, não para serviços de produção com alto tráfego. Nesses casos, implante na sua própria infraestrutura usando seu pipeline de CI/CD atual e dê acesso ao Devin por meio de [Segredos](https://docs.devinenterprise.com/pt-BR/product-guides/secrets.md) e [Habilidades](https://docs.devinenterprise.com/pt-BR/product-guides/skills.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.