lark-meeting は何をしますか？
飛書ビデオ会議業務の統一エントリポイント。会議記録の照会、リアルタイム会議のインタラクション、妙記の管理、スマート要約の読み取りなどの操作をサポートします。このスキルでは、ドメインの関係、タスクルーティング、およびクロスコマンドのオーケストレーションを担当します。
lark-sharedの事前読み取りやauth status --verifyの事前実行は不要です。未認証、トークン/identity/スコープエラーが発生した場合にのみこのスキルを読み取り、修正後に再試行してください。認証、identity、またはスコープ管理リクエストは、このスキルを直接使用します。
初期化と継続
source_identity をクロスコマンドワークフローの状態として使用します：
- コンテキストにすでに source_identity がある場合：それを厳密に継続します。ユーザーが切り替えを要求した場合は、まず identity の継続性と権限への影響を説明し、静かに切り替えないでください。
- source_identity がなく、ユーザーが明示的に identity を指定した場合：ユーザー指定の
--asを使用します。 - source_identity がなく、ユーザーも指定していない場合：操作のセマンティクスがボットの適用を明確に要求する場合は
--as botを使用し、それ以外の場合は明示的に--as userを使用します。
source_identity を決定した後、ターゲットコマンドがその identity をサポートしているかを確認します：
- サポートしている場合：明示的に渡して実行を続行します。
- サポートしていない場合：制限を説明して停止します。コマンドを成功させるために identity を置き換えないでください。
- ユーザーが明示的に identity の切り替えに同意した場合のみ、新しい identity でワークフローを再開します。
ドメインモデルと概念
[会議ソース]
Calendar 予定 (event_id) ──予約または関連──┐
インスタント会議（event_id なし）──────────┴──► 会議 (meeting_id)
Calendar 予定 ──meeting_note────────────► Doc（ユーザー要約、AIスマート要約とは独立）
[会議アーティファクト]
会議 (meeting_id)
├── AI サマリ ──► Note スマート要約 (note_id)
│ ├── スマート要約ドキュメント ───────────► Doc (note_doc_token)
│ ├── 文字起こし
│ │ ├── normal ──────────────────────► Doc (verbatim_doc_token)
│ │ └── unified ──────────────────────► note +transcript（独立したDocではない）
│ └── 共有ドキュメント ──────────────────► Doc (shared_doc_tokens)
│
└── 録画 ──► Minutes 妙記 (minute_token)
├── AI プロダクト：Summary / Todo / Chapter / Keyword
├── Transcript（文字起こし、別名：「転写」「逐語録」「文字記録」）
└── 元の音声・動画
ローカル音声・動画 ─────────────────────────────► Minutes 妙記 (minute_token)
| オブジェクト | 主識別子 | 概念と関係 |
|---|---|---|
| Calendar 予定 | event_id | カレンダー上の予定。時間、参加者、会議室、RSVPを含み、VC会議を予約または関連付け可能。完全な会議記録ではありません。予定上の meeting_note はユーザーが手動でバインドしたDocであり、AIスマート要約とは無関係です。 |
| Meeting 会議 | meeting_id | 実際に発生したビデオ会議。Calendarから来る場合も、予定のないインスタント会議の場合もあります。会議のテーマ、時間、参加者のスナップショット、および会議中のイベントは会議データに属します。NoteとMinutesは、関連付けられる可能性のある会議後のアーティファクトです。 |
| Note スマート要約 | note_id | AI要約を有効にした後に形成される論理的なプロダクトコレクション。note_display_type によって、文字起こしの文字記録を取得する方法が異なります。 |
| Minutes 妙記 | minute_token | 会議の録画またはローカル音声・動画のアップロードによって生成されます。サマリ、ToDo、チャプター、キーワード、文字記録（別名：「転写」「逐語録」「文字記録」）、および元の音声・動画を含みます。VC会議に関連付けることも、独立して存在することもできます。 |
| Doc ドキュメント | Doc token | コンテンツの容器であり、会議の識別子ではありません。note_doc_token、shared_doc_tokens、および一部の verbatim_doc_token はDocを指します。Doc tokenを note_id や meeting_id として使用することはできません。 |
コア識別子
meeting_id：会議ID。長い数字の文字列。9桁の会議番号ではありません。meeting_no：会議番号。9桁の数字のみ。CLIパラメータ名は--meeting-number。minute_token：妙記トークン。小文字の英数字列。通常、妙記URL/minutes/<minute_token>から取得します。
上記の識別子はすべてそのまま文字列として渡し、互いに代用することはできません。
ドメイン不変条件
- NoteとMinutesは、それぞれAI要約と録画という独立した2つのパイプラインから生成されます。1つの会議に両方のタイプのアーティファクトが存在する場合、一方だけの場合、またはどちらもない場合があります。
note_idからminute_tokenの存在を推測できず、その逆も同様です。 - Minutesはローカルの音声・動画から直接生成される可能性があるため、必ずしも
meeting_idやCalendarevent_idに関連付けられているとは限りません。 - Calendarの
meeting_note、Noteのnote_id、Minutesのminute_token、およびさまざまなDoc tokenは異なるオブジェクトを識別するため、交換したり、他のドメインのコマンドに代入したり、一方から他方を逆算したりすることはできません。
クイックアクション
進行中の会議内容の照会
# 現在のユーザーが参加している会議
lark-cli vc +meeting-list-active --as user
# アプリケーションボットから見えるターゲットユーザーの会議
lark-cli vc +meeting-list-active --as bot --user-id <open_id>
# 一意の meeting_id を特定したら、source_identity を引き継ぐ
lark-cli vc +meeting-events --as <source_identity> --meeting-id <meeting_id> --page-all --format pretty
同時に複数の会議がある場合は、まず照会する会議を選択する必要があります。会議が1つだけの場合は、その会議の会議イベントを直接照会します。
アプリケーション identity は、「ターゲットユーザーが会議に参加しており、かつアプリケーションボットも同じ会議に参加している」会議のみを返します。空の結果は、ターゲットユーザーが会議中でないことを意味するわけではありません。結果を説明するときは、「ユーザーidentity」または「アプリケーションidentity」を使用し、user / bot などの内部的な略語は公開しないでください。
シナリオハンドブック
タスクの目的がシナリオと一致する場合は、対応するシナリオハンドブックを読み、フローに従ってタスクを実行してください。
- 会議とそのアーティファクトの照会：テーマ、時間、参加者、または
meeting_id/meeting_no/event_idで履歴会議を特定します。参加者、録画、会議に関連するスマート要約や妙記を照会します。会議記録に基づいて要約や振り返りを行います。 - 妙記とそのアーティファクトの照会：妙記URL /
minute_tokenがすでにある場合、またはタイトル、所有者、参加者で妙記を検索します。サマリ、ToDo、チャプター、キーワード、文字起こしを読み取り、元の音声・動画をダウンロードし、または関連するスマート要約を照会します。 - 妙記の生成と編集、妙記権限の管理：ローカルの音声・動画から妙記、文字起こし、サマリ、ToDo、チャプターを生成します。妙記のタイトル、サマリ、ToDo、キーワード、話者を変更します。妙記の閲覧または編集権限を申請し、または妙記のコラボレーターの権限を表示・割り当てます。
- スマート要約と関連アーティファクトの照会：
note_id、スマート要約Docx URL/token がすでにある場合、または要約本文、文字起こし、妙記、共有ドキュメントなどの関連アーティファクトを照会する必要がある場合。 - アプリケーションボットの会議参加と会議中インタラクション：アプリケーションボットのアクティブな会議の発見、開始または参加、招待、イベントの取得、会議のスクリーンショット、テキスト/絵文字/カウントダウンインタラクション、会議の終了、および明確な承認後の退会を完全にオーケストレーションします。
- 会議中のイベントとインタラクション：新しい入会/退会操作をトリガーせずに、ユーザーidentityまたはすでに会議に参加しているアプリケーションidentityを使用して、アクティブな会議を照会し、発言/チャット/共有コンテンツを表示し、必要に応じて現在の会議画面を読み取り、テキスト/絵文字を送信し、カウントダウンを操作します。
コマンドリファレンス
| コマンド | 用途 | 参照方法 |
|---|---|---|
vc +search | 履歴会議の検索 | lark-vc-search |
vc +detail | 会議情報と関連するNote、Minutes識別子の照会 | lark-vc-detail |
vc meeting get | 会議の基本情報と参加者スナップショットの照会 | lark-cli vc meeting get --help |
vc +recording | 会議から録画と妙記の特定 | lark-vc-recording |
vc +meeting-list-active | 現在表示可能な進行中の会議の検出 | lark-vc-meeting-list-active |
vc +meeting-events | 会議中のイベントと共有コンテンツの読み取り | lark-vc-meeting-events |
vc +meeting-message-send | 会議中のテキストメッセージまたは絵文字の送信 | lark-vc-meeting-message-send |
vc +meeting-screenshot | ビデオ会議のスクリーンショット取得 | lark-vc-meeting-screenshot |
vc +meeting-countdown | 会議中のカウントダウンの設定、延長、早期終了、またはクローズ | lark-vc-meeting-countdown |
vc +meeting-join | アプリケーションボットに会議へ参加させる | lark-vc-agent-meeting-join |
vc +meeting-invite | アプリケーションボットとして、指定ユーザーまたは全該当予定参加者を招待 | lark-vc-agent-meeting-invite |
vc +meeting-end | 現在のHostアプリケーションボットに会議を終了させる | lark-vc-agent-meeting-end |
vc +meeting-leave | アプリケーションボットに会議から退室させる | lark-vc-agent-meeting-leave |
minutes +search | 妙記の検索 | lark-minutes-search |
minutes minutes get | 妙記の基本情報の照会 | lark-cli minutes minutes get --help |
minutes +detail | 妙記情報と指定アーティファクトの読み取り | lark-minutes-detail |
minutes +download | 妙記の元の音声・動画のダウンロード | lark-minutes-download |
minutes +upload | クラウドスペースの音声・動画から妙記を生成 | lark-minutes-upload |
minutes +update | 妙記のタイトル変更 | lark-minutes-update |
minutes +speaker-replace | 妙記の文字起こしの話者を置換 | lark-minutes-speaker-replace |
minutes +summary | 妙記のAIサマリを置換 | lark-minutes-summary |
minutes +todo | 妙記のAI ToDoの追加・削除・変更 | lark-minutes-todo |
minutes +apply-permission | 妙記の閲覧または編集権限の申請 | lark-minutes-apply-permission |
drive +member-list | 妙記のコラボレーターとその権限の表示 | lark-drive-member-list |
drive +member-add | 指定メンバーに妙記の閲覧または編集権限を割り当て | lark-drive-member-add |
minutes +word-replace | 妙記の文字起こしのキーワードを一括置換 | lark-cli minutes +word-replace --help |
note +detail | スマート要約と関連ドキュメント識別子の照会 | lark-note-detail |
note +transcript | unified スマート要約の文字起こしを取得 | lark-note-transcript |
プログレッシブローディングルール
「クイックアクション → シナリオハンドブック → コマンドリファレンス」の順で段階的に読み込みます：
- ユーザーの目標が「クイックアクション」の条件に合致する場合、対応するCLIを直接実行します。シナリオハンドブック、コマンドリファレンス、
--help、スキーマを事前に読み込まないでください。 - クイックアクションの条件に合致しない場合、または重要な識別子が不足している、曖昧性解消が必要、書き込み操作が含まれる場合、目標に一致する1つのメインシナリオハンドブックを読み込みます。メインシナリオが下流のシナリオに明確に委譲する場合、参照されているシナリオまたはセクションのみを読み込み続け、そのフローに従ってCLIを実行します。
- 特定のパラメータ、戻り値のフィールド、特別な制約、または例外処理方法が不足している場合のみ：リファレンスマニュアルがあるコマンドは対応するファイルを読み込みます。リファレンスマニュアルがないコマンドは、表に記載されている正確な
lark-cli ... --helpを実行します。シナリオまたはリファレンスが正確なコマンドをすでに提供している場合は、--helpを呼び出さないでください。パラメータが不足している、コマンドが認識されない、またはドキュメントと実行結果が矛盾する場合にのみ呼び出します。