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

# Informazioni sugli agent

> Definisci agent AI usando file di configurazione locali

<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 sugli agent AI nell'editor dell'app, consulta <a href="/Building-your-app/AI-agents-for-apps">Configurare un agent AI</a>.
    </div>
  </div>
</div>

Gli [agent AI](/it/Building-your-app/AI-agents-for-apps) sono assistenti AI personalizzabili che eseguono azioni e si collegano a strumenti per aiutare membri del team e utenti finali. Definisci comportamento, permessi e strumenti degli agent usando file di configurazione JSONC locali.

## Creare agent

Crea file di configurazione JSONC nella directory `base44/agents/` (un file per agent). Poi esegui [`agents push`](/it/developers/references/cli/commands/agents-push) per sincronizzarli con Base44.

## Esempio

```jsonc theme={null}
{
  "name": "customer_support",
  "description": "Handles customer support inquiries and ticket management",
  "instructions": "You are a friendly customer support agent. Help users resolve their issues politely and efficiently. If you cannot help, escalate to a human agent.",
  "model": "claude-sonnet-5",
  "tool_configs": [
    {
      "entity_name": "tickets",
      "allowed_operations": ["read", "create", "update"],
    },
    {
      "entity_name": "customers",
      "allowed_operations": ["read"],
    },
    {
      "function_name": "send_notification",
      "description": "Sends a push notification to the customer",
    },
    {
      "function_name": "escalate_to_human",
      "description": "Escalates the conversation to a human support agent",
    },
  ],
  "whatsapp_greeting": "Hi, I'm your support assistant. How can I help you today?",
  "selected_skill_names": ["refund-policy", "brand-voice"],
}
```

## Riferimento dei campi

Le configurazioni degli agent usano JSONC. Ogni agent è definito in un file separato nella directory `base44/agents/`.

### Campi obbligatori

<ResponseField name="name" type="string" required>
  Identificatore univoco dell'agent. Usa lettere minuscole e underscore. Il
  nome deve corrispondere al nome del file. Un agent chiamato `customer_support`
  si trova quindi in `customer_support.jsonc`.
</ResponseField>

<ResponseField name="description" type="string" required>
  Breve descrizione di cosa fa l'agent.
</ResponseField>

<ResponseField name="instructions" type="string" required>
  Prompt di sistema che definisce comportamento, personalità e linee guida dell'agent.
</ResponseField>

<ResponseField name="model" type="string" required>
  Il modello AI su cui funziona l'agent. Usa `automatic` per lasciare che sia Base44 a sceglierlo. In alternativa, imposta un ID preset dall'elenco dei [modelli supportati](/it/developers/backend/resources/models), ad esempio `claude-sonnet-5` o `gpt_6_sol`.

  Gli ID preset dismessi che Base44 riconosce ancora vengono aggiornati automaticamente a un sostituto attuale.
</ResponseField>

### Campi facoltativi

<ResponseField name="tool_configs" type="array">
  Strumenti che l'agent può usare per interagire con la tua app. Vedi
  [Configurazione degli strumenti](#tool-configuration).
</ResponseField>

<ResponseField name="whatsapp_greeting" type="string">
  Messaggio di benvenuto per le conversazioni WhatsApp con questo agent.
</ResponseField>

<ResponseField name="selected_skill_names" type="array">
  Nomi delle [skill degli agent](/it/developers/backend/resources/agents/agent-skills)
  associate a questo agent. Massimo 10 skill per agent.
</ResponseField>

## Configurazione degli strumenti

L'array `tool_configs` definisce le capacità del tuo agent. Esistono due tipi: **strumenti per le entità** e **strumenti per le funzioni**.

### Strumenti per le entità

Gli strumenti per le entità permettono all'agent di eseguire operazioni CRUD sulle [entità](/it/developers/backend/resources/entities/overview) della tua app.

<ResponseField name="entity_name" type="string" required>
  Nome dell'entità. Deve corrispondere a un'entità esistente nella tua app.
</ResponseField>

<ResponseField name="allowed_operations" type="array" required>
  Operazioni che l'agent può eseguire su questa entità. I valori validi sono `"read"`,
  `"create"`, `"update"` e `"delete"`.
</ResponseField>

### Strumenti per le funzioni

Gli strumenti per le funzioni permettono all'agent di invocare le [funzioni backend](/it/developers/backend/resources/backend-functions/overview) della tua app.

<ResponseField name="function_name" type="string" required>
  Nome della funzione. Deve corrispondere a una funzione esistente nella tua app.
</ResponseField>

<ResponseField name="description" type="string" required>
  Descrizione di cosa fa la funzione. L'agent la usa per decidere quando
  chiamarla.
</ResponseField>

## Tipi TypeScript

Genera tipi TypeScript dalle configurazioni dei tuoi agent. Ottieni così type safety e autocompletamento per i nomi degli agent nel codice SDK. Scopri di più sui [tipi dinamici](/it/developers/references/sdk/getting-started/dynamic-types).

## Vedi anche

* [`agents pull`](/it/developers/references/cli/commands/agents-pull): Sincronizza le configurazioni degli agent da Base44 al tuo progetto locale
* [`agents push`](/it/developers/references/cli/commands/agents-push): Distribuisci le configurazioni locali degli agent su Base44
* [Skill degli agent](/it/developers/backend/resources/agents/agent-skills): Definisci set di istruzioni riutilizzabili per i tuoi agent
* [`agents`](/it/developers/references/sdk/docs/interfaces/agents): Riferimento SDK per lavorare con gli agent nel tuo codice
* [Configurare agent AI](/it/Building-your-app/AI-agents-for-apps): Guida alla creazione e configurazione di agent AI

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