Skills
Ciò che la tua IA sa fare, in pacchetti.
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:
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_agenteunpin_ai_agentfissano una skill e tolgono il pin. La dashboard viene avvisata subito, quindi una pagina aperta mostra la modifica.favorite_ai_agenteunfavorite_ai_agentimpostano 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.
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.