> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.

# Skills de agente

> Defina conjuntos de instruções reutilizáveis para os agentes de IA do seu app

<div className="dev-docs-banner">
  <div className="dev-docs-banner-content">
    <div className="dev-docs-banner-title">
      Você está vendo a documentação para desenvolvedores
    </div>

    <div className="dev-docs-banner-text">
      Esta documentação é para desenvolvedores que trabalham com a plataforma para desenvolvedores Base44. Para informações sobre como adicionar skills a agentes no editor do app, consulte <a href="/pt-BR/Building-your-app/AI-agents-for-apps">Configurando um agente de IA</a>.
    </div>
  </div>
</div>

Skills de agente são conjuntos de instruções reutilizáveis que dão aos seus [agentes de IA](/pt-BR/developers/backend/resources/agents/overview) comportamentos, conhecimentos ou políticas específicos. Exemplos são uma política de reembolso ou um tom de voz da marca. As skills de agente têm escopo de app. Você as define uma vez para o app e pode vincular qualquer uma delas a qualquer agente desse app.

<Note>
  Estas são skills para os agentes executados dentro do seu app. Elas não são as [skills da Base44](/pt-BR/developers/backend/overview/skills), que ensinam assistentes de programação com IA, como Claude e Cursor, a criar apps da Base44.
</Note>

## Como os agentes usam skills

Cada agente seleciona as skills de que precisa pelo nome. Durante a execução, o agente sempre vê a descrição de cada skill selecionada. Ele carrega as instruções completas sob demanda, apenas quando decide que a skill é relevante. Isso mantém o prompt do agente pequeno e ainda dá acesso a instruções detalhadas quando necessário.

Você pode vincular até 10 skills a um único agente. Um app pode ter até 100 skills no total.

Para vincular uma skill a um agente, adicione o nome da skill ao array `selected_skill_names` do agente:

```jsonc theme={null}
{
  "name": "customer_support",
  "description": "Handles customer support inquiries and ticket management",
  "instructions": "You are a friendly customer support agent.",
  "model": "claude-sonnet-5",
  "selected_skill_names": ["refund-policy", "brand-voice"],
}
```

## Definindo skills de agente localmente

Cada skill é um único arquivo Markdown no diretório `base44/agent-skills/`. O nome do arquivo, sem a extensão `.md`, é o nome da skill. O frontmatter YAML contém a `description` da skill. O corpo contém as instruções que o agente segue quando usa a skill. Por exemplo:

```markdown theme={null}
---
description: How to handle refund requests and exceptions
---

When a customer asks for a refund, first check whether the order is within
the 30 day return window. If it is, approve the refund. If it is outside the
window, explain the policy politely and offer store credit instead.
```

Os nomes das skills devem estar em letras minúsculas e usar hifens para separar palavras, por exemplo `refund-policy`. As descrições podem ter até 1024 caracteres, e o corpo das instruções até 15000 caracteres.

<Tip>
  Por padrão, as skills ficam em `base44/agent-skills/`. Você pode personalizar o caminho com `agentSkillsDir` na [configuração do projeto](/pt-BR/developers/backend/overview/project-structure#config-jsonc).
</Tip>

## Implantar skills de agente

Implante skills de agente com [`agent-skills push`](/pt-BR/developers/references/cli/commands/agent-skills-push). Ou use [`deploy`](/pt-BR/developers/references/cli/commands/deploy) para enviar todos os recursos do projeto de uma vez.

Para baixar skills de agente para o seu projeto local, use [`agent-skills pull`](/pt-BR/developers/references/cli/commands/agent-skills-pull).

## Veja também

* [`agent-skills push`](/pt-BR/developers/references/cli/commands/agent-skills-push): Envie suas skills de agente locais para a Base44
* [`agent-skills pull`](/pt-BR/developers/references/cli/commands/agent-skills-pull): Sincronize as skills de agente da Base44 com seu projeto local
* [Sobre agentes](/pt-BR/developers/backend/resources/agents/overview): Configure os agentes que usam essas skills

<Note>Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a [versão em inglês](/). </Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.