Vai al contenuto principale
Stai visualizzando la documentazione per sviluppatori
Questa documentazione è per sviluppatori che lavorano con la piattaforma di sviluppo Base44. Per informazioni sugli agenti IA nell’editor di app, consulta Configurare un agente IA.
Gli agenti IA 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 per sincronizzarli con Base44.

​
Esempio

{
  "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

​
name
string
obbligatorio
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.
​
description
string
obbligatorio
Breve descrizione di ciò che fa l’agente.
​
instructions
string
obbligatorio
Prompt di sistema che definisce il comportamento, la personalità e le linee guida dell’agente.
​
model
string
obbligatorio
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

​
Campi opzionali

​
tool_configs
array
Strumenti che l’agente può usare per interagire con la tua app. Consulta Configurazione degli strumenti.
​
whatsapp_greeting
string
Messaggio di benvenuto per le conversazioni WhatsApp con questo agente.

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

​
Strumenti funzione

Gli strumenti funzione consentono all’agente di invocare le funzioni backend della tua app.
​
function_name
string
obbligatorio
Nome della funzione. Deve corrispondere a una funzione esistente nella tua app.
​
description
string
obbligatorio
Descrizione di ciò che fa la funzione. L’agente la usa per decidere quando chiamarla.

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

​
Vedi anche

  • agents pull: sincronizza le configurazioni degli agenti da Base44 al tuo progetto locale
  • agents push: distribuisci le tue configurazioni di agenti locali su Base44
  • agents: riferimento SDK per lavorare con gli agenti nel tuo codice
  • Configurare agenti IA: guida per creare e configurare agenti IA
Questa pagina è stata tradotta utilizzando l’IA. Per informazioni più accurate e aggiornate, consulta la versione inglese.