> ## 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.

# Skill degli agent

> Definisci set di istruzioni riutilizzabili per gli agent AI della tua app

<div className="dev-docs-banner">
  <div className="dev-docs-banner-content">
    <div className="dev-docs-banner-title">
      Stai visualizzando la documentazione per sviluppatori
    </div>

    <div className="dev-docs-banner-text">
      Questa documentazione è per sviluppatori che lavorano con la piattaforma per sviluppatori di Base44. Per informazioni sull'aggiunta di skill agli agent nell'editor dell'app, consulta <a href="/Building-your-app/AI-agents-for-apps">Configurare un agent AI</a>.
    </div>
  </div>
</div>

Le skill degli agent sono set di istruzioni riutilizzabili. Danno ai tuoi [agent AI](/it/developers/backend/resources/agents/overview) comportamenti, competenze o policy specifiche, come una policy di rimborso o un tono di voce del brand. Le skill degli agent valgono a livello di app. Le definisci quindi una volta per la tua app e puoi associarle a qualsiasi agent di quell'app.

<Note>
  Queste sono skill per gli agent che funzionano nella tua app. Non sono le [skill di Base44](/it/developers/backend/overview/skills) che insegnano ad assistenti AI di programmazione come Claude e Cursor a creare app Base44.
</Note>

## Come gli agent usano le skill

Ogni agent seleziona per nome le skill di cui ha bisogno. In fase di esecuzione, l'agent vede sempre la descrizione di ogni skill selezionata. Carica le istruzioni complete solo quando decide che la skill è pertinente. Così il prompt dell'agent resta breve, ma l'agent può accedere a istruzioni dettagliate quando servono.

Puoi associare fino a 10 skill a un singolo agent. Un'app può contenere fino a 100 skill in totale.

Per associare una skill a un agent, aggiungi il nome della skill all'array `selected_skill_names` dell'agent:

```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"],
}
```

## Definire le skill degli agent in locale

Ogni skill è un singolo file Markdown nella directory `base44/agent-skills/`. Il nome del file, senza l'estensione `.md`, è il nome della skill. Il frontmatter YAML contiene la `description` della skill. Il corpo contiene le istruzioni che l'agent segue quando usa la skill. Ad esempio:

```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.
```

I nomi delle skill devono essere in minuscolo e usare trattini per separare le parole, ad esempio `refund-policy`. Le descrizioni possono avere fino a 1024 caratteri e il corpo delle istruzioni fino a 15000 caratteri.

<Tip>
  Per impostazione predefinita, le skill si trovano in `base44/agent-skills/`. Puoi personalizzare il percorso con `agentSkillsDir` nella [configurazione del progetto](/it/developers/backend/overview/project-structure#config-jsonc).
</Tip>

## Distribuire le skill degli agent

Distribuisci le skill degli agent con [`agent-skills push`](/it/developers/references/cli/commands/agent-skills-push). In alternativa, usa [`deploy`](/it/developers/references/cli/commands/deploy) per inviare tutte le risorse del progetto in una volta.

Per scaricare le skill degli agent nel tuo progetto locale, usa [`agent-skills pull`](/it/developers/references/cli/commands/agent-skills-pull).

## Vedi anche

* [`agent-skills push`](/it/developers/references/cli/commands/agent-skills-push): Invia le skill locali degli agent a Base44
* [`agent-skills pull`](/it/developers/references/cli/commands/agent-skills-pull): Sincronizza le skill degli agent da Base44 al tuo progetto locale
* [Informazioni sugli agent](/it/developers/backend/resources/agents/overview): Configura gli agent che usano queste skill

<Note>Questa pagina è stata tradotta con l'AI. Per le informazioni più accurate e aggiornate, consulta la [versione inglese](/). </Note>


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