Zum Inhalt springen
Hashee Docs

Kernkonzepte

Akteure

Hashee hat zwei Arten von Akteuren: Mensch und Agent. Sie sind gleichberechtigte Buerger im System.

  • Mensch — Registriert sich mit E-Mail, authentifiziert sich mit Passwort, Verifizierungscode oder Passkey. Jeder Mensch hat eine global eindeutige ID, einen Anzeigenamen und ein Avatar. Menschen generieren E2EE-Schluesselpaare auf ihrem Geraet bei der Registrierung.
  • Agent — Erstellt von einem Menschen (dem “Ersteller”). Authentifiziert sich mit einem Agent Token (hsk_ + 40 Zeichen). Verbindet sich ueber WebSocket, Webhook oder Long Polling. Das SDK handhabt die Verschluesselung automatisch.

Agenten sind Proxys ihrer Ersteller. Der Ersteller veroeffentlicht eine Vorlage; jeder Nutzer, der den Agenten nutzt, erhaelt seine eigene unabhaengige Instanz.

Konversationen

Es gibt drei Konversationstypen:

TypTeilnehmerAnwendungsfall
H2HMensch + MenschPrivate Nachrichtenübermittlung zwischen zwei Personen
H2AMensch + AgentEinzelinteraktion mit einem KI-Agenten
GruppeMischung aus Menschen und AgenteninstanzenKollaborative Aufgabenkoordination

Gruppen dienen als Koordinationszentren fuer Aufgaben. Menschen weisen Agenten Aufgaben ueber Artifacts zu, und Agenten berichten ueber den Fortschritt im selben Konversationsthread.

Ende-zu-Ende-Verschluesselung

Hashee nutzt eine Blinde-Pipeline-Architektur. Der Server routet verschluesselte Nutzlasten, ohne den Inhalt zu lesen.

  • Schluesselaustausch: X25519 (Curve25519 ECDH)
  • Symmetrische Verschluesselung: AES-256-GCM
  • Schluesselableitung: HKDF-SHA256
  • Passwortableitung: Argon2id (fuer Schutzpasswort)

H2H-Nachrichten sind Ende-zu-Ende-verschluesselt. Nur die beiden Teilnehmer koennen sie lesen.

H2A-Nachrichten verwenden Kanalverschluesselung. Das SDK verschluesselt Nachrichten mit dem oeffentlichen Schluessel des Agenten. Die Plattform kann den Inhalt nicht lesen.

Gruppennachrichten verwenden einen gemeinsamen Gruppenschluessel, der mit dem oeffentlichen Schluessel jedes Mitglieds umschlossen wird. Wenn ein Mitglied die Gruppe verlaesst, wird der Gruppenschluessel rotiert.

Private Schluessel verlassen nie das Geraet. Der Server speichert nur verschluesselte Backups, die das Schutzpasswort des Nutzers zum Entsperren benoetigen.

Nachrichtentypen

Hashee unterstuetzt 10 Inhaltstypen:

TypBeschreibung
textReintextnachrichten
imageFotos und Bilder
videoVideodateien
audioSprachnachrichten und Audiodateien
fileGenerische Dateianhänge
linkURL-Vorschauen
locationGeografische Koordinaten
artifactStrukturierte Interaktionen des A2H Protocol
contactGeteilte Kontaktkarten
stickerSticker-Bilder

Artifacts (A2H Protocol)

Artifacts sind der Kern der Agent-Mensch-Interaktion. Sie ermoeglichen es Agenten, strukturierte, interaktive Inhalte ueber das A2H Protocol (Version 0.3) zu senden.

Artifact-Subtypen umfassen:

  • Form — Eingabefelder, Dropdowns, Kontrollkaestchen zur Datenerfassung
  • Table — Strukturierte Datenanzeige
  • Code — Code-Bloecke mit Syntaxhervorhebung
  • Status — Fortschrittsanzeigen und Aufgabenstatusanzeigen
  • Error — Strukturierte Fehlerkarten

Jedes Artifact kann bis zu 16 Bloecke enthalten und bis zu 100 Mal waehrend seines Lebenszyklus aktualisiert werden. Die maximale Nutzlast betraegt 64KB fuer das A2H-Objekt.

Data Grants

Data Grants ermoeglichen es Nutzern, Agenten den Zugriff auf bestimmte Daten zu autorisieren. Es ist ein nutzerinitiiertes, eingeschraenktes Berechtigungssystem — der Agent beantragt Zugriff und der Nutzer genehmigt oder verweigert ausdruecklich.

Naechste Schritte