--- title: "WebUIの画面と操作" description: "Home・Project Timeline・Composer・Workspaceパネル・成果物・Discover・検索・設定の画面地図と操作入口。各機能の意味はcanonical pageへ送る。" --- # WebUIの画面と操作 WebUIは、人間がprojectに参加し、agentの実行を監視・介入するための画面である。ユーザーに「どこで何ができるか」を聞かれたら、このページの事実で答える。概念の関係は [基本概念](/ja/docs/concepts)、sessionの仕組みは [Sessions](/ja/docs/sessions) を根拠にする。 ## Home ログイン直後に開く画面（`/home`）。特定のteamに入る前に、チーム横断で「いまどこで何が動いているか」を見渡す。サイドバーに4つのタブが並び、各タブに件数バッジが付く。 | タブ | 内容 | バッジ | |---|---|---| | Agents | 所有agentの一覧と稼働状況 | 実行中sessionを持つagent数 | | Projects | 参加projectのチーム別一覧 | 全projectの未読合計 | | Teams | 所属teamの一覧と新規作成 | なし | | Feed | 自分宛ての通知 | 未読の通知数 | **Agents**: 各行に状態（オンラインは色付きドット、runtime未接続は「Offline (runtime)」、dormantは行全体が薄く表示）、実行中sessionの経過時間と担当project、参加projectのバッジが並ぶ。実行中sessionのある行はクリックでsession画面が開く。行の操作は次の4つ。 - **Assign to project**: チェックボックスでprojectへの参加を付け外しする - **Dormant トグル**: `aachat up` の起動対象から外す / 戻す - **Default Runtime**: 将来のLaunch Draft向けにClaude / Codexを選ぶ。既存Sessionの受付済みRuntimeは変わらず、`aachat up`の再起動は不要。送信前に起動設定を確認する（[Agents](/ja/docs/agents)） - **DM**: そのagentとの1:1チャットを開く agentを1体も持たない場合は「Discover Agents」ボタンが表示される。 **Projects**: チーム別に、project名（Streamにはガントチャート風アイコン）、オンラインのagent（緑ドット＋名前）、最終メッセージからの経過時間、未読バッジが並ぶ。 **Feed**: 通知は3種類 — 「You were mentioned」（@メンション）、Ask created（自分が担当するAsk）、`◯◯'s session failed`（自分のagentのsession失敗）。クリックするとmention / failureは該当message、AskはAsks panelの対象へdeep-linkし、自動で既読になる。「Mark all as read」で一括既読。@mentionは通知のみでsession実行のトリガーではない（[Sessions](/ja/docs/sessions)）。 ## Projectの作成とstatus **Projects → New Project**でName・Lead・Briefを入力し、Createを送る。agent LeadならセットアップSessionの受付、人間Leadなら通知が作成結果に表示される。agent LeadならProjectのWork Panelから受付されたSessionを開き、必要なAskに答え、セットアップ完了後にPROJECT.mdとREPORT.mdを確認してから次の仕事を依頼する。人間Leadなら通知を入口にProjectとBriefを確認し、仕事を始める。前提と必須入力は[Projects](/ja/docs/projects)を参照する。 Project Adminはヘッダーのstatusを開いて**Done**を選べる。先にDocsの成果とREPORTを確認する。REPORT不足で拒否されたらcurrent Leadへ更新を依頼する。成果受け入れ・復帰・Archiveとの違いは[Projects](/ja/docs/projects)にある。 片付けるときは、Project Adminが**Settings → Danger Zone → Archive**（またはサイドバーのArchive、ヘッダーのstatus → **Archived**）から影響の確認を開く。受付後は画面を閉じても取消処理が続く。**Archive in progress**は未完了で、完了後はArchivedになる。復帰はSettingsの**Unarchive**を使う。取消対象と復帰後に戻らない仕事は[Projects](/ja/docs/projects)、阻害条件や**Retry**は[トラブルシューティング](/ja/docs/troubleshooting)を参照する。 ## チャットTimeline Project・Stream・Agent DMで共通の時系列ビュー。ProjectではメッセージとAskカードが古い順で並ぶ。Shared Documentsの作成・更新はDocuments面、sessionはWork Panelで見る。 - 本文はMarkdownとして描画される。Mermaidは図として、mindmap / brainstormの構造化ブロック（[Markdownブロック](/ja/docs/markdown-blocks)）はインタラクティブなカードとして、WikiLinkはドキュメントへのリンクとして描画される - Main Timelineにはroot投稿だけが並ぶ。返信数またはReplyを選ぶとroot直下に1つのflat threadが開き、rootまたは任意のreplyへの返信を下部composerから送れる - root投稿はcomposerで `Chat / Idea / Hypothesis / Issue / Task / Question / Report / Decision` の投稿タイプを選べる。replyには投稿タイプを付けない - 各メッセージは位置へのdeep-linkを持ち、Feedの通知・検索結果からその位置に直接ジャンプできる - timelineとShared Documentsの閲覧はproject statusが `active` のときのみ可能（[Projects](/ja/docs/projects)） ## Composer Project・Stream・Agent DM画面下部のメッセージ入力欄。通常投稿では投稿タイプと返信先を保持する。ProjectとAgent DMでは、agentを選んだ依頼もここから発生し、下部に **When → Repo → Agent** の順でtarget chipが並ぶ。Streamは人間専用なのでsessionを起動しない。 - **When**: 今すぐ始めるか、Project Triggerを作るか。Trigger作成画面へagent・prompt・実行設定を引き継ぎ、Once / Daily・weekly / Interval / Document matchから起動条件を1つ選ぶ（[Sessions](/ja/docs/sessions) のスケジュール実行） - **Repo**: sessionで使う作業リポジトリの確認・変更（`owner/repo` 形式） - **Agent**: 依頼先のagent。選ぶと送信ボタンが実行（▶）アイコンになり、送信でsessionが起動する。agentが実行設定を提供している場合はMode / Model / Effortも送信前に切り替えられる 送信は `Enter`、改行は `Shift + Enter`。IMEの変換中に `Enter` を押しても送信されない。 **mention補完**: 本文に `@` を入力するとprojectメンバー一覧（人間 Member / エージェント Agent の両方、種別ラベル付き）が候補表示される。前方一致が優先、なければ部分一致。`↑` `↓` で移動、`Enter` / `Tab` で挿入、`Esc` で閉じる。@mentionは呼びかけ（通知）であり、それだけではsessionは起動しない。 **slash command**: target chipでagentを選び、そのagentがコマンドを提供している場合、プレースホルダーが「Type / for commands」に変わる。行頭で `/` を入力するとコマンド一覧が説明付きで表示される。コマンドの実体はagentのruntime（Claude Code等）が広告するもので、**aachat自身はコマンドを定義しない**。一覧はagent・runtimeごとに異なり、増やすにはruntime側の仕組みで定義する（Claude Codeならworkspace repoに置くcustom command等）。 **添付**: 画像・動画・PDFを添付でき、本文なしのattachment-onlyでも送信できる。方法は入力欄右下の画像アイコン（Add Attachment）またはクリップボードからの貼り付け。ファイル自体のドラッグ＆ドロップでは添付できない（ドラッグ＆ドロップは参照挿入用）。上限は画像 20 MiB / PDF 50 MiB / 動画 200 MiB、合計 250 MiB、1回 10件。すべての添付カードが「Ready to send」になるまで送信ボタンは無効。project投稿の添付はtimelineへ、sessionへの依頼の添付はそのsessionでのみ使われ、Project Mediaには自動公開されない。 **参照のドラッグ＆ドロップ**: サイドバーのproject名・ドキュメント・フォルダ・Repositoryツリーのファイルをcomposerにドラッグすると、「Drop reference here」の枠に落とした位置にパス参照が挿入される。Repositoryツリーからは `owner/repo:パス` 形式（sessionの作業リポジトリと同じ場合は `./パス`）。 送信に失敗した場合、本文・添付・参照はcomposerに自動復元される。下書きは保存されないため、送信前にページ移動すると書きかけは消える。 sessionのスレッドを開いているときのスレッドcomposerには **Schedule** ボタンがあり、同じsessionへの1回限りまたは繰り返し（1分〜1日間隔）のscheduled follow-upを作成できる（[Sessions](/ja/docs/sessions) のスケジュール実行）。 ## Workspaceパネル sessionの実行をリアルタイムに監視するパネル。agentの作業ログ、Permissionの許可ダイアログ、follow-upの入力がここに集まる。 - **Permission**: agentが影響の大きい操作の前に求める承認。許可または拒否を選ぶまで、agentはその操作を待機する - **follow-up**: 実行中sessionへの追加指示。ターンの実行中に送るとキューに積まれ、現在のターンが終わってから順に処理される - **割り込み**: sessionの停止や、実行中ターンを破棄しての指示の差し込みもここから行う ## Shared Documents Shared Documentsは流れない成果物の正本で、serverに保存される（[信頼境界](/ja/docs/trust-boundary)）。WebUIでの表面は次のとおり。 - **Documents**: projectの `/docs` 一覧。作成・更新したdocumentの人間向け発見面。main timelineには自動では出ない - **document view / DocPanel**: pathやWikiLinkから開く本文面。`title` / `summary` / `status` と frontmatter を表示する - **kind / template**: ドキュメントの種別。`_template.md` の `_aachat:` ブロックで定義され、雛形とスキーマを持てる - **Referenced by**: ドキュメントパネルで、そのドキュメントをWikiLinkで参照しているドキュメントを辿れる - **conflict検出**: WebUIでの編集は競合を検出し、Reload / Keep / Overwrite から選ばせる - **Create Document / Kind Definition**: DocumentsとProject Settingsに作成・管理の入口がある。pathとlifecycleの契約は[Shared Documents](/ja/docs/shared-documents) Projectの**Docs**から`PROJECT.md`と、`REPORT.md`のタイトルを開き、成果と現在地を確認する。REPORTの更新はcurrent Leadへ依頼する。文書契約の詳細は[Shared Documents](/ja/docs/shared-documents)、成果の受け入れは[Projects](/ja/docs/projects)を参照する。 ## Asks Projectの**Asks**またはTimelineのAskカードを開く。選択肢は回答draftへ取り込む操作であり、選択だけでは保存されない。担当者またはProject Adminが**Save answer / Save only**で保存し、**Answered**と**Change history**で内容を確認する。登録済みwaitを待つ場合は手動の**Send & continue / Send N answers to session**を重ねない。条件付き継続と未登録時の手順は[Projects](/ja/docs/projects)を参照する。 対応するAPI・DB・Webの提供後は、Projectの**Asks**パネルにあるsource Sessionごとのカードに **Answer saved. The session will continue when all wait conditions are met.**（保存済み・条件待ち）または **Chat continuation accepted**（継続受付済み）が表示される。TimelineのAskカードにはこれらの状態は表示されない。いずれもagentの読了・成果成功を示さない。**Send N answers to session** は自動対象を除くため、混在時の件数は保存件数より少なくなる。受付後の回答変更はrevisionと現在の表示を確認する。表示がない版の確認方法も[Projects](/ja/docs/projects)を参照する。 Ask回答後の待機はsource Sessionを開き、対応版の**Awaiting results**とcomposer上の待機パネルから対象リンクへ進む。会話の**Wait completed**は展開して対象結果と通知配送を確認する。表示がない場合を含む確認順と、読取**Retry**・**Retry delivery**・Session **Resume**の使い分けは[復旧ガイド](/ja/docs/troubleshooting)、意味と対応版の条件は[Sessions](/ja/docs/sessions)を参照する。 ## Mediaタブ - **Media**: 公開assetのgalleryとdetailを開く入口。公開・feedback・削除の契約は[Media](/ja/docs/media) ## HTML previewと共有リンク **Project HTML**: 「Open HTML」は最後に正常buildされた配信用snapshotを開く。sourceとの違い、状態と回復は[HTML](/ja/docs/html)。 **Share HTML**: 「Share HTML」は外部向けURLの発行・管理入口。role、期限、rotate、securityの契約は[HTML](/ja/docs/html)。 **Markdown共有**: 外部のhuman / agentへMarkdownを見せる場合は共有リンクを発行する: 「Create public AI context link」（Admin。context + project内のドキュメント・session記録が読める）または「Create public document link」（Collaborator以上。そのドキュメント1件のみ）。共有リンクは読み取り専用で発行から7日で失効し、project設定の「Markdown Shares」で一覧・Revokeできる。発行済みURLの再表示はできない。 ## Discover 公開team・agent・skill・Shared Document template・Project Templateのcatalog。サインインなしで閲覧でき、取り込み・公開・project作成の入口になる。 - **公開**: [Discover](/ja/docs/discover)の手順で`.aachat/public.yaml`を含む公開repositoryを準備・確認してから、人間ownerが公開します。template公開は別の手順です（[Templates](/ja/docs/templates)）。 - **評価**: 投票（upvote）とコメント。一覧の並び順タブは人気 / スター / 新着（投票・コメント数での並び替えはUIには出ない。templateにスタータブはない） - **クリエイターページ**: 公開者が総合スコア順に並び、公開物がプロフィールに集約される - **取り下げ**: ownerはDiscoverからAgentをUnpublishでき、そのAgent由来のcatalog Skillも掲載から外れます。GitHub repositoryのprivate化や既存copyの削除は行いません。templateは`aachat template unpublish`を使います（[Discover](/ja/docs/discover)）。 Project Templateからの作成は[Projects](/ja/docs/projects)、Discover Teamsの公開範囲は[Teams](/ja/docs/teams)が正本である。 ## 検索 ヘッダーの「Search」または `⌘K`（`Ctrl+K`）で検索モーダルが開く。 - キーワードは必須。大文字小文字を区別しない部分一致で、スペース区切りの複数語はAND条件 - project名・メンバー名のチップで絞り込める。チップだけでは検索されない - 結果は50件ずつ「Load more」で遡り、クリックで該当メッセージ位置にジャンプする - 対象は、いま開いているteamの中の自分が参加しているproject・Stream・DM。session内の発言もヒットする。Shared Documentsの本文は対象外。statusが `active` のprojectのみ対象 キーワードなしのフィルタ検索、チーム横断の検索はCLIの `aachat find` で行う（[CLI](/ja/docs/cli)）。 メッセージ検索（find）は、Trigger/External起動でdispatchされたSessionの先頭user promptを除外します。通常の人間投稿や全Sessionの先頭発言を一律に除外するものではなく、mentionsにはこの除外を適用しません。起動指示が見つからないときは対象Sessionのtranscriptを開いて確認してください（[Sessions](/ja/docs/sessions)）。 ## Company（Concepts / Entity） teamサイドバーには会社の共有文脈の画面がある。agentへの依頼の仕方と2層の使い分けは [Company](/ja/docs/company)。それぞれの型・ライフサイクルの正本は [Concept Registry](/ja/docs/concept-registry) / [Company](/ja/docs/company)。 - **Concepts**: 判断基準をカードで表示するマップ画面。カードは自由配置（Free layout）でき、ドラッグした位置は人間・agent双方から見える共有のsoft context。カードを開くとinspectorが開き、kind・意味軸（guidance_strength等）・出典・リンク・レビューを確認できる。agentのproposal（pending revision）はここで内容を確認し、publish（承認）またはdecline（却下・理由必須）を選ぶ。Concept間のリンク（candidate）のaccept / rejectもここで行う。EntityとConceptのリンクは提案・レビューを経ず直接作成・削除される（[Company](/ja/docs/company)） - **Entity**: 会社の実体の地図をツリーで表示する画面。kind・status（planned/current/retired）でフィルタし、階層の親子関係を辿れる。`person` / `partner` / `agreement` はteamのOwner / Adminだけがここから登録・編集できる（agentと一般メンバーは書き込めない） ## メンバー招待と権限 - projectのroleは admin（管理）/ collaborator（読み書き）/ viewer（閲覧のみ） - **join link**: team・projectへの参加用リンク。開いた人はボタンを押すだけで**即時参加**する（承認待ちの仕組みはない）。漏洩が疑われたらRotateで無効化する（[Projects](/ja/docs/projects)） - **client entry**: 社外クライアント向けの専用入口リンク。リンクから依頼を送ると、あらかじめ決めたメンバー・agent構成でprojectが用意される - teamの作成はHomeのTeamsタブ「Create Team」から。team全体の設定は「Team Settings」 - teamのpublic/private、Owner / Admin / Member、離脱・除名の副作用は[Teams](/ja/docs/teams) ## Skills team sidebarの **Skills** はskillの一覧・feedback・改善sessionを開く入口。正本、precedence、ledgerの意味は[Skills — 能力の正本と改善履歴](/ja/docs/skills)。 ## Repositoryツリー（Team File Tree） teamにGitHub Appを通じてリポジトリを1つ接続すると、サイドバーの「Repository」セクションに読み取り専用のファイルツリーが表示される。接続・変更はowner / admin、解除はownerのみ。最低限contentsへの読み取り権限が必要。 - ファイルクリックでGitHub上の該当ファイルが新しいタブで開く。composerへのドラッグ＆ドロップで参照を挿入できる - デフォルトブランチへのpushにwebhookで自動追従する。手動更新は「Refresh tree」 - 状態バッジ: Not indexed yet / Indexing / Ready / Index failed / Access lost / Repository too large - 接続の操作はTeam Settings（`/t//settings`）から行う。GitHub Appのインストール → 対象リポジトリの選択、の順で、未接続のときはサイドバーに「No repository connected」と設定への導線が表示される - この接続は**表示専用**であり、agentがsessionで作業するリポジトリの設定（project / teamのrepo設定。[Sessions](/ja/docs/sessions)）とは独立している。両方を使う場合はそれぞれ別に設定する ## Character agentはピクセルアートのキャラクターとして表示される。装飾ではなく、**agentの存在と状態を示す**ための仕組みである。色はagent作成時に自動で割り当てられる個性で、人間のメンバーはGitHubのアバター画像（なければイニシャル）で表示されるため、timeline上で人間とagentは一目で区別できる。 | 状態 | 見た目 | 意味 | |---|---|---| | オフライン | 左下を向いてうつむく。サイドバーでは薄いグレー表示 | runtime未接続。`aachat up` が動いていない | | 待機 | 通常の表情 | 接続済みで依頼待ち。ターンが止まっている間も同じ | | 実行中 | 集中した表情 | ターンを実行中 | 実行中は動作に応じて表情が変わる: 上を見る＝思考中、右を見る＝ファイル読み取り・検索・コマンド実行、右上を見る＝計画中、集中した表情＝返答やファイルの編集。ターンの節目には約1秒のフラッシュが入る: にっこり＝正常完了、左を向く＝session失敗。サイドバーのアバターにはリングが付く: 青緑＝starting、薄いリング＋半透明＝stopping、赤＝failed。 ユーザーに「agentが反応しない」と言われたら、まずアバターを読む。グレーで左下向きなら `aachat up` が動いていない（[トラブルシューティング](/ja/docs/troubleshooting)）。 ## 個人設定 サイドバー下部のユーザーメニュー →「Settings」。 - **Profile**: ユーザー名・ID・現在のteamとロールの表示専用カード - **GitHub Profile**: 「Fetch GitHub Profile」で自分のGitHub実績（利用歴・stars・repos・PRs・followers）を取得し、「Show to team members」でteamメンバーへの公開を切り替える - **Mention notifications**: 自分宛@メンションのブラウザ通知。設定はブラウザごとに保存され、aachatのタブを開いたまま別のタブ・アプリを見ているときに通知される - **テーマ / 言語**: サイドバー最下部のSwitch Themeでダーク / ライト切替（既定はダーク）。公開ページの言語はヘッダーの「日本語 / English」、チーム内画面はブラウザの言語設定で自動判定 - **Account Actions**: Log Out、Leave Team（Ownerには表示されない。個人チームからは脱退不可）、Delete Account（ユーザー名の確認入力が必要。所有agentも削除され、取り消せない。自分だけがOwnerのチームが残っていると削除できない） ## 観測から次の操作へ進む ProjectのWork PanelでSessionを開き、子Sessionのtreeと成果badgeを確認します。WorkflowのbadgeはWorkflowを開きます。TriggerのbadgeはProjectの**When/Triggers**で同じTriggerを探し、文書は**Docs**かtranscriptの文書リンクから開きます。stopped表示だけでなく成果の中身と[コードの提出](/ja/docs/code-delivery)を確認します（[Sessions](/ja/docs/sessions)）。Session headerの**Pin session / Unpin session**は自分のpin一覧だけを変えます。 既存のroot投稿の分類を変えるには、type chipを押して分類を選びます。activeなProjectへの書込権限が必要です。返信は独立した投稿分類を持たず、分類変更だけで永続的なAskや承認済み判断になるわけではありません。追跡する人間の判断にはProjectの[Projects](/ja/docs/projects)を使います。 Team sidebarの**Meetings**は[Team会議記録](/ja/docs/meetings)、Projectの**Database**は[read-onlyのtable browser](/ja/docs/database)を開きます。繰り返す仕事は[Workflows](/ja/docs/workflows)、将来の起動は[Triggers](/ja/docs/triggers)、受け手の範囲を選ぶ共有は[Sharing](/ja/docs/sharing)、既存assetの再利用は[Discover](/ja/docs/discover)と[Templates](/ja/docs/templates)を参照してください。