用語集

このページは、Hane のドキュメント・コンソール・API で使う言葉の一覧です。同じ概念はいつも同じ言葉で書いているので、読んでいて迷ったときに引いてください。英語の列は、英語のドキュメントと API で使う言葉です。

組織と利用者

言葉	英語	意味
組織	organization	Hane を契約する単位。データと権限はここで分かれます
プロジェクト	project	組織の中で、定義とデータを分ける単位
環境	environment	同じプロジェクトの開発・検証・本番（dev・stage・prod）
利用者	user	ログインする人
メンバー	member	組織に属する利用者。ロールとグループを持ちます
元の主体	principal	操作を頼んだ人またはサービスアカウント
実行主体	actor	実際に呼んだもの（顧客アプリのサービスアカウントなど）
サービスアカウント	service account	人でない呼出し元
API キー	API key	サービスアカウントの資格情報。値は発行したときに一度だけ表示します
アクセストークン	access token	トークン交換で Hane が発行する短命の資格情報
ロールの割り当て	role binding	マニフェストで人・グループ・サービスアカウントにロールを足す設定
権限の世代	policy epoch	ロール・グループ・鍵が変わるたびに上がる数。古い世代のトークンは拒否します
緊急停止	suspension	組織の操作をすべて止めること。解除は owner だけ
失効	revoke	API キーを使えなくすること
運営者の委任	operator engagement	提供側の運営者が顧客のプロジェクトで働く根拠。範囲と期間は顧客の管理者が決めます

定義とリリース

言葉	英語	意味
マニフェスト	manifest	Git に置く定義の YAML
定義	definition	まとめて有効にするもの（型・規則・Workflow・Agent など）
draft	draft	apply したが、まだ有効でない定義
apply	apply	マニフェストを draft にすること
定義のバージョン	revision	1 つの定義を apply するたびに増える番号
ReleaseBundle	ReleaseBundle	定義のバージョンの組。中身は変えません
有効なバージョン	active release	いま動いている ReleaseBundle
有効化	activate	ReleaseBundle を有効なバージョンにすること
昇格	promote	ReleaseBundle を dev から stage・prod へ送ること
戻す	rollback	前の ReleaseBundle を有効にし直すこと

データと文書

言葉	英語	意味
レコード	record	型に従う業務データの 1 件
型	type	レコードの種類（車両・契約など）
項目	field	型が持つ値の名前
関係	relation	レコードとレコードのつながり
値の状態	value state	値をどこまで確かめたか。確定・推定・要照会・不明の 4 つ
出典	source	値がどこから来たか（取り込み・人・計算・文書・外部）
取り込み	import	CSV などからレコードを作る・更新すること
文書	document	原本のファイルと、そのバージョン
抽出の候補	extracted fact	文書から抜き出した項目の値で、人がまだ確かめていないもの。ページと引用を持ちます
書類の種類	document type	混ざって届いた文書を、契約書・請求書などに分けるときの種類
派生物	derivative	文書から作ったもの（変換した PDF・本文・検索の索引・要約など）。削除の追跡の単位
hold	hold	文書か連絡先を消さずに残す指定
削除の追跡	disposal	削除を受け付けてから、派生物ごとに消したか・残しているかを記録したもの
業務の知識	business knowledge	出典と確からしさ付きで定義に持つ知識（Axiom と観点）
観点	aspect	レコードに当てる決定的な判断の規則
所見	finding	観点の規則が検出した結果
評価セット	eval set	人が確かめた書類を伏せた複製にして集めたもの。抽出の定義を読み比べるのに使います（Agent の EvalSuite とは別）

Workflow と承認

言葉	英語	意味
Workflow	workflow	案件の進め方の定義
案件	case	Workflow で進める 1 件の仕事
ステップ	step	Workflow の 1 段
Task	task	人が決める・作業する 1 件
担当	assignee	Task を決められる人またはグループ
割り当て	assignment	担当を決める規則
承認	approval	決定者が digest に結び付けて決めること
決定者	decider	承認を決めてよいもの。人・審査用の Agent・事前に承認したポリシー
DeciderPolicy	decider policy	操作と条件ごとに、決定者と承認の段を決める定義
承認の対象	approval subject	承認で決める操作の中身。サーバーが固定した snapshot を出します
スケジュール	schedule	決めた時刻に Workflow や Agent を動かす定義
購読	event subscription	顧客のシステムへイベントを届ける宛先と種類の登録
webhook の配信	webhook delivery	1 つのイベントを 1 つの購読へ届けること

Agent

言葉	英語	意味
Agent	agent	目的・ツール・上限・入出力の Schema を持つ定義
AgentRun	AgentRun	Agent を 1 回動かした記録
ドライバー	driver	Agent を何で動かすか（台本・モデル・CLI）
Tool Gateway	Tool Gateway	Agent がツールを呼ぶ唯一の口。呼出しのたびに許可と状態を確かめます
Model Gateway	Model Gateway	Agent と Hane Cowork がモデルを呼ぶ口。許したモデルと予算を確かめ、呼出しを記録します
ActionRequest	ActionRequest	外への操作の提案。宛先と内容を固定し、承認の後に一度だけ実行します
受付	reception	頼んだ人の自由な文から、頼む Agent と入力を決める口
会話	conversation	Hane の中で、チャットの Agent に自然文で頼むやり取り
チャットの Agent	chat agent	チャットのすべてのメッセージを受け、必要なときに業務の Agent を呼ぶ Agent
審査用の Agent	review agent	提案のたびに起動し、承認・却下・人への引き上げを返す Agent
EvalSuite	EvalSuite	Agent の評価の定義。入力と期待する結果の組を並べ、shadow で動かして比べます
予算の予約	budget reservation	実行を作るときに、使える最大のトークンを 1 日の予算から先に取っておくこと

外部連携と連絡

言葉	英語	意味
Route	route	公開 API の入口から、登録した顧客の API へ要求を渡す経路
PublishedApi	published API	Route の上で公開する顧客の API
Consumer	consumer	PublishedApi を呼ぶ側
ToolExposure	tool exposure	PublishedApi の操作を 1 つ Agent のツールにする宣言
秘密値を回す	rotate a secret	接続の秘密値を新しい値に替え、古い値を失効させること
Communication	communication	メールなどの通知と連絡を送るサービス
通知	notification	Workflow から送る知らせ
連絡先	contact endpoint	連絡する相手の番号かアドレスと、使ってよい目的・停止の記録
停止の申出	stop request	相手が今後の連絡を断ること
送信の名義	sender identity	誰の名義でメール・SMS・電話を送るかの定義
AI 電話	AI call	承認を通して、会話 Agent が確認事項の範囲で相手と話す電話
確認事項	call brief	AI 電話で話してよい内容。承認の対象に固定します
引き継ぎ	handoff	ポータルの手順が止まったとき、人に操作を代わってもらうこと
ランナー	browser runner	顧客のネットワークや社員の端末で、ポータルの手順を動かすもの

次に読む

主な概念

よくある質問