---
title: "Seu projeto"
description: "Um projeto é um repositório Git que contém a configuração e o estado do seu agente."
---

Um projeto é um único repositório git. Ele contém um manifesto, a configuração do agente e o estado que ele produz. Não existe um banco de dados separado para manter em sincronia.

O Beeuni mantém um projeto de duas formas:

- **Repositório gerenciado pelo Beeuni** — o Beeuni cria e hospeda um repositório privado. Padrão.
- **Repositório do GitHub importado** — conecte um repositório existente. O Beeuni opera nele pela API do GitHub.

De qualquer forma, o projeto tem um `default_branch`. Cada
[session](/docs/pt/work/sessions) é criada a partir dele. Cada
[change request](/docs/pt/work/change-requests) é mesclada nele. Cada branch de um
repositório do GitHub pode se tornar seu próprio projeto. `main` e `dev` podem então ser executados como
projetos separados, cada um com suas próprias sessões e solicitações de alteração.

<a id="a-project-is-not-your-codebase"></a>

## Um projeto não é sua base de código

Um projeto contém as instruções do seu agente,
seus [connectors](/docs/pt/connect/connectors), seus [triggers](/docs/pt/connect/triggers),
e sua memória. Mantenha-o pequeno — o Beeuni o clona em cada sessão.

Seu código fica em outro lugar. Quando uma tarefa precisa de uma base de código, o agente clona
esse repositório, realiza o trabalho e abre uma solicitação de alteração para ele. Não
transforme uma base de código existente em um projeto adicionando um manifesto a ela.
Em vez disso, crie um projeto dedicado e aponte-o para os repositórios nos quais o
agente trabalha.

<a id="the-manifest"></a>

## O manifesto

Todo projeto tem um manifesto na raiz do repositório, `beeuni.yaml` por padrão. A
plataforma lê estas chaves de nível superior:

| Chave | Configura |
|---|---|
| `default_agent` | qual agente é executado por padrão |
| `agents` | permissões por agente: conectores, segredos, habilidades e permissões do Beeuni |
| `sandbox` | a imagem e o hardware do sandbox |
| `triggers` | automações agendadas e por webhook |
| `connectors` | quais ferramentas externas o projeto pode acessar |
| `env` | nomes de variáveis de ambiente esperados pelo projeto (os valores vêm dos segredos) |

Chaves desconhecidas são ignoradas.

Projetos mais antigos ainda podem executar `beeuni.toml` (`beeuni_version: 1`). O Beeuni
lê os dois formatos. Consulte [legacy TOML](/docs/pt/project/legacy-toml) para ver o caminho de migração.

<a id="deleting-a-project"></a>

## Excluir um projeto

Exclua um projeto com **Delete project** em **Danger zone**, nas configurações,
ou com `beeuni projects rm`. A partir desse momento, nada pode agir em nome
do projeto:

| Forma de acesso | Após a exclusão |
|---|---|
| Chaves do gateway LLM (`kgw_…`) | Acesso negado com `401`. |
| Links públicos de compartilhamento | Respondem `410`. |
| Aplicativos | Não são exibidos. |
| Novas sessões | Acesso negado: `404`, `code: "project_archived"`. |
| Slack e Teams | Respondem "Este espaço de trabalho do Beeuni foi excluído…" e não iniciam nada. |
| Caixas de entrada de e-mail | Respondem uma vez ao primeiro e-mail de uma conversa: "Este endereço não está aceitando e-mails no momento. Ninguém responderá a esta mensagem." A próxima resposta nessa conversa, dentro de 30 dias, não recebe nada; e e-mails que falham na autenticação do remetente nunca recebem resposta. |
| Sessões existentes | Não recebem novas mensagens: nem de uma conversa de chat, de um gatilho ou de um prompt na fila antes da exclusão. |

<a id="in-this-section"></a>

## Nesta seção

<CardGroup>
  <Card icon="file-text" title="Manifesto" href="/docs/pt/project/manifest">A referência completa de beeuni.yaml.</Card>
  <Card icon="bot" title="Agentes" href="/docs/pt/project/agents">Personas em Markdown com ferramentas de escopo limitado.</Card>
  <Card icon="brain" title="Modelos" href="/docs/pt/project/models">Qual modelo uma sessão usa e quem paga.</Card>
  <Card icon="key" title="Segredos" href="/docs/pt/project/secrets">Valores criptografados injetados em um sandbox.</Card>
  <Card icon="scroll-text" title="Legacy TOML" href="/docs/pt/project/legacy-toml">Migração de beeuni.toml.</Card>
</CardGroup>