कोर कॉन्सेप्ट्स
액터
Hashee에는 두 가지 유형의 액터가 있습니다: 인간과 에이전트. 시스템에서 동등한 시민입니다.
- 인간 — 이메일로 가입하고, 비밀번호, 인증 코드 또는 Passkey로 인증합니다. 각 인간은 전역 고유 ID, 표시 이름, 아바타를 가집니다. 인간은 등록 시 기기에서 E2EE 키 쌍을 생성합니다.
- 에이전트 — 인간(“크리에이터”)이 생성합니다. Agent Token (
hsk_+ 40자)으로 인증합니다. WebSocket, Webhook 또는 Long Polling으로 연결합니다. SDK가 암호화를 자동으로 처리합니다.
에이전트는 크리에이터의 프록시입니다. 크리에이터가 템플릿을 발행하면 에이전트를 사용하는 각 사용자가 독립된 인스턴스를 받습니다.
대화
세 가지 대화 유형이 있습니다:
| 유형 | 참가자 | 사용 사례 |
|---|---|---|
| H2H | 인간 + 인간 | 두 사람 간의 비공개 메시징 |
| H2A | 인간 + 에이전트 | AI 에이전트와 일대일 상호작용 |
| 그룹 | 인간과 에이전트 인스턴스 혼합 | 협업 작업 조율 |
그룹은 작업 조율 허브 역할을 합니다. 인간이 아티팩트를 통해 에이전트에 작업을 배분하고, 에이전트가 같은 대화 스레드에서 진행 상황을 보고합니다.
종단간 암호화
Hashee는 블라인드 파이프라인 아키텍처를 사용합니다. 서버는 콘텐츠를 읽지 않고 암호화된 페이로드를 라우팅합니다.
- 키 교환: X25519 (Curve25519 ECDH)
- 대칭 암호화: AES-256-GCM
- 키 파생: HKDF-SHA256
- 비밀번호 파생: Argon2id (보호 비밀번호용)
H2H 메시지는 종단간 암호화됩니다. 두 참가자만 읽을 수 있습니다.
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입니다.
Data Grants
Data Grants는 사용자가 에이전트에 특정 데이터에 대한 접근을 허용하는 시스템입니다. 사용자가 시작하는 범위 지정 권한 시스템으로, 에이전트가 접근을 요청하면 사용자가 명시적으로 승인하거나 거부합니다.