Outlineでエージェントができること
ざっくりした説明から手順書を書く
作業の流れを説明するか、ターミナルの操作記録を貼り付けると、Engineeringコレクションに手順書を下書きします。目的、前提条件、番号付きの手順、失敗したときの対処です。
頼み方下に貼った手順をもとに、ステージングのデータベースを復元する手順書をEngineeringに書いて。
コードの変更に文書を追いつかせる
GitHubのプルリクエストでサービス名や設定が変わったら、古い名前が残っているOutlineの文書を探し、1件ずつ修正案を下書きしてレビューに回します。
頼み方billing-apiサービスはpaymentsに名前が変わりました。旧名が残っているOutlineの文書を探して修正案を書いて。
Wikiの内容から質問に答える
「本番環境のログを見る権限はどう申請するか」と尋ねると、Outlineを検索して該当する文書を読み、数行で答えます。確かめられるよう、参照した文書へのリンクも添えます。
頼み方新しいエンジニアが本番のログを見るにはどうすればいい？参照したOutlineの文書のリンクも付けて。
深い階層の文書を整理する
コレクションのツリーを洗い出し、4階層下でだれも開かない文書、題名違いの重複、中身のない仮の文書を見つけて、すっきりした構成を提案します。
頼み方Platformコレクションの構成を洗い出して、浅い構成の案を出して。重複と空の文書は別に一覧にして。
週ごとの文書の更新履歴を書く
毎週金曜に、選んだコレクションでその週に作成・更新された文書を1件ずつひとこと付きで一覧にし、Announcementsコレクションの下書きとして用意します。
頼み方毎週金曜17時に、EngineeringとProductで今週追加・更新された文書の更新履歴を下書きして。
ほかのツールからページを移す
ConfluenceやGoogle ドキュメントから選んだページを読み、見出しや表を保ったままOutlineの体裁に書き直し、あなたの許可を得て下書きとして作成します。
頼み方Confluenceにある入社手続きのページ6件を、OutlineのPeopleコレクションに下書きとして移して。
社外の人に見せる文書を整える
外部の協力会社に文書を1つ渡すときは、社内向けのリンク、ホスト名、出してはいけない名前がないかを確かめて修正案を出し、公開用の共有リンクを作る前に確認します。
頼み方制作会社にブランドガイドラインの文書を渡します。社内向けの記述を確かめて、共有リンクを承認用に準備して。
接続のしくみ
- 1Outlineの設定で発行したAPIキーで、ワークスペースを一度接続します。セルフホスト版の場合はサーバーのアドレスも入力し、エージェントはそのサーバーを通じて働きます。
- 2Outlineを使えるエージェントはあなたが選びます。GitHubも読む開発担当が向いています。キーには発行したアカウントの権限が付くため、必要なコレクションを持つアカウントで発行してください。
- 3文書の検索と読み取り、下書きの準備に承認は要りません。文書の公開、公開済み文書の編集、移動、アーカイブ、削除、共有リンクの作成は事前に確認します。
ノート・ナレッジ・データベースのほかのアプリ
同じ種類のアプリでも、エージェントが働けます。それぞれのページで詳しく紹介しています。
よくある質問
AIエージェントにOutlineの文書を書いてもらえますか？
書いてもらえます。Monmoのエージェントは、説明、Slackのスレッド、プルリクエスト、音声メッセージから、既存の文書と同じ体裁でコレクションに下書きします。公開や公開済み文書の編集は、あなたが許可したときだけです。Outlineの連携を通じて作業し、連携で届かない手順は自分のブラウザーで進めます。
セルフホスト版のOutlineでも使えますか？
エージェントからサーバーに届けば使えます。Outlineのアドレスと、設定で発行したAPIキーを入力します。社内ネットワークの中からしか開けないWikiは、セキュリティ方針で認められる方法でチームが外から届くようにするまで、エージェントのクラウドのコンピューターからは開けません。
社内Wikiの内容からAIエージェントが技術的な質問に答えられますか？
答えられます。AIエージェントは、APIキーで読めるコレクションを検索し、該当する文書を読んで、出典へのリンク付きで数行で答えます。文書どうしが食い違うときや、コードより古そうなときはそう伝えるので、修正がチャットに埋もれずWikiに反映されます。
Outlineの文書が古くならないようにできますか？
決めた定期タスクで、文書をGitHub、Linear、Slackでの最近の動きと比べます。名前の変わったサービス、変わった設定、終わったプロジェクトなどです。ずれた文書を一覧にして修正案を書き、保存の前に確認します。長く編集されていない文書も、担当者の確認用に一覧に加えます。