Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Habilidades
https://strandsagents.com/docs/user-guide/concepts/plugins/skills/SKILL.md archivo con el material preliminar de YAML (nombre, descripción) e instrucciones de marcado, además de directorios opcionalesscripts/. references/ assets/
Las habilidades utilizan la divulgación progresiva: los metadatos se introducen en el sistema de forma inmediata (aproximadamente 100 fichas) y las instrucciones completas se cargan cuando se solicita mediante una herramienta. Esto evita saturar la ventana de contexto con instrucciones que el agente podría no necesitar.
El arnés admite cuatro fuentes de habilidades:
| origen | Description (Descripción) | Cuándo se debe usar |
|---|---|---|
|
AWS Habilidades |
Pre-built habilidades para AWS los servicios del kit de herramientas para |
Quieres tener AWS experiencia lista para usar sin tener que configurar nada. |
|
Git (HTTPS) |
Clona una habilidad desde cualquier repositorio Git público o privado. Soporta subdirectorios. |
Quieres hacer referencia a las habilidades de GitHub GitLab, o de cualquier otro host de git, sin subirlas a S3. |
|
Amazon S3 |
Obtén una habilidad de un bucket de S3 propiedad del cliente mediante el rol de ejecución. |
Quieres tener un control total sobre el control de versiones, el cifrado y el acceso. |
|
Ruta (sistema de archivos) |
Haz referencia a una habilidad que ya esté presente en el sistema de archivos del arnés (integrada en la imagen del contenedor o instalada mediante |
La habilidad forma parte de la imagen de tu contenedor o se instaló al iniciar la sesión. |
Las habilidades se obtienen una vez por sesión en la primera invocación. Durante una sesión, las habilidades permanecen en el disco durante varias invocaciones. Cuando la máquina virtual caduca y se inicia una nueva sesión, las habilidades se vuelven a recuperar para garantizar la actualización.
Puedes establecer el arnés skills como predeterminado (mediante CreateHarness oUpdateHarness) o anularlo por invocación. Invoke-time las habilidades se añaden después de las habilidades en el momento de la creación; si ambas definen una habilidad con el mismo nombre, gana la versión en el momento de la invocación.
nota
Para añadir una habilidad a un arnés de forma interactiva, corre agentcore para abrir la TUI, selecciona añadir, elige Arnés, avanza a la configuración avanzada y activa las habilidades. A continuación, el asistente le solicitará la fuente de la habilidad. Consulta la pestaña interactiva de Git y Amazon S3 que aparece a continuación para ver los pasos por fuente.
AWS Habilidades
AWS las habilidades son habilidades prediseñadas que permiten a sus agentes interactuar con AWS los servicios. Se organizan jerárquicamente y se seleccionan mediante patrones globales. Vea su fuente en. GitHub
| Categoría | Patrón | Habilidades típicas |
|---|---|---|
|
Habilidades básicas |
|
Operaciones de EC2, S3, Lambda, DynamoDB e IAM. CloudWatch |
|
Habilidades analíticas |
|
Athena, Glue QuickSight, operaciones de lagos de datos. |
|
Habilidades operativas |
|
Solución de problemas, diagnósticos, análisis de registros. |
|
Habilidades de almacenamiento |
|
S3, EFS, FSx, operaciones de respaldo. |
Habilite todas AWS Habilidades
ejemplo
Habilita las habilidades por categoría
Usa patrones globales para habilitar categorías de habilidades específicas:
ejemplo
Habilita una sola habilidad específica
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 varios patrones
skills=[{"awsSkills": {"paths": ["core-skills/aws-cdk", "core-skills/aws-serverless", "specialized-skills/storage-skills/*"]}}]
nota
-
Las rutas deben ser relativas (sin
/interlineamiento o..). Se rechazan las rutas absolutas y las rutas transversales. -
Si un patrón global no coincide con ninguna habilidad, la invocación falla y se produce un error descriptivo.
-
Se
awsSkillsfusionan varias entradas de la misma carga útil.
Habilidades de Git (HTTPS)
Clona una habilidad desde cualquier repositorio Git público o privado. Admite subdirectorios dentro de monorepos mediante funciones de pago dispersas.
ejemplo
-
url(obligatorio): URL HTTPS del repositorio de Git. -
path(opcional): subdirectorio del repositorio que contiene la habilidad. Si se omite, se usa la raíz del repositorio. -
auth.credentialArn(opcional): ARN de un proveedor de credenciales de claves de API que contiene un token de acceso personal para repositorios privados. -
auth.username(opcional): nombre de usuario de git; el valor predeterminado es.oauth2
La búsqueda de Git debe completarse en 60 segundos. Si el repositorio requiere la salida a Internet, asegúrate de que tu VPC tenga una puerta de enlace NAT (el mismo requisito que los servidores MCP remotos y los extractores de contenedores personalizados).
Conocimientos de Amazon S3
Obtenga una habilidad de un bucket de S3 propiedad del cliente. Usa las credenciales del rol de ejecución del arnés.
ejemplo
-
uri(obligatorio): el URI de S3 apunta al directorio de habilidades (p. ej.,s3://bucket/prefix/). -
El rol de ejecución debe tener
s3:GetObjects3:ListBucketpermisos en el bucket. Consulte Seguridad y controles de acceso. -
Cada habilidad de S3 debe tener 1 GB o menos.
-
Las fuentes de S3 funcionan con los puntos de enlace de VPC de S3 (no se requiere una puerta de enlace NAT).
Conocimientos de rutas del sistema de archivos
Haga referencia a una habilidad que ya esté en el sistema de archivos Harness, ya sea integrada en la imagen del contenedor o instalada al iniciar la sesión. InvokeAgentRuntimeCommand
ejemplo
Incorpora la imagen del contenedor
Incluye el directorio de habilidades en tu imagen personalizada:
COPY skills/xlsx .agents/skills/xlsx
Instálelo al inicio de la sesión
Úselo InvokeAgentRuntimeCommand antes de la primera invocación del 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 varias fuentes de habilidades
Los cuatro tipos de fuentes pueden coexistir en una sola carga útil:
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."}]}], )
Gestión de errores
Todos los errores de búsqueda fallan en la invocación con un error descriptivo. Las habilidades nunca se omiten de forma silenciosa.
| Failure | Mensaje de error |
|---|---|
|
Acceso denegado a S3 |
|
|
No se ha encontrado el objeto S3 |
|
|
El clon de Git falla (red) |
|
|
Autenticación de Git denegada |
|
|
No se encontró la ruta de Git en el repositorio |
|
|
Tiempo de espera de Git (60 segundos) |
|
|
La habilidad supera el límite de 1 GB |
|
|
AWS la trayectoria de habilidad no coincide con nada |
|
|
Recorrido de ruta () |
|
|
AWS falta el paquete de habilidades |
|
Temas relacionados
-
Tools (Herramientas)- conecte los servidores MCP, la puerta de enlace, el navegador y el intérprete de código
-
Entorno y sistema de archivos- imágenes de contenedor personalizadas y configuración del entorno
-
Memoria- persisten las conversaciones entre sesiones
-
Seguridad y controles de acceso- políticas de roles de ejecución para fuentes de habilidades