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

# Informazioni sugli agenti

> Definisci agenti IA 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 di sviluppo Base44. Per informazioni sugli agenti IA nell'editor di app, consulta <a href="/Building-your-app/AI-agents-for-apps">Configurare un agente IA</a>.
    </div>
  </div>
</div>

Gli [agenti IA](/Building-your-app/AI-agents-for-apps) sono assistenti IA personalizzabili che agiscono e si connettono a strumenti per aiutare i membri del team e gli utenti finali. Definisci il comportamento, i permessi e gli strumenti degli agenti usando file di configurazione JSONC locali.

## Crea agenti

Crea file di configurazione JSONC nella tua directory `base44/agents/` (un file per agente), quindi esegui [`agents push`](/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": "anthropic/claude-sonnet-4-20250514",
  "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?",
}
```

## Riferimento dei campi

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

### Campi richiesti

<ResponseField name="name" type="string" required>
  Identificatore univoco per l'agente. Usa lettere minuscole e underscore. Il
  nome dovrebbe corrispondere al nome del file, quindi un agente chiamato `customer_support` sarebbe
  in `customer_support.jsonc`.
</ResponseField>

<ResponseField name="description" type="string" required>
  Breve descrizione di ciò che fa l'agente.
</ResponseField>

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

<ResponseField name="model" type="string" required>
  Il modello IA da usare, nel formato `provider/model-name`.

  Modelli supportati:

  * `anthropic/claude-sonnet-4-20250514`
  * `anthropic/claude-3-5-sonnet-20241022`
  * `openai/gpt-4o`
  * `openai/gpt-4o-mini`
</ResponseField>

### Campi opzionali

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

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

## Configurazione degli strumenti

L'array `tool_configs` definisce quali capacità ha il tuo agente. Ci sono due tipi: **strumenti entità** e **strumenti funzione**.

### Strumenti entità

Gli strumenti entità consentono all'agente di eseguire operazioni CRUD sulle [entità](/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'agente può eseguire su questa entità. I valori validi sono `"read"`,
  `"create"`, `"update"` e `"delete"`.
</ResponseField>

### Strumenti funzione

Gli strumenti funzione consentono all'agente di invocare le [funzioni backend](/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 ciò che fa la funzione. L'agente la usa per decidere quando
  chiamarla.
</ResponseField>

## Tipi TypeScript

Genera tipi TypeScript dalle configurazioni dei tuoi agenti per ottenere sicurezza dei tipi e autocompletamento per i nomi degli agenti nel tuo codice SDK. Scopri di più sui [tipi dinamici](/developers/references/sdk/getting-started/dynamic-types).

## Vedi anche

* [`agents pull`](/developers/references/cli/commands/agents-pull): sincronizza le configurazioni degli agenti da Base44 al tuo progetto locale
* [`agents push`](/developers/references/cli/commands/agents-push): distribuisci le tue configurazioni di agenti locali su Base44
* [`agents`](/developers/references/sdk/docs/interfaces/agents): riferimento SDK per lavorare con gli agenti nel tuo codice
* [Configurare agenti IA](/Building-your-app/AI-agents-for-apps): guida per creare e configurare agenti IA

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