Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Compétences

https://strandsagents.com/docs/user-guide/concepts/plugins/skills/Les compétences des agents sont des ensembles de markdown et de scripts qui fournissent à l'agent des connaissances sur le domaine à la demande. Chaque compétence suit le AgentSkills.io standard ouvert : un SKILL.md fichier contenant le texte de base YAML (nom, description) et des instructions de démarquage, ainsi que des répertoires facultatifsscripts/. references/ assets/

Les compétences utilisent la divulgation progressive : les métadonnées sont injectées dans l'invite du système dès le départ (environ 100 jetons) et des instructions complètes sont chargées à la demande via un appel d'outil. Cela évite d'inonder la fenêtre contextuelle d'instructions dont l'agent n'a peut-être pas besoin.

Le harnais prend en charge quatre sources de compétences :

Les compétences sont récupérées une fois par session lors de la première invocation. Au cours d'une session, les compétences sont conservées sur le disque lors de plusieurs appels. Lorsque la machine virtuelle expire et qu'une nouvelle session démarre, les compétences sont récupérées à nouveau pour garantir leur fraîcheur.

Vous pouvez skills le définir par défaut sur le harnais (via CreateHarness ouUpdateHarness), ou annuler par invocation. Invoke-time les compétences sont ajoutées après les compétences au moment de la création ; si les deux définissent une compétence portant le même nom, la version au moment de l'invocation l'emporte.

AWS Compétences

AWS les compétences sont des compétences prédéfinies qui permettent à vos agents d'interagir avec les AWS services. Ils sont organisés hiérarchiquement et sélectionnés selon des modèles globulaires. Consultez leur source sur GitHub.

Tout activer AWS compétences

Activez les compétences par catégorie

Utilisez des modèles globaux pour activer des catégories de compétences spécifiques :

Activez une compétence spécifique

response = client.invoke_harness(
    harnessArn=HARNESS_ARN,
    runtimeSessionId=SESSION_ID,
    skills=[{"awsSkills": {"paths": ["core-skills/aws-cdk"]}}],
    messages=[{"role": "user", "content": [{"text": "Create a CDK stack for a Lambda function."}]}],
)

Combinez plusieurs motifs

skills=[{"awsSkills": {"paths": ["core-skills/aws-cdk", "core-skills/aws-serverless", "specialized-skills/storage-skills/*"]}}]

Compétences en matière de Git (HTTPS)

Clonez une compétence depuis n'importe quel dépôt Git public ou privé. Prend en charge les sous-répertoires dans les monorepos à l'aide d'un paiement fragmenté.

Git fetch doit être terminé dans les 60 secondes. Si le référentiel nécessite une sortie Internet, assurez-vous que votre VPC dispose d'une passerelle NAT (même exigence que les serveurs MCP distants et les extractions de conteneurs personnalisées).

Compétences relatives à Amazon S3

Récupérez une compétence depuis un compartiment S3 appartenant au client. Utilise les informations d'identification du rôle d'exécution du harnais.

Compétences en matière de chemin de système de fichiers

Faites référence à une compétence déjà présente dans le système de fichiers du harnais, intégrée à l'image du conteneur ou installée au démarrage de la session viaInvokeAgentRuntimeCommand.

Cuire au four dans le contenant (image)

Incluez le répertoire des compétences dans votre image personnalisée :

COPY skills/xlsx .agents/skills/xlsx

Installation au début de la session

À utiliser InvokeAgentRuntimeCommand avant la première invocation de l'agent :

agentcore invoke --exec --harness my-agent --session-id "$SESSION" \
  "git clone --depth 1 https://github.com/anthropics/skills /tmp/skills && cp -r /tmp/skills/skills/xlsx .agents/skills/xlsx"

Combinez plusieurs sources de compétences

Les quatre types de sources peuvent coexister dans une seule charge utile :

response = client.invoke_harness(
    harnessArn=HARNESS_ARN,
    runtimeSessionId=SESSION_ID,
    skills=[
        {"awsSkills": {"paths": ["core-skills/aws-cdk"]}},
        {"git": {"url": "https://github.com/anthropics/skills", "path": "skills/docx"}},
        {"s3": {"uri": "s3://my-bucket/skills/company-style/"}},
        {"path": ".agents/skills/xlsx"},
    ],
    messages=[{"role": "user", "content": [{"text": "Help me with this project."}]}],
)

Gestion des erreurs

Tous les échecs de récupération échouent à l'invocation avec une erreur descriptive. Les compétences ne sont jamais ignorées en silence.

Rubriques associées