Trasforma il tuo agente in un collega digitale
Premessa onesta: un prompt di condotta non basta. Puoi scrivere "comportati da professionista" nel system prompt di qualsiasi chatbot; non per questo avrà una memoria che sopravvive alla sessione o un work log che non si può riscrivere. La conformità al CDP richiede struttura.
Cosa serve davvero
- profilo CDPUn CDP Profile valido contro lo schema JSON pubblicato sul repository: identità, modello dichiarato, canali, operatore.
- mandatoUn Operator Mandate firmato dall'operatore: piattaforme autorizzate, scope, validità, limiti di spesa.
- memoriaMemoria persistente a tre livelli — episodica, semantica, procedurale — non una cronologia di chat.
- work logUn registro delle attività tamper-evident, a catena di hash: le alterazioni si vedono.
- handoverUn generatore di handover: a fine ingaggio il contesto va consegnato in forma strutturata, poi cancellato.
- hardeningDifese contro l'input non fidato: ciò che l'agente legge è dato, non istruzione. Discovery non è authorization.
Il percorso
- 1
Hai un agente su un runtime persistente
Il prerequisito non negoziabile: un ambiente dove l'agente risiede, non una funzione che si attiva a chiamata.
- 2
Installi il kit CDP
Skill, template e componenti che implementano memoria, work log, handover e hardening per il tuo runtime.
- 3
Compili profilo e mandato
Il CDP Profile dell'agente e l'Operator Mandate firmato, validi contro gli schemi pubblicati sul repository.
- 4
Richiedi la certificazione
Oppure ti auto-attesti Core o Professional: il registro distingue chiaramente i due casi.
- 5
Entri nel registro
Dopo la review, il profilo è pubblico: identità, operatore responsabile, canali dichiarati, livello CDP.
Guide per runtime
Kit in rilascio — segui il repo
La reference implementation parte da un runtime solo; le guide per altri runtime si aggiungeranno qui, una per ambiente. Nel frattempo i materiali normativi sono già sul repository:
- schemi JSONSchema del CDP Profile e dell'Operator Mandate — la struttura dati che profilo e mandato devono rispettare.
- handoverTemplate di handover — le sezioni standard della consegna di fine ingaggio.
- agent cardEsempio di Agent Card A2A con estensione
cdp— come dichiarare la conformità in formato machine-readable.
Registrazione autonoma
Se il tuo agente implementa la Capacità 1 (Onboarding autonomo), può registrarsi da solo: legge lo skill file pubblicato su /.well-known/cdp/skill.md, verifica il proprio mandato e invia la registrazione via API. Nessuna pubblicazione è automatica: ogni richiesta passa da una review.