Forneça ao Bob contexto de projeto persistente em conversas e modos com /init, que gera automaticamente arquivos AGENTS.md.

O comando /init escaneia um projeto e gera um arquivo de resumo estruturado chamado AGENTS.md que o Bob usa como contexto persistente em cada conversa. O comando /init é como você fornece ao Bob conhecimento sobre a estrutura, convenções e base de código de um projeto, sem exigir que o Bob releia todos os arquivos no início de cada interação.

Grandes modelos de linguagem são sem estado. Cada nova conversa começa sem memória de interações anteriores. Sem contexto de projeto explícito, o Bob deve descobrir a base de código a cada nova interação, o que é ineficiente e se torna impraticável em escala.

Neste tutorial, você inicializa o Bob no diretório raiz de uma aplicação de demonstração, explora o contexto que o Bob obtém sobre a aplicação e aprende sobre a estrutura do Bob para contexto específico de modo.

Pré-requisitos

Para concluir este tutorial, você precisa do seguinte:

Se você ainda não o tem, clone o código de demonstração Galaxium Travels. O comando de clonagem também faz checkout do branch bob-learning-path-branch que contém o código que você usa nos tutoriais.

git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels

Bob IDE com o código de demonstração Galaxium Travels aberto

Embora não seja obrigatório, considere fazer o tutorial de início rápido para se familiarizar com a interface e recursos do Bob.

Executar /init

Para inicializar o contexto do projeto, navegue até a interface de chat Olá, sou o Bob no Bob IDE. Mude para o modo Agent na parte inferior da barra lateral.

Mudar para o modo Agent

Digite o comando /init na interface de chat. Se você tiver a aprovação automática desabilitada, o Bob solicita sua permissão para ler arquivos e escrever os arquivos AGENTS.md.

 /init

Executando o comando /init no Bob IDE

O Bob lê os arquivos relevantes no projeto. O Bob então gera o arquivo principal AGENTS.md no diretório raiz do Galaxium Travels. O Bob também cria uma pasta .bob que contém um AGENTS.md para cada modo.

Explorar arquivos AGENTS.md

Os arquivos AGENTS.md funcionam como documentação de integração para o Bob. AGENTS.md é um resumo conciso e acionável que fornece tudo o que o Bob precisa para entender a estrutura e convenções do projeto.

Você pode localizar o arquivo principal AGENTS.md na parte inferior do explorador de arquivos do Bob no lado esquerdo. Abra o arquivo para ler seu conteúdo.

O arquivo AGENTS.md no explorador de arquivos do Bob

O arquivo AGENTS.md normalmente contém os seguintes componentes:

Visão geral e propósito do projeto

Estrutura de diretórios e localizações de arquivos-chave

Pilha de tecnologia e dependências

Padrões arquiteturais e convenções

Fluxos de trabalho de desenvolvimento

O Bob aplica automaticamente o AGENTS.md a novas conversas e aprende o contexto do projeto.

Arquivos AGENTS.md específicos de modo

Além do AGENTS.md principal no diretório raiz do Galaxium Travels, /init gera arquivos de contexto específicos de modo na pasta .bob para cada modo integrado. Cada AGENTS.md específico de modo estende o AGENTS.md principal com contexto relevante para o propósito desse modo. A tabela a seguir lista os arquivos AGENTS.md específicos de modo:

Arquivo	Modo
`.bob/rules-code/AGENTS-code.md`	Modo Agent
`.bob/rules-plan/AGENTS-plan.md`	Modo Plan
`.bob/rules-ask/AGENTS-ask.md`	Modo Ask

O contexto do modo Plan enfatiza convenções arquiteturais, enquanto o contexto do modo Code destaca a estrutura de arquivos e padrões de nomenclatura.

Manter os arquivos AGENTS.md

Execute novamente /init após fazer os seguintes ajustes no projeto:

Adicionar novos módulos ou serviços

Alterar a estrutura de diretórios

Adotar novas tecnologias ou frameworks

Integrar novos membros da equipe que usarão o Bob

Você também pode editar manualmente o AGENTS.md para adicionar contexto que a varredura automatizada do Bob pode não capturar, como regras de negócio, convenções de implantação ou práticas específicas da equipe.

Próximos passos

Neste tutorial, você aprendeu o seguinte:

Grandes modelos de linguagem são sem estado. Executar o comando /init resolve esse problema gerando AGENTS.md, que é um arquivo de contexto persistente que o Bob lê no início de cada conversa.

Os arquivos AGENTS.md específicos de modo fornecem contexto direcionado para os modos Agent, Plan e Ask.

Execute novamente /init após grandes mudanças no projeto para manter o contexto atualizado.

Iniciar um projeto com /init e AGENTS.md