As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Habilidades

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

As habilidades usam a divulgação progressiva: os metadados são injetados antecipadamente no 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 em disco em várias invocações. Quando a VM expira e uma nova sessão começa, as habilidades são rebuscadas para garantir o frescor.

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

AWS Habilidades

AWS habilidades são habilidades pré-construídas 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 a fonte deles em GitHub.

Ativar 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/*"]}}]

Habilidades 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 pela Internet, certifique-se de que sua VPC tenha um gateway NAT (mesmo requisito dos servidores MCP remotos e dos contêineres personalizados).

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

Consulte 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 origem podem coexistir em uma única carga:

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