Estendere un agente con i dataset
Un agente riceve istruzioni, skill, tool e file di lavoro dai dataset che colleghi alle sue porte di input. Non devi ricostruire l'agente: registri un dataset, gli assegni la categoria giusta e lo colleghi nel Workflow Designer.
È la categoria a dire all'agente come usare il dataset. La stessa cartella è un insieme di istruzioni con la categoria Prompt e semplici dati di lavoro senza categoria.
Creare il dataset
La registrazione di un dataset per un agente è la normale registrazione di un dataset, con un passo in più: la scelta della categoria.
- Prepara una cartella con la struttura prevista dalla categoria (vedi Categorie).
- Vai su Datasets e registra un nuovo dataset, caricando la cartella. I passi sono quelli dei primi passi.
- Nel form di registrazione, imposta la categoria del dataset:
Prompt,Skill,TooloData. - Salva il dataset.
Un dataset senza categoria è un dataset di dati
Se lasci vuota la categoria, l'agente tratta il dataset come dati di lavoro: istruzioni, skill e tool non vengono caricati. È il motivo più comune per cui una skill "non si carica".
Categorie
| Categoria | Struttura della cartella | Agente OpenCode | Agente ADK |
|---|---|---|---|
Prompt | AGENTS.md, skills/ e, per OpenCode, anche opencode.json, agents/, tools/, lib/, plugins/, docs/, init.d/ | L'intero dataset diventa la configurazione dell'agente. Vedi Dataset Prompt. | L'AGENTS.md della radice viene aggiunto all'istruzione dell'agente e le skills/ vengono importate. Il resto viene ignorato. |
Skill | skills/NAME/SKILL.md, una cartella per skill | Le skill vengono importate. | Le skill vengono importate. |
Tool | tools/*.ts, lib/, un package.json nella radice | I tool vengono importati. | Saltato: ADK non ha tool TypeScript. Usa invece un server MCP. |
Data o nessuna | File qualsiasi | Copiati in /workspace/data. | Saltato. |
Sono accettate anche le forme plurali (Prompts, Skills, Tools). Qualsiasi altra categoria blocca l'agente all'avvio con Unsupported category.
Usa solo dataset Prompt affidabili
Su OpenCode un dataset Prompt viene importato completamente, inclusi tool, plugin e permessi, e può sovrascrivere i permessi di default.
Collegare il dataset all'agente
Entrambi gli agenti hanno sei input facoltativi:
| Input | Accettano |
|---|---|
da input-dataset-1 a 3 | Dataset URL: server MCP e, per ADK, anche agent card A2A. |
da input-dataset-4 a 6 | Dataset di file: le categorie qui sopra. |
Nel Workflow Designer, trascina il dataset sul canvas e collegalo a uno degli input da 4 a 6 dell'agente, poi esegui il workflow. I dataset vengono letti all'avvio dell'agente: dopo aver modificato un dataset, riavvia il workflow.
Puoi collegare più dataset di file, per esempio un dataset Prompt con le istruzioni e un dataset Skill condiviso da più agenti.
Verificare che abbia funzionato
Apri i log del workflow con il pulsante show-logs nella pagina del workflow. Ogni dataset risulta importato, oppure segnalato con il motivo per cui è stato saltato.
| Messaggio | Causa |
|---|---|
Unsupported category ... | La categoria non è Prompt, Skill, Tool, Data o vuota. |
... category ... is not enabled for this runtime | L'agente non supporta quella categoria (per esempio Tool su ADK), oppure è stata tolta da ALIDA_ENABLED_CATEGORIES. |
... has no importable files | Il dataset è vuoto, oppure i file non rispettano la struttura prevista dalla categoria. |
Prossimo passo: vedi i dettagli specifici di OpenCode e ADK, oppure parti da un dataset Prompt già pronto con Service Writer.