# Projetos

> Um projeto mantém junto o trabalho de um cliente ou de uma campanha — e, quando você o anexa, ensina ao Endless tudo o que ele sabe sobre esse cliente.

Source: https://endless.app/pt/docs/concepts/projects

O produto descreve um **projeto*&#x2A; como &#x2A;"Um espaço para cada cliente ou campanha. Mantenha os
arquivos, transcrições e conversas juntos para que o Endless sempre tenha o contexto certo."*

Essa frase esconde justamente o que costuma confundir. Um projeto faz três trabalhos separados,
e **fazer um nunca faz os outros**. Depois que você sabe qual deles está pedindo, tudo em
projetos fica previsível.

## Três trabalhos, mantidos separados

<Cards>
  <Card icon="<Folder />" title="1. Ele guarda coisas">
    Ativos, chats, canvas, as pessoas com acesso e o conhecimento do projeto. É
    isso que preenche as abas do projeto.
  </Card>

  <Card icon="<Eye />" title="2. Ele concede acesso">
    Vincular algo a um projeto deixa qualquer pessoa que possa abrir o projeto
    ler esse conteúdo.
  </Card>

  <Card icon="<Notebook />" title="3. Ele fornece contexto">
    **Anexar** um projeto a um chat carrega o conhecimento e as skills dele
    naquela conversa.
  </Card>
</Cards>

Só o primeiro trabalho aparece na lista: cada projeto mostra o seu alcance ao lado dos ativos,
chats e canvas que estão nele e das pessoas com acesso.

<ImageZoom src="/docs/screenshots/projects.webp" alt="A lista de projetos, uma linha por projeto: cada uma mostra se ele é privado ou compartilhado com o espaço de trabalho, e depois os ativos, chats e canvas que estão nele e as pessoas com acesso" width="1280" height="720" />

<Callout type="warn">
  **Um nunca implica o outro.** Adicionar um ativo a um projeto o torna legível
  por qualquer pessoa que possa abrir o projeto — e não carrega nada em nenhum
  chat. Mencionar um projeto em um chat carrega o conhecimento dele — e não
  adiciona esse chat ao projeto. Se você quer os dois, faça os dois.
</Callout>

## Quem pode abrir um projeto

Você escolhe para quem ele é ao criá-lo, em &#x2A;*"Acesso geral"**:

<Cards>
  <Card icon="<Lock />" title="Privado">
    *"Só você e as pessoas que adicionar"*. Todo projeto novo começa assim.
  </Card>

  <Card icon="<Globe />" title="Espaço de trabalho">
    **"Todos no espaço de trabalho"** podem abri-lo, com **Pode ver** ou **Pode
    editar**. Começa em **Pode ver**.
  </Card>
</Cards>

De um jeito ou de outro, &#x2A;*"Adicionar pessoa"** compartilha o projeto diretamente com alguém.
Cada pessoa começa em **Pode ver** e você pode subi-la para **Pode editar**. O papel próprio de
uma pessoa vale mais que o do espaço de trabalho, mesmo quando é menor.

| Papel           | O que permite                                                                                                                  |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Pode ver**    | Abrir o projeto e ler tudo o que está nele, inclusive o conhecimento                                                           |
| **Pode editar** | Também renomeá-lo, editar o conhecimento, vincular e desvincular canvas e skills, e adicionar a ele os próprios chats e ativos |
| Proprietário    | Quem o criou: também decide quem tem acesso, arquiva e exclui o projeto                                                        |

Além do proprietário, qualquer pessoa cuja função no espaço de trabalho inclua &#x2A;*"Excluir
conteúdo criado por outras pessoas"** pode excluir um projeto que consiga abrir.

Para editar, o seu papel no espaço de trabalho também precisa permitir criar conteúdo. Só o
proprietário muda depois quem tem acesso, na aba **Acesso*&#x2A; do projeto; os demais veem quem tem
acesso e podem &#x2A;*"Sair"** de um projeto compartilhado com eles, a menos que sair lhes desse mais
acesso do que tinham (por exemplo, se têm **Pode ver** e o espaço de trabalho tem **Pode
editar**).

Vincular algo a um projeto exige duas coisas: que seja seu e que você possa editar o projeto. A
partir daí, qualquer pessoa que possa abrir o projeto pode vê-lo — na aba **Biblioteca** do
projeto e na própria biblioteca —, mas não editá-lo. Só quem criou um chat pode adicioná-lo a
um projeto, e então qualquer pessoa que possa abrir o projeto pode lê-lo.

<Cards>
  <Card icon="<Layers />" title="Ativos e visibilidade" href="/pt/docs/concepts/assets-and-visibility">
    O quadro completo de quem pode ver um arquivo, do qual os vínculos de
    projeto são um dos ramos.
  </Card>
</Cards>

## Anexar um projeto a um chat

Anexar é o trabalho de contexto — o que realmente muda o que o Endless sabe enquanto trabalha
com você.

<Steps>
  <Step>
    ### Anexe

    Digite &#x2A;*`@`** seguido do nome do projeto no compositor, ou escolha o projeto no menu de
    adicionar do compositor. Um chip com o projeto aparece acima do compositor.
  </Step>

  <Step>
    ### Confirme o que isso fez

    Abra o chip e ele diz: &#x2A;"O conhecimento e as skills deste projeto estão carregados neste
    chat."* O contexto nunca é silencioso — se um projeto está alimentando a conversa, você vê.
  </Step>

  <Step>
    ### Ele continua anexado

    Você não precisa mencionar o projeto de novo a cada mensagem. Uma vez anexado, ele fica anexado
    pelo resto daquela conversa, em qualquer dispositivo de onde você a abrir.
  </Step>

  <Step>
    ### Desanexe quando terminar

    Remova o chip — &#x2A;*"Remover do chat"** — e o conhecimento e as skills do projeto param de
    carregar, mesmo que o projeto tenha sido mencionado antes na conversa.

    **A remoção é lembrada só naquele dispositivo.** O anexo é deduzido da própria conversa, então
    acompanha você em todo lugar; a remoção é uma anotação local por cima disso. Abra o mesmo chat
    em outro computador ou no celular e o projeto volta anexado — remova o chip ali também.
  </Step>
</Steps>

<Callout type="info">
  O Endless pode anexar um projeto por conta própria no meio da conversa quando
  o trabalho é claramente sobre ele, e avisa quando faz isso. Se não era o que
  você queria, remova o chip.
</Callout>

## Cada projeto tem uma entrada de conhecimento

Todo projeto tem uma única entrada de **Conhecimento**, permanente. O Endless a mantém
atualizada, ela fica fora da lista geral de skills e é carregada em um chat quando você
menciona o projeto.

Essa é a memória do projeto. Quando você conta ao Endless algo duradouro sobre o cliente — como
o nome dele se escreve, o tom dos posts dele, o que sempre precisa de aprovação — ele salva essa
regra no conhecimento do projeto e mostra um card &#x2A;*"Salvo em"** com o nome do projeto, para
você saber que aconteceu. Na próxima vez que anexar o projeto, ele começa dali em vez do zero.

<Cards>
  <Card icon="<Notebook />" title="É do projeto, para sempre">
    A entrada de conhecimento não pode ser desvinculada do projeto nem excluída
    enquanto o projeto existir. Ela vai embora quando o projeto vai.
  </Card>

  <Card icon="<Tag />" title="Só carrega quando anexado">
    O conhecimento é embutido em uma conversa quando o projeto está anexado a
    ela — nunca em todo chat por padrão.
  </Card>
</Cards>

Você pode ler esse conteúdo na aba **Conhecimento** do projeto, e editá-lo ali se puder editar
o projeto. Por baixo é uma
skill comum, então valem as mesmas ideias — veja [Skills e
conhecimento](/pt/docs/concepts/skills-and-knowledge).

## Arquivar um projeto

Só o proprietário do projeto pode arquivá-lo. Arquivar esconde o projeto de todos, menos do
proprietário, sem excluir nada, e o que está vinculado a ele deixa de ser compartilhado por meio
do projeto enquanto ele estiver arquivado. Os arquivados ficam em
**Configurações → Arquivados*&#x2A;: &#x2A;"Projetos arquivados ficam ocultos no seu espaço de
trabalho. Desarquive um para trazê-lo de volta."*

<Cards>
  <Card icon="<Refresh />" title="Dá para reverter">
    Desarquivar — também decisão do proprietário — restaura o projeto exatamente
    como ele estava, mantendo os vínculos e o acesso. É um jeito de organizar
    uma campanha encerrada, não de excluí-la.
  </Card>

  <Card icon="<FolderOpen />" title="Diferente de excluir">
    Excluir um projeto é uma ação separada e destrutiva: ele não vai para a
    Lixeira e não dá para desfazer pelo app. Arquivar não mexe em nada dentro do
    projeto.
  </Card>
</Cards>

<Callout type="info">
  O **plano Free** é o único que limita quantos projetos um espaço de trabalho
  pode ter; todos os planos pagos são ilimitados. Se você bater no limite, o
  Endless avisa quando você tentar criar o próximo — e arquivar não libera vaga,
  porque projetos arquivados continuam contando. Excluir um libera.
</Callout>

## Qual deles eu quero?

| Eu quero…                                           | Faça isto                                              |
| --------------------------------------------------- | ------------------------------------------------------ |
| Manter os arquivos de um cliente juntos             | Vincule os ativos ao projeto                           |
| Deixar um colega alcançar os arquivos de um cliente | Compartilhe o projeto com essa pessoa (aba **Acesso**) |
| Fazer o Endless escrever na voz do cliente          | Anexe o projeto ao chat (`@` seguido do nome dele)     |
| Ensinar ao Endless uma regra que deve valer sempre  | Diga isso em um chat com o projeto anexado             |
| Impedir que um projeto influencie a conversa atual  | Remova o chip dele                                     |
| Tirar da frente uma campanha encerrada              | Arquive o projeto                                      |

<Cards>
  <Card icon="<Users />" title="Espaços de trabalho e membros" href="/pt/docs/concepts/workspaces-and-members">
    Os projetos vivem dentro de um espaço de trabalho, e as pessoas que estão
    nele são com quem você pode compartilhar os projetos.
  </Card>

  <Card icon="<Notebook />" title="Skills e conhecimento" href="/pt/docs/concepts/skills-and-knowledge">
    O que é uma skill e como o conhecimento de um projeto se relaciona com o
    resto delas.
  </Card>
</Cards>
