Documentation

ドキュメント

セットアップから日々の使い方、トラブルシューティング、Skill 一覧まで。

はじめに(5 分セットアップ)

Lark にログインしてワンクリック認証。全機能 (calendar / mail / docs / bitable / tasks) を一回の同意で有効化できます。

メール返信ドラフト

Lark Mail のメールを Bot に転送するだけ。自動検知 → 丁寧な返信文をチャットに直接返却 → [💾 Mail下書きに保存] で Mail に書き戻し。

→ 使い方

予定カード × 商談前リサーチ

毎日 18 時に翌日アジェンダ Card を DM 配信。商談予定には「🎯 商談前リサーチ」ボタン付き。Bot メニュー「📆 予定」からも即時取得可。

→ 使い方

SD 商談前リサーチ (本岡式)

Anthropic web_search で公式サイト / Gビズ / 直近ニュースを実検索。Block 1 公開情報 / Block 2 事業 / Block 3 直近動き / Block 4 仮説 A-C / Block 5 質問 6 つ / Block 6 30 秒トーク + Conclusion を構造化レポートで配信。Lark Doc / PDF にワンタップ出力。

→ 使い方

URL ディープリサーチ

URL を貼って `// ディープリサーチ` と一言。複数ソースを横断調査し、サマリ / 主要ファインディング / 根拠 / 深堀り候補 / 引用 URL を構造化 Card で返却。注釈なしなら TL;DR + 3 facts の即答モード。

→ 使い方

自然言語スケジューラー / ワークフロー

「毎週月曜 9 時に営業会議リマインド」で cron が自動生成。`run_agent_prompt` として保存されるので、cron 起動時に最新の API / カレンダー / メール状態を参照した動的な内容を返答。

→ 使い方

トラブルシューティング

グループメンションが反応しない / カレンダーが取得できない / OAuth トークン失効 — よくある詰まりポイントと修正手順。

→ グループ @mention が反応しない
→ カレンダーが見えない
→ トークン失効

意図注釈一覧

メッセージ末尾(または行頭)に // 注釈 を 1 行添えると意図を上書きできます。

注釈	意味	使い方
`// 返信を作成`	メール返信ドラフトを生成	メール本文を転送 + 注釈
`// 要約`	メール / 文書を 3-5 行に要約	メール転送 + 注釈
`// アクション抽出`	ToDo / 決定事項 / 候補日時 / 質問を抽出	メール転送 + 注釈
`// 商談前リサーチ`	会社名を自動抽出 → SD フロー即起動	予定共有 + 注釈
`// ディープリサーチ`	web_search 横断で構造化レポート	URL + 注釈
`// 編集して`	予定編集 (準備中)	予定共有 + 注釈
`// 翻訳`	テキスト翻訳	本文 + 注釈
`// トーンを変更`	既存ドラフトをカジュアル / 丁寧化	ドラフト後の追記指示

✉️ メール返信ドラフト

Lark Mail で対象メールを開く → 共有 → Bot 名(LaMA)へ転送
5-10 秒で丁寧な返信文がチャットにテキスト直送されます
下に出る「💾 Mail下書きに保存」を押すと Lark Mail の下書きフォルダに書き戻し
トーン変更したい場合: 「もっとカジュアルに」「もっと簡潔に」と話しかけると再生成

📅 予定カード

毎日 18:00 配信: Bot メニュー「⚙ 自動化設定」 → 翌日予定リマインド ON
即時取得: Bot メニュー「📆 予定」をタップ
商談前リサーチボタン: 商談予定(タイトルに会社名サフィックス含む)に自動で付与。タップで Block 1-6 レポート起動

🎯 SD リサーチ

予定経由: 予定カードの「🎯 ◯◯株式会社の商談前リサーチ」をタップ
明示指示: 「◯◯株式会社のSDリサーチして」とチャット
予定共有 + 注釈: 予定を共有 + // 商談前リサーチ
5-10 分後に Block 1-6 構造化 Card が DM 到着、「📄 Lark Doc 作成」「📑 PDF 提案書」ボタンで Doc 化可能

🔍 URL リサーチ

クイック要約: URL を貼るだけ → TL;DR + 3 facts + so-what + [🔍 ディープリサーチへ] ボタン
ディープリサーチ: URL + // ディープリサーチ で複数ソース横断、構造化レポート

⏱ スケジューラー

/tasks add 毎週月曜 9 時に営業会議リマインド
/tasks list で一覧表示、各タスクの停止 / 再開ボタン付き
動的タスク: 毎朝 8 時に今日の予定をまとめて送って → 起動時に list_calendar_events 実行

🛠 グループ @mention が反応しない

Lark Developer Console で App scope 追加が必要です:

Lark Developer Console → 該当アプリ → 権限とスコープ
im:message.group_at_msg(@mention のみ受信)を追加 — 推奨
必要なら im:message.group_msg(全グループメッセージ受信)を併用
新バージョン作成 → 公開 → テナント管理者承認

🛠 カレンダーが見えない

Welcome Card の「カレンダー連携」または「全機能を有効化」を もう一度押して再認証(古いトークンは refresh_token なしで 2h で死ぬため)
scope offline_access が含まれているか確認(現行コードでは標準で含まれます)

🛠 トークン失効

ツールが「oauth_required」を返した場合、再認証 Card のボタンから OAuth フローを再実行してください。`offline_access` 付与済みなら以後は自動 refresh で 2 時間ごとの失効が解消されます。

ソースコード: https://github.com/IvyGain/LarkSuperAgent