Vai al contenuto

Skills

Ciò che la tua IA sa fare, in pacchetti.

Apri Skills
Verificato rispetto alla dashboard il 20 novembre 2026

L'API pubblica ha sette metodi per le skill. L'API chiama ancora una skill un agente AI, ed è quello il nome in ogni metodo. Agiscono su skill già esistenti: ne fissano una, ne segnano una come preferita, ne archiviano una, le creano un'immagine e registrano un consenso. Ognuno agisce per il conto di cui usi la chiave API.

Creare una skill, pianificarne una a partire dalle tue parole, cambiare le sue istruzioni o i suoi strumenti, clonare, installare dal marketplace, inserire nell'elenco, condividere, rimuovere dall'archivio, eliminare 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/pin_ai_agent \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","agent_id":"YOUR_SKILL_ID"}'
const res = await fetch('https://xuda.ai/cpi/pin_ai_agent', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', agent_id: 'YOUR_SKILL_ID' }),
});
const { code, data } = await res.json();
import requests

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

Una risposta riuscita ha code 1. Una rifiutata ha un code negativo e ne spiega il motivo in data.

Ogni metodo prende l'id della skill come agent_id, cioè l'ultima parte dell'indirizzo della skill nella dashboard. Tranne set_agent_tool_consent, ognuno accetta inoltre un workspace_id facoltativo, per agire in un workspace diverso dal tuo di origine. Quel workspace deve essere tuo.

Fissa e segna come preferita

  • pin_ai_agent e unpin_ai_agent fissano una skill e tolgono il pin. La dashboard viene avvisata subito, quindi una pagina aperta mostra la modifica.
  • favorite_ai_agent e unfavorite_ai_agent impostano e tolgono il segno di preferito, il cuore sulla scheda della skill. Un preferito è anche ciò che elenca la scelta Preferiti del menu Mostra.

Archivia

archive_ai_agent sposta una skill dall'elenco attivo ad Archiviato. Una skill archiviata non conta più per il numero che il piano del workspace contiene, il che lo rende un modo per fare spazio sotto un limite.

  • Solo chi ha creato la skill può archiviarla. Per chiunque altro la risposta è un rifiuto che dice che l'operazione non è consentita.
  • Una skill che hai condiviso con altri viene rifiutata finché quella condivisione è attiva. Termina prima la condivisione.
  • conversation_id è facoltativo. Con esso viene archiviata solo quella conversazione della skill. Senza, vengono archiviate con essa tutte le conversazioni della skill.

Riportare indietro una skill, o eliminarla definitivamente, si fa nella dashboard, dalla vista Archiviato.

Crea un'immagine

generate_ai_agent_image crea una nuova immagine per una skill di cui sei proprietario e la salva sulla skill. Usalo quando una skill non ha un'immagine e la sua scheda ripiega sul segnaposto. Gira in background, quindi la nuova immagine compare la prossima volta che la skill viene caricata. È la stessa cosa di Genera immagine nel menu della scheda.

Consenti a una skill installata di usare gli strumenti del suo editore

set_agent_tool_consent registra se consenti a una skill installata di usare gli strumenti dei plugin che girano nel workspace del suo editore. Tutto ciò che quegli strumenti creano viene memorizzato nel drive dell'editore anziché nel tuo. Accetta agent_id e granted, true per consentire e false per revocare, e facoltativamente owner_uid, il conto dell'editore. Registra sempre e solo la tua decisione, mai quella di qualcun altro.

Il conteggio di una skill e il suo piano

Le skill sono conteggiate in base al piano del workspace in cui si trovano. Vedi Piani e fatturazione per ciò che conta e che cosa succede al limite.

Come ti sembra questa guida?

Ultimo aggiornamento il 16 novembre 2026