Habilidades

As habilidades do agente são pacotes de markdown e scripts que fornecem ao agente conhecimento de domínio sob demanda. Cada habilidade segue o AgentSkills.iopadrão aberto: um SKILL.md arquivo com o frontmatter YAML (nome, descrição) e instruções de markdown, além de diretórios opcionais scripts/ e. references/ assets/

As habilidades usam a divulgação progressiva: os metadados são injetados antecipadamente no prompt do sistema (aproximadamente 100 tokens) e as instruções completas são carregadas sob demanda por meio de uma chamada de ferramenta. Isso evita inundar a janela de contexto com instruções que o agente talvez não precise.

O arnês suporta quatro fontes de habilidades:

As habilidades são obtidas uma vez por sessão na primeira invocação. Em uma sessão, as habilidades persistem no disco em várias invocações. Quando a VM expira e uma nova sessão é iniciada, as habilidades são recuperadas para garantir a atualização.

Você pode definir skills como padrão o chicote (via CreateHarness ouUpdateHarness) ou substituir por invocação. Invoke-time as habilidades são acrescentadas após as habilidades de criação; se ambas definirem uma habilidade com o mesmo nome, a versão de tempo de invocação vencerá.

AWS Habilidades

AWS habilidades são habilidades pré-criadas que permitem que seus agentes interajam com os AWS serviços. Eles são organizados hierarquicamente e selecionados por meio de padrões globais. Veja sua fonte em GitHub.

Habilitar tudo AWS Habilidades

Habilite habilidades por categoria

Use padrões globais para habilitar categorias de habilidades específicas:

Habilite uma única habilidade 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."}]}],
)

Combine vários padrões

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

Competências em Git (HTTPS)

Clone uma habilidade de qualquer repositório Git público ou privado. Suporta subdiretórios em monorepos usando checkout esparso.

O Git fetch deve ser concluído em 60 segundos. Se o repositório exigir saída da Internet, certifique-se de que sua VPC tenha um gateway NAT (o mesmo requisito dos servidores MCP remotos e das retiradas personalizadas de contêineres).

Habilidades do Amazon S3

Obtenha uma habilidade em um bucket S3 de propriedade do cliente. Usa as credenciais da função de execução do harness.

Habilidades de caminho do sistema de arquivos

Faça referência a uma habilidade que já está no sistema de arquivos harness - incorporada à imagem do contêiner ou instalada no início da sessão via. InvokeAgentRuntimeCommand

Asse na imagem do recipiente

Inclua o diretório de habilidades em sua imagem personalizada:

COPY skills/xlsx .agents/skills/xlsx

Instalar no início da sessão

Use InvokeAgentRuntimeCommand antes da primeira invocação do 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 várias fontes de habilidades

Todos os quatro tipos de fonte podem coexistir em uma única 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."}]}],
)

Tratamento de erros

Todas as falhas de busca falham na invocação com um erro descritivo. As habilidades nunca são ignoradas silenciosamente.

Tópicos relacionados