Vai al contenuto

Assistenti IA

Assistenti che rispondono per te, in privato o in pubblico.

Apri Assistenti IA
Verificato rispetto alla dashboard il 20 novembre 2026

Assistenti IA ha sei metodi pubblici. Agiscono su un assistente già esistente: il segno di preferito, il pin, l'archivio e la sua immagine. Ognuno agisce per il conto di cui usi la chiave API.

Creare un assistente, cambiare la sua configurazione, i suoi preset e i suoi inviti, inviare un invito, leggere le sue sessioni e scegliere un piano si fa nella dashboard. Oggi non hanno un metodo pubblico.

Invia una richiesta a un metodo con la tua chiave:

curl -s https://xuda.ai/cpi/favorite_ai_agent \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","agent_id":"YOUR_ASSISTANT_ID"}'
const res = await fetch('https://xuda.ai/cpi/favorite_ai_agent', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    agent_id: 'YOUR_ASSISTANT_ID',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/favorite_ai_agent',
    json={
        'api_key': 'YOUR_API_KEY',
        'agent_id': 'YOUR_ASSISTANT_ID',
    },
)

Una risposta riuscita ha code 1. Una rifiutata ha un code negativo e ne spiega il motivo in data. Vedi Chiamare un metodo per le forme della richiesta.

Gli elenchi di Assistant e Skill condividono questi metodi, quindi il campo si chiama agent_id: è l'id dell'assistente. Ogni metodo accetta inoltre un workspace_id facoltativo, per agire in un workspace diverso dal tuo. Chi chiama deve esserne il proprietario.

Segna un assistente

  • favorite_ai_agent accetta agent_id e segna l'assistente come preferito. È il cuore sulla sua scheda, e la scelta Preferiti nel menu Mostra della pagina lo elenca.
  • unfavorite_ai_agent accetta lo stesso campo e toglie il segno.
  • pin_ai_agent accetta agent_id e segna l'assistente come fissato.
  • unpin_ai_agent accetta lo stesso campo e toglie il pin.

Archivia un assistente

archive_ai_agent accetta agent_id e archivia l'assistente. Esce dall'elenco Attivo e compare sotto Archiviato, e le sue conversazioni vengono archiviate con lui. Un conversation_id facoltativo restringe a quella sola le conversazioni che vengono archiviate.

Solo chi ha creato l'assistente può archiviarlo. Un assistente che è stato condiviso con te viene rifiutato con Operation not allowed. Un assistente che hai condiviso con altri viene rifiutato con active share found finché la condivisione non termina.

Ripristinare un assistente archiviato ed eliminarlo definitivamente sono azioni della dashboard: Rimuovi dall'archivio ed Elimina nel menu della scheda, sotto lo stato Archiviato.

Disegna un'immagine

generate_ai_agent_image accetta agent_id e disegna una nuova immagine per un assistente di cui sei proprietario, usando il generatore che gira quando ne viene creato uno. Usalo quando una scheda mostra il segnaposto. Gira in background come job, e la nuova immagine compare al caricamento successivo.

Le scelte per l'immagine, come paese, genere, settore e le tue parole, l'uso del tuo ritratto e un'immagine caricata si impostano nella finestra di configurazione della dashboard.

Che cosa cambia ogni piano

Nessuno di questi metodi è riservato a un piano. Ciò che un piano cambia è ciò che l'assistente può fare per i visitatori, che non è raggiungibile da un metodo. Vedi Piani e fatturazione.

Come ti sembra questa guida?

Ultimo aggiornamento il 16 novembre 2026