Gestion du contexte

Gestion du contexte

Les fichiers contextuels contiennent des informations que vous souhaitez qu'Amazon Q prenne en compte lors de vos conversations. Il peut s'agir des exigences du projet, des normes de codage, des règles de développement ou de toute autre information permettant à Amazon Q de fournir des réponses plus pertinentes.

Il existe deux manières de configurer le contexte :

• Ressources de l'agent (recommandé) : contexte persistant défini dans le fichier de configuration de l'agent

• Contexte de session : contexte temporaire ajouté lors d'une session de chat à l'aide de /context commandes

Configuration d'un contexte persistant avec les ressources de l'agent

La méthode recommandée pour configurer le contexte consiste à utiliser le resources champ du fichier de configuration de votre agent. Cela crée un contexte persistant qui est disponible chaque fois que vous utilisez l'agent.

Ajoutez des chemins de fichiers ou des modèles globaux au resources tableau dans la configuration de votre agent :

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

Les ressources doivent être préfixées par un préfixe file:// pour être incluses en tant que fichiers de contexte. Ces fichiers seront automatiquement disponibles dans toutes les sessions de chat utilisant cet agent.

Ajouter un contexte de session temporaire

Vous pouvez ajouter temporairement des fichiers à votre session de chat en cours à l'aide de la /context add commande. Ces ajouts ne sont disponibles que pour la session en cours et ne seront pas conservés lorsque vous démarrerez une nouvelle session de discussion.

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

Vous pouvez également ajouter plusieurs fichiers à la fois à l'aide de modèles globaux :

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

Pour que les modifications de contexte soient permanentes, ajoutez plutôt les fichiers resources dans le champ de votre agent.

Contexte de visualisation

Pour afficher votre contexte actuel, utilisez la /context show commande :

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

Le résultat indique :

• 👤 Agent : contexte persistant issu du resources champ de votre agent

• 💬 Session : contexte temporaire ajouté lors de la session en cours

Supprimer le contexte

Pour supprimer des fichiers de votre contexte de session actuel, utilisez la /context rm commande suivante :

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

Pour effacer tout le contexte de session, utilisez la /context clear commande suivante :

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

Remarque : Vous ne pouvez pas supprimer le contexte défini par l'agent à l'aide /context de commandes. Pour supprimer définitivement le contexte, modifiez le resources champ de votre agent.

Cas d’utilisation courants

Voici quelques cas d'utilisation courants pour la gestion du contexte :

Utilisation des règles du projet

Amazon Q prend en charge les règles au niveau du projet qui peuvent définir des directives et des restrictions de sécurité. Ces règles sont définies dans les fichiers Markdown du .amazonq/rules répertoire de votre projet.

Par exemple, vous pouvez créer des règles qui spécifient :

• Quels répertoires Amazon Q doit éviter d'accéder

• Exigences de sécurité pour le code généré

• Normes de codage et meilleures pratiques

La méthode recommandée pour inclure les règles du projet consiste à configurer votre agent :

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

Vous pouvez également ajouter temporairement des règles de projet à votre session en cours :

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

Pour plus d'informations sur la création et l'utilisation des règles de projet, consultez la section Création de règles de projet à utiliser avec le chat Amazon Q Developer dans la documentation de l'IDE.

Migration du contexte de session vers les ressources de l'agent

Si vous ajoutez à plusieurs reprises les mêmes fichiers de contexte à l'aide de /context add commandes, pensez à les déplacer vers le resources champ de votre agent pour des raisons de persistance :

1. Notez les fichiers que vous ajoutez fréquemment avec /context add

2. Modifiez le fichier de configuration de votre agent

3. Ajoutez les chemins de fichiers au resources tableau avec le file:// préfixe

4. Enregistrez la configuration de l'agent

Exemple de migration :

# 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"
  ]
}