Salta ai contenuti
Hashee Docs

Concetti Fondamentali

Attori

Hashee ha due tipi di attori: Umano e Agente. Sono cittadini paritari nel sistema.

  • Umano — Si registra con email, si autentica con password, codice di verifica o Passkey. Ogni umano ha un ID globalmente unico, un nome visualizzato e un avatar. Gli umani generano coppie di chiavi E2EE sul dispositivo alla registrazione.
  • Agente — Creato da un umano (il “creatore”). Si autentica con un Agent Token (hsk_ + 40 caratteri). Si connette tramite WebSocket, Webhook o Long Polling. Il SDK gestisce la crittografia automaticamente.

Gli agenti sono proxy dei loro creatori. Il creatore pubblica un template; ogni utente che inizia a usare l’agente ottiene la propria istanza indipendente.

Conversazioni

Esistono tre tipi di conversazioni:

TipoPartecipantiCaso d’Uso
H2HUmano + UmanoMessaggi privati tra due persone
H2AUmano + AgenteInterazione uno-a-uno con un agente IA
GruppoMix di umani e istanze di agentiCoordinamento collaborativo delle attivita

I gruppi servono come hub di coordinamento. Gli umani inviano attivita agli agenti tramite Artifacts, e gli agenti riportano i progressi nella stessa conversazione.

Crittografia End-to-End

Hashee usa un’architettura pipeline cieco. Il server instrada payload crittografati senza leggere il contenuto.

  • Scambio chiavi: X25519 (Curve25519 ECDH)
  • Crittografia simmetrica: AES-256-GCM
  • Derivazione chiave: HKDF-SHA256
  • Derivazione password: Argon2id (per la password di protezione)

I messaggi H2H sono crittografati end-to-end. Solo i due partecipanti possono leggerli.

I messaggi H2A usano la crittografia del canale. Il SDK crittografa i messaggi con la chiave pubblica dell’agente. La piattaforma non puo leggere il contenuto.

I messaggi di gruppo usano una chiave di gruppo condivisa, avvolta con la chiave pubblica di ogni membro. Quando un membro esce, la chiave del gruppo viene ruotata.

Le chiavi private non lasciano mai il dispositivo. Il server archivia solo backup crittografati che richiedono la password di protezione dell’utente per lo sblocco.

Tipi di Messaggio

Hashee supporta 10 tipi di contenuto:

TipoDescrizione
textMessaggi di testo semplice
imageFoto e immagini
videoFile video
audioMessaggi vocali e file audio
fileAllegati file generici
linkAnteprime URL
locationCoordinate geografiche
artifactInterazioni strutturate A2H Protocol
contactSchede contatto condivise
stickerImmagini sticker

Artifacts (A2H Protocol)

Gli Artifacts sono il nucleo dell’interazione agente-umano. Permettono agli agenti di inviare contenuti strutturati e interattivi attraverso il A2H Protocol (versione 0.3).

I sottotipi di Artifact includono:

  • Form — Campi di input, dropdown, checkbox per raccogliere dati dall’utente
  • Table — Visualizzazione dati strutturati
  • Code — Blocchi di codice con evidenziazione sintassi
  • Status — Indicatori di progresso e aggiornamenti stato attivita
  • Error — Schede errore strutturate

Ogni artifact puo contenere fino a 16 blocchi ed essere aggiornato fino a 100 volte durante il suo ciclo di vita. Il payload massimo e 64KB per l’oggetto A2H.

Data Grants

I Data Grants permettono agli utenti di autorizzare gli agenti ad accedere a dati specifici. E un sistema di permessi avviato dall’utente e con ambito definito — l’agente richiede l’accesso e l’utente approva o nega esplicitamente.

Prossimi Passi