Gerenciamento de contexto

Gerenciando o contexto

Os arquivos de contexto contêm informações que você deseja que a Amazon Q considere durante suas conversas. Isso pode incluir requisitos do projeto, padrões de codificação, regras de desenvolvimento ou qualquer outra informação que ajude a Amazon Q a fornecer respostas mais relevantes.

Há duas maneiras de configurar o contexto:

• Recursos do agente (recomendado): contexto persistente definido no arquivo de configuração do agente

• Contexto da sessão: contexto temporário adicionado durante uma sessão de bate-papo usando /context comandos

Configurando o contexto persistente com recursos do agente

A forma recomendada de configurar o contexto é por meio do resources campo no arquivo de configuração do agente. Isso cria um contexto persistente que está disponível sempre que você usa o agente.

Adicione caminhos de arquivo ou padrões globais à resources matriz na configuração do seu agente:

{
  "name": "my-agent",
  "description": "My development agent",
  "resources": [
    "file://README.md",
    "file://.amazonq/rules/**/*.md",
    "file://docs/**/*.md",
    "file://src/config.py"
  ]
}

Os recursos devem ser prefixados file:// para serem incluídos como arquivos de contexto. Esses arquivos estarão disponíveis automaticamente em todas as sessões de bate-papo usando esse agente.

Adicionando contexto de sessão temporária

Você pode adicionar arquivos temporariamente à sua sessão de bate-papo atual usando o /context add comando. Essas adições estão disponíveis somente para a sessão atual e não persistirão quando você iniciar uma nova sessão de bate-papo.

q chat
> /context add README.md
Added 1 path(s) to context.
Note: Context modifications via slash command is temporary.

Você também pode adicionar vários arquivos ao mesmo tempo usando padrões globais:

q chat
> /context add docs/*.md
Added 3 path(s) to context.
Note: Context modifications via slash command is temporary.

Para tornar as alterações de contexto permanentes, em vez disso, adicione os arquivos ao resources campo do seu agente.

Visualizando o contexto

Para visualizar seu contexto atual, use o /context show comando:

q chat
> /context show
👤 Agent (my-agent):
    README.md (1 match)
    .amazonq/rules/**/*.md (3 matches)
    docs/**/*.md (5 matches)

💬 Session (temporary):
    <none>

5 matched files in use:
👤 README.md (~250 tkns)
👤 .amazonq/rules/security.md (~180 tkns)
👤 .amazonq/rules/coding-standards.md (~320 tkns)
👤 docs/architecture.md (~150 tkns)
👤 docs/best-practices.md (~200 tkns)

Total: ~1100 tokens

A saída mostra:

• 👤 Agente: contexto persistente do resources campo do seu agente

• 💬 Sessão: contexto temporário adicionado durante a sessão atual

Removendo o contexto

Para remover arquivos do contexto da sessão atual, use o /context rm comando:

q chat
> /context rm src/temp-file.py
Removed 1 path(s) from context.
Note: Context modifications via slash command is temporary.

Para limpar todo o contexto da sessão, use o /context clear comando:

q chat
> /context clear
Cleared context
Note: Context modifications via slash command is temporary.

Observação: você não pode remover o contexto definido pelo agente usando /context comandos. Para remover permanentemente o contexto, edite o resources campo do seu agente.

Casos de uso comuns

Aqui estão alguns casos de uso comuns para gerenciamento de contexto:

Usando as regras do projeto

O Amazon Q oferece suporte a regras em nível de projeto que podem definir diretrizes e restrições de segurança. Essas regras são definidas nos arquivos Markdown no .amazonq/rules diretório do seu projeto.

Por exemplo, você pode criar regras que especifiquem:

• Quais diretórios a Amazon Q deve evitar acessar

• Requisitos de segurança para o código gerado

• Padrões de codificação e melhores práticas

A forma recomendada de incluir as regras do projeto é por meio da configuração do seu agente:

{
  "name": "my-project-agent",
  "resources": [
    "file://.amazonq/rules/**/*.md",
    "file://README.md",
    "file://docs/architecture.md"
  ]
}

Você também pode adicionar temporariamente as regras do projeto à sua sessão atual:

q chat
> /context add .amazonq/rules/*.md
Added 3 path(s) to context.
Note: Context modifications via slash command is temporary.

Para obter mais informações sobre como criar e usar regras de projeto, consulte Criação de regras de projeto para uso com o Amazon Q Developer chat na documentação do IDE.

Migração do contexto da sessão para os recursos do agente

Se você estiver adicionando repetidamente os mesmos arquivos de contexto usando /context add comandos, considere movê-los para o resources campo do seu agente para persistência:

1. Anote os arquivos que você adiciona com frequência /context add

2. Edite seu arquivo de configuração do agente

3. Adicione os caminhos do arquivo à resources matriz com o file:// prefixo

4. Salve a configuração do agente

Exemplo de migração:

# Instead of running these commands every session:
> /context add README.md
> /context add docs/*.md
> /context add .amazonq/rules/*.md

# Add them to your agent config once:
{
  "resources": [
    "file://README.md",
    "file://docs/**/*.md", 
    "file://.amazonq/rules/**/*.md"
  ]
}