Mapa da trilha
Conteúdo detalhado
📚 Cerebrum overview
Por que SDK separado, instalação, modos Local/Remote, arquitetura do paper NAACL 2025, componentes principais e agent hub para distribuição.
Cerebrum é a biblioteca cliente. Foi extraída do kernel para permitir que agente rode em máquina diferente.
Sem essa separação, agent hub e modo remote não funcionariam.
Client SDK · separação cliente/servidor · paper NAACL 2025.
Instalar AIOS já puxa Cerebrum automaticamente. Para dev, prefira clonar e pip install -e Cerebrum/.
Editable install pega mudanças sem reinstalar — vital quando você está construindo agentes.
Editable mode · dev workflow · versionamento.
Local: tudo numa máquina (dev). Remote: agente em A, kernel em B (prod/hub).
Definir cedo evita refactor: o código do agente é igual, muda só o config do client.
RPC · endpoint · auth · firewall.
"Cerebrum (AIOS SDK): A Platform for Agent Development, Deployment, Distribution, and Discovery" (arxiv 2503.11444). Define o "4D" do agente.
Os 4 D's (Develop, Deploy, Distribute, Discover) viram o vocabulário oficial.
Develop · Deploy · Distribute · Discover.
Agent base, LLMCall, MemoryRead/Write, StorageRead/Write, ToolCall, ContextSwitch. Os blocos que o agente usa.
Conhecer o vocabulário evita reinventar wrappers.
Base class · syscall wrappers · type-hints.
Registry público (e local) onde devs publicam agentes prontos e usuários baixam com 1 comando.
É a parte "Distribute + Discover" do paper Cerebrum. Reuso de agente sai do laboratório.
Registry · versioning · descoberta · permissões.
🛠️ Primeiro agente
Subclassear Agent, registrar tools, ler/escrever memory, submeter query, debug com logs e empacotar para publicar no agent hub.
Crie classe que herda de cerebrum.Agent e implemente run(query).
É o esqueleto. Todo agente AIOS começa assim.
Agent base · run method · ciclo de vida.
Use @tool(name, description) para expor função Python ao Tool Manager.
Tools registradas ficam disponíveis para todos os agentes; tools locais não.
Decorator · schema · permissões · sandbox.
Curto prazo na Memory (cache RAM por agente), longo prazo no Storage (disco).
Confundir gera bugs sutis: dados que somem entre restarts.
RAM vs disco · escopo · TTL · durabilidade.
Instancie agente, chame agent.run(query), leia resposta.
É o "executar". Sem esse ciclo, agente nunca produz output.
Run loop · query in · response out · streaming.
Ative log verbose no kernel. Cada syscall aparece com timestamp, módulo destino e payload.
Debug sem log é adivinhação.
Log verbose · trace · tracing distribuído.
Estruture pasta do agente (config, código, tools), faça push para o agent hub e qualquer usuário roda com 1 comando.
Publicar agente é o "git push" do AIOS — não é avançado, é trivial.
Manifest · semver · push · install.