Skip to main content
Stai visualizzando la documentazione per sviluppatori
Questa documentazione è per sviluppatori che lavorano con la piattaforma per sviluppatori di Base44. Per informazioni sugli agent AI nell’editor dell’app, consulta Configurare un agent AI.
Gli agent AI 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 per sincronizzarli con Base44.

Esempio

Riferimento dei campi

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

Campi obbligatori

string
obbligatorio
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.
string
obbligatorio
Breve descrizione di cosa fa l’agent.
string
obbligatorio
Prompt di sistema che definisce comportamento, personalità e linee guida dell’agent.
string
obbligatorio
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, ad esempio claude-sonnet-5 o gpt_6_sol.Gli ID preset dismessi che Base44 riconosce ancora vengono aggiornati automaticamente a un sostituto attuale.

Campi facoltativi

array
Strumenti che l’agent può usare per interagire con la tua app. Vedi Configurazione degli strumenti.
string
Messaggio di benvenuto per le conversazioni WhatsApp con questo agent.
array
Nomi delle skill degli agent associate a questo agent. Massimo 10 skill per agent.

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à della tua app.
string
obbligatorio
Nome dell’entità. Deve corrispondere a un’entità esistente nella tua app.
array
obbligatorio
Operazioni che l’agent può eseguire su questa entità. I valori validi sono "read", "create", "update" e "delete".

Strumenti per le funzioni

Gli strumenti per le funzioni permettono all’agent di invocare le funzioni backend della tua app.
string
obbligatorio
Nome della funzione. Deve corrispondere a una funzione esistente nella tua app.
string
obbligatorio
Descrizione di cosa fa la funzione. L’agent la usa per decidere quando chiamarla.

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.

Vedi anche

  • agents pull: Sincronizza le configurazioni degli agent da Base44 al tuo progetto locale
  • agents push: Distribuisci le configurazioni locali degli agent su Base44
  • Skill degli agent: Definisci set di istruzioni riutilizzabili per i tuoi agent
  • agents: Riferimento SDK per lavorare con gli agent nel tuo codice
  • Configurare agent AI: Guida alla creazione e configurazione di agent AI
Questa pagina è stata tradotta con l’AI. Per le informazioni più accurate e aggiornate, consulta la versione inglese.