Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Competenze
https://strandsagents.com/docs/user-guide/concepts/plugins/skills/SKILL.md file con frontespizio YAML (nome, descrizione) e istruzioni per il markdown, più opzioni opzionali, e cartelle. scripts/ references/ assets/
Le competenze utilizzano una divulgazione progressiva: i metadati vengono inseriti in anticipo nel prompt del sistema (~100 token) e le istruzioni complete vengono caricate su richiesta tramite una chiamata allo strumento. In questo modo si evita di riempire la finestra contestuale di istruzioni che potrebbero non essere necessarie all'agente.
L'imbracatura supporta quattro fonti di abilità:
| Origine | Description | Quando utilizzarlo |
|---|---|---|
|
AWS Competenze |
Pre-built competenze per AWS i servizi dell'AWS Agent Toolkit |
Desideri AWS competenze pronte all'uso senza alcuna configurazione. |
|
Git (HTTPS) |
Clona un'abilità da qualsiasi repository Git pubblico o privato. Supporta le sottodirectory. |
Vuoi fare riferimento alle competenze da GitHub GitLab, o da qualsiasi host git senza caricarle su S3. |
|
Amazon S3 |
Recupera una skill da un bucket S3 di proprietà del cliente utilizzando il ruolo di esecuzione. |
Desideri il pieno controllo sul controllo delle versioni, sulla crittografia e sulla governance degli accessi. |
|
Percorso (file system) |
Fai riferimento a un'abilità già presente nel filesystem di Harness (inserita nell'immagine del contenitore o installata tramite). |
La skill fa parte dell'immagine del contenitore o è stata installata all'inizio della sessione. |
Le abilità vengono recuperate una volta per sessione alla prima chiamata. All'interno di una sessione, le competenze rimangono su disco anche dopo più invocazioni. Quando la VM scade e inizia una nuova sessione, le competenze vengono recuperate nuovamente per garantirne l'aggiornamento.
È possibile impostare l'harness skills come impostazione predefinita (tramite CreateHarness oUpdateHarness) o eseguire l'override per chiamata. Invoke-time le abilità vengono aggiunte dopo le abilità in fase di creazione; se entrambe definiscono un'abilità con lo stesso nome, vince la versione in fase di richiamo.
Nota
Per aggiungere un'abilità a un'imbracatura in modo interattivo, corri agentcore per aprire la TUI, seleziona aggiungi, scegli Harness, vai alle impostazioni avanzate e abilita le abilità. Il wizard ti chiederà quindi di indicare la fonte dell'abilità. Consulta la scheda Interattiva in Git e Amazon S3 qui sotto per i passaggi per sorgente.
AWS Competenze
AWS le competenze sono competenze predefinite che consentono ai tuoi agenti di interagire con i servizi. AWS Sono organizzate gerarchicamente e selezionate tramite schemi globali. Visualizza la loro fonte su. GitHub
| Categoria | Pattern | Competenze tipiche |
|---|---|---|
|
Competenze di base |
|
Operazioni EC2, S3, Lambda, DynamoDB, IAM. CloudWatch |
|
Competenze di analisi |
|
Athena, Glue QuickSight, operazioni sui data lake. |
|
Competenze operative |
|
Risoluzione dei problemi, diagnostica, analisi dei log. |
|
Competenze di archiviazione |
|
S3, EFS, FSx, operazioni di backup. |
Abilita tutto AWS abilità
Esempio
Abilita le competenze per categoria
Usa i modelli globali per abilitare categorie di abilità specifiche:
Esempio
Abilita una singola abilità specifica
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."}]}], )
Combina più modelli
skills=[{"awsSkills": {"paths": ["core-skills/aws-cdk", "core-skills/aws-serverless", "specialized-skills/storage-skills/*"]}}]
Nota
-
I percorsi devono essere relativi (senza
/o iniziali..). I percorsi assoluti e l'attraversamento dei percorsi vengono rifiutati. -
Se un pattern glob non corrisponde a nessuna abilità, l'invocazione fallisce con un errore descrittivo.
-
awsSkillsLe voci multiple dello stesso payload vengono unite.
Competenze Git (HTTPS)
Clona un'abilità da qualsiasi repository Git pubblico o privato. Supporta le sottodirectory all'interno di monorepos utilizzando sparse checkout.
Esempio
-
url(obbligatorio) - URL HTTPS del repository Git. -
path(opzionale) - sottodirectory all'interno del repository contenente l'abilità. Se omesso, viene utilizzata la radice del repository. -
auth.credentialArn(opzionale): ARN di un fornitore di credenziali di chiave API che detiene un token di accesso personale per repository privati. -
auth.username(opzionale) - nome utente git, il valore predefinito è.oauth2
Git fetch deve essere completato entro 60 secondi. Se il repository richiede l'uscita da Internet, assicurati che il tuo VPC disponga di un gateway NAT (stesso requisito dei server MCP remoti e dei container pull personalizzati).
Competenze relative ad Amazon S3
Recupera una skill da un bucket S3 di proprietà del cliente. Utilizza le credenziali del ruolo Harness Execution.
Esempio
-
uri(obbligatorio) - URI S3 che punta alla directory delle competenze (ad es.).s3://bucket/prefix/ -
Il ruolo di esecuzione deve avere
s3:GetObjectes3:ListBucketautorizzazioni sul bucket. Consulta Sicurezza e controlli degli accessi. -
Ogni skill S3 deve avere una dimensione pari o inferiore a 1 GB.
-
Le sorgenti S3 funzionano con gli endpoint S3 VPC (non è richiesto alcun gateway NAT).
Competenze relative ai percorsi del file system
Fai riferimento a un'abilità già presente nel filesystem Harness, inserita nell'immagine del contenitore o installata all'inizio della sessione tramite. InvokeAgentRuntimeCommand
Esempio
Inserisci l'immagine del contenitore
Includi la cartella delle abilità nella tua immagine personalizzata:
COPY skills/xlsx .agents/skills/xlsx
Installa all'inizio della sessione
Utilizzare InvokeAgentRuntimeCommand prima della prima chiamata dell'agente:
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"
Combina più fonti di abilità
Tutti e quattro i tipi di fonti possono coesistere in un unico payload:
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."}]}], )
Gestione degli errori
Tutti gli errori di recupero non superano l'invocazione con un errore descrittivo. Le abilità non vengono mai ignorate silenziosamente.
| Errore | Messaggio di errore |
|---|---|
|
Accesso S3 negato |
|
|
Oggetto S3 non trovato |
|
|
Il clone di Git fallisce (rete) |
|
|
Autenticazione Git negata |
|
|
Percorso Git non trovato nel repo |
|
|
Timeout di Git (60s) |
|
|
L'abilità supera il limite di 1 GB |
|
|
AWS il percorso di abilità non corrisponde a nulla |
|
|
Attraversamento del percorso () |
|
|
AWS pacchetto di competenze mancante |
|
Argomenti correlati
-
Tools (Strumenti)- connetti server MCP, Gateway, Browser e Code Interpreter
-
Ambiente e file system- immagini personalizzate dei contenitori e configurazione dell'ambiente
-
Memoria- persistere le conversazioni tra le sessioni
-
Sicurezza e controlli degli accessi- politiche relative ai ruoli esecutivi per le fonti di competenze