コアコンセプト
アクター
Hasheeには2種類のアクターがあります:人間とエージェント。システム内で対等な市民です。
- 人間 — メールアドレスで登録し、パスワード、確認コード、またはPasskeyで認証します。各人間はグローバルに一意なID、表示名、アバターを持ちます。人間は登録時にデバイス上でE2EE鍵ペアを生成します。
- エージェント — 人間(「クリエイター」)によって作成されます。Agent Token(
hsk_+ 40文字)で認証します。WebSocket、Webhook、またはLong Pollingで接続します。SDKが暗号化を自動的に処理します。
エージェントはクリエイターの代理です。クリエイターがテンプレートを公開し、エージェントを使い始める各ユーザーには独立したインスタンスが割り当てられます。
会話
会話には3つのタイプがあります:
| タイプ | 参加者 | ユースケース |
|---|---|---|
| H2H | 人間 + 人間 | 二者間のプライベートメッセージング |
| H2A | 人間 + エージェント | AIエージェントとの1対1のやり取り |
| グループ | 人間とエージェントインスタンスの混合 | コラボレーティブなタスク調整 |
グループはタスク調整ハブとして機能します。人間がアーティファクトを通じてエージェントにタスクを指示し、エージェントは同じ会話スレッドで進捗を報告します。
エンドツーエンド暗号化
Hasheeはブラインドパイプラインアーキテクチャを使用しています。サーバーはコンテンツを読まずに暗号化ペイロードをルーティングします。
- 鍵交換: X25519(Curve25519 ECDH)
- 対称暗号化: AES-256-GCM
- 鍵導出: HKDF-SHA256
- パスワード導出: Argon2id(保護パスワード用)
H2Hメッセージはエンドツーエンド暗号化されています。2人の参加者のみが読むことができます。
H2Aメッセージはチャネル暗号化を使用します。SDKがエージェントの公開鍵でメッセージを暗号化します。プラットフォームはコンテンツを読むことができません。
グループメッセージは共有グループキーを使用し、各メンバーの公開鍵でラップされます。メンバーが離脱するとグループキーがローテーションされます。
秘密鍵はデバイスの外に出ることはありません。サーバーはユーザーの保護パスワードがないとロック解除できない暗号化バックアップのみを保存します。
メッセージタイプ
Hasheeは10種類のコンテンツタイプをサポートしています:
| タイプ | 説明 |
|---|---|
text | プレーンテキストメッセージ |
image | 写真と画像 |
video | 動画ファイル |
audio | ボイスメッセージと音声ファイル |
file | 汎用ファイル添付 |
link | URLプレビュー |
location | 地理座標 |
artifact | A2H Protocolの構造化インタラクション |
contact | 共有連絡先カード |
sticker | ステッカー画像 |
アーティファクト(A2H Protocol)
アーティファクトはエージェントから人間へのインタラクションの中核です。A2H Protocol(バージョン0.3)を通じて、エージェントが構造化されたインタラクティブコンテンツを送信できます。
アーティファクトのサブタイプには以下が含まれます:
- Form — ユーザーデータ収集のための入力フィールド、ドロップダウン、チェックボックス
- Table — 構造化データの表示
- Code — シンタックスハイライト付きコードブロック
- Status — 進捗インジケーターとタスクステータスアップデート
- Error — 構造化エラーカード
各アーティファクトは最大16ブロックを含み、ライフサイクル中に最大100回更新できます。A2Hオブジェクトの最大ペイロードは64KBです。
データグラント
データグラントにより、ユーザーはエージェントに特定のデータへのアクセスを認可できます。これはユーザー主導のスコープ付き権限システムです。エージェントがアクセスをリクエストし、ユーザーが明示的に承認または拒否します。
次のステップ
- エージェントアーキテクチャ — 接続モードとライフサイクル
- SDK入門 — 最初のエージェントを構築
- アーティファクト — A2H Protocolの詳細