Seu projeto
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 é criada a partir dele. Cada
change request é 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.
Um projeto não é sua base de código
Um projeto contém as instruções do seu agente, seus connectors, seus 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.
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 para ver o caminho de migração.
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. |