Habilidades
Las habilidades de agenteSKILL.md archivo con instrucciones preliminares (nombre, descripción) y markdown en YAML, además de directorios y carpetas opcionalesscripts/. references/ assets/
Las habilidades se divulgan progresivamente: los metadatos se introducen en el sistema desde el principio (aproximadamente 100 fichas) y las instrucciones completas se cargan a pedido mediante una llamada a una herramienta. Esto evita inundar la ventana de contexto con instrucciones que el agente tal vez no necesite.
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 AWS agentes |
Lo que necesita es una AWS experiencia práctica y sin necesidad de configuración. |
|
Git (HTTPS) |
Clona una habilidad de cualquier repositorio Git público o privado. Soporta subdirectorios. |
Quieres hacer referencia a las habilidades de GitHub GitLab, o de cualquier host de git, sin necesidad de subirlas a S3. |
|
Amazon S3 |
Obtén una habilidad de un bucket de S3 propiedad de un cliente mediante la función de ejecución. |
Desea tener el control total sobre el control de versiones, el cifrado y el acceso. |
|
Ruta (sistema de archivos) |
Haga referencia a una habilidad que ya esté presente en el sistema de archivos del arnés (integrada en la imagen del contenedor o instalada a través de ella). |
La habilidad forma parte de la imagen del contenedor o se instaló al inicio de la sesión. |
Las habilidades se obtienen una vez por sesión en la primera invocación. En una sesión, las habilidades permanecen en el disco tras varias invocaciones. Cuando la máquina virtual caduca y se inicia una nueva sesión, las habilidades se vuelven a recuperar para garantizar su actualización.
Puede configurarlo skills como predeterminado en el arnés (mediante CreateHarness oUpdateHarness) o anularlo por invocación. Invoke-time las habilidades se añaden después de las habilidades de tiempo de creación; si ambas definen una habilidad con el mismo nombre, gana la versión de tiempo de invocación.
nota
Para añadir una habilidad a un arnés de forma interactiva, corre agentcore hasta abrir la TUI, selecciona añadir, elige Arnés, accede a la configuración avanzada y activa las habilidades. A continuación, el asistente solicitará la fuente de la habilidad. Consulte la pestaña Interactiva en Git y Amazon S3 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óstico, análisis de registros. |
|
Habilidades de almacenamiento |
|
S3, EFS, FSx, operaciones de Backup. |
Habilite todas AWS Habilidades
ejemplo
Habilite 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
/direcciones..). Se rechazan las rutas absolutas y el recorrido de las rutas. -
Si un patrón global no coincide con ninguna habilidad, la invocación falla y se produce un error descriptivo.
-
Se fusionan varias
awsSkillsentradas de la misma carga útil.
Habilidades de Git (HTTPS)
Clona una habilidad de cualquier repositorio Git público o privado. Admite subdirectorios dentro de monorepos mediante un proceso de pago disperso.
ejemplo
-
url(obligatorio): URL HTTPS del repositorio de Git. -
path(opcional): subdirectorio dentro del repositorio que contiene la habilidad. Si se omite, se utiliza la raíz del repositorio. -
auth.credentialArn(opcional): ARN de un proveedor de credenciales de clave API que posea un token de acceso personal para repositorios privados. -
auth.username(opcional): nombre de usuario de git, el valor predeterminado es.oauth2
La recuperación de Git debe completarse en 60 segundos. Si el repositorio requiere la salida de Internet, asegúrese de que su VPC tenga una puerta de enlace NAT (el mismo requisito que los servidores MCP remotos y las extracciones de contenedores personalizadas).
Habilidades de Amazon S3
Obtenga una habilidad de un bucket de S3 propiedad de un cliente. Utiliza las credenciales de la función de ejecución de arneses.
ejemplo
-
uri(obligatorio): URI de S3 que apunta al directorio de habilidades (por ejemplo,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 finales de VPC de S3 (no se requiere una puerta de enlace NAT).
Conocimientos sobre la ruta del sistema de archivos
Haga referencia a una habilidad que ya esté incluida en el sistema de archivos del arnés, integrada en la imagen del contenedor o instalada al inicio de la sesión mediante ella. InvokeAgentRuntimeCommand
ejemplo
Hornea en el recipiente (imagen)
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"
Combine 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 recuperación fallan en la invocación y se produce un error descriptivo. Las habilidades nunca se omiten silenciosamente.
| 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 s) |
|
|
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 contenedores personalizadas y configuración del entorno
-
Memoria- mantener las conversaciones en todas las sesiones
-
Seguridad y controles de acceso- políticas de roles de ejecución para fuentes de habilidades