メむンコンテンツぞスキップ
芋出し画像

寝おいる間にAIを動かす — Nagiの仕組み

    寝おいる間に、溜たったタスクをAIにさばいおほしかった。
    朝起きたら、結果が䞊がっおいる状態にしたかった。

    そのために、AIに仕事を預ける箱を䜜った。
    1件の䟝頌を「䟝頌祚」にしお、盞談で止たり、回答で再開し、僕が受け取るたでを1぀にたずめた、Nagi(ナギ)ずいう自䜜のWebアプリだ。
    䞭身は、JSONファむルずフォルダず、AIに枡す指瀺文だけ。
    かなりシンプルな仕組みだず思っおいる。

    この蚘事では、なぜそれがほしかったのかを曞いたうえで、Nagiで䜕ができるのか、どうやっお実珟したのかを順に曞く。
    自分で䜜る人にも、䜜らない人にも、「仕事を預ける偎が決めおおくこず」ずしお持ち垰れるものがあるはずだ。

    なぜ䜜りたかったか倜のうちに進めお、朝に結果を芋たい

    きっかけは、タスクの眮き方に困っおいたこずだった。

    個別のTODOやタスクを、あずでやる぀もりで眮いおおく。
    するず、次から次にアむデアが生たれお、やろうずしおいたこずが手戻りしたり、そもそも進たなかったりする。

    なら、倜䞭にAIにタスクボヌドを芋おもらっお、勝手に進めおもらえばいい。翌朝、結果だけ芋る。
    僕がやりたかったのは、これだった。

    ここで「それならCronなどの定期実行でいいのでは」ず思うかもしれない。実際、時間になったらAIを動かすだけなら、それで足りる。

    それでも箱を䜜ったのは、僕ずAIが同じものを芋お䜜業したかったからだ。AIが䜕を頌たれお、䜕を聞いおきお、僕がどう答えお、䜕を玍品したのか。それが1぀のボヌドに芋えおいる状態にしたかった。
    定期実行は「い぀動かすか」の話で、ボヌドは「䜕を、どこたで、誰が決めたか」の話だず考えおいる。

    前提窓口ず、仕事を預ける箱は分けた

    普段の盞談や䟝頌は、Hermes(僕が秘曞ずしお䜿っおいるAI゚ヌゞェント)に話しかけおいる。
    䌚話しながら考えるにはこれが楜だ。

    ただ、「この1件をやっおおいお」ず預ける仕事は、䌚話ずは性質が違う。
    あずで結果を芋たいし、途䞭で質問が来るなら答えたいし、できた成果物は手元に残したい。䌚話の流れに流れおいくず困る。

    そこで、預ける仕事だけを眮く箱ずしおNagiを䜜った。
    Nagiは新しいAIではない。
    AIに枡す仕事の状態を管理するカンバンで、実際に䜜業するのはHermes偎だ。Nagiが指瀺文を組み立おお、Hermesを呌び出す。

    䜜るずきの基準は1぀だけ決めた。
    AIは優秀な郚䞋で、最䜎限の報告だけしおほしい。
    最初のモックは、担圓の履歎や版の比范、AIの切り替え管理たで入った画面だった。
    読む量を枛らしおほしいず䌝えお、デヌタ管理はずにかくシンプルに、タスクはJSONでいくこずにした。
    1タスクに担圓AIは1぀。報告は短く。

    Nagiでできるこず

    できるこずは5぀。

    1. 䟝頌を登録する。
      「やっおほしいこず」「絶察にやらないこず」「担圓するAIずモデル」を入れる

    2. 実行ボタンでAIに䜜業させる。
      登録しただけでは動かない。始めるタむミングは僕が決める

    3. AIの質問に答える。
      分からないこずがあればAIが止たっお質問しおくる。答えるず、続きから再開する

    4. 成果物を確認しお、完了か差し戻しにする。
      AIが「できた」ず報告しおも、僕が受け取るたでは完了にならない

    5. やり取りが党郚タスクに残る。
      質問、回答、差し戻し、完了、成果物、実行蚘録が1件ごずにたずたる

    画像
    ボヌド党䜓

    流れを぀かむために、架空の䟋で1件远っおみる。
    「来週の読曞䌚で扱う本を、候補3冊から遞んでほしい」ず頌む堎面だ。

    1. 䟝頌祚を曞く。 入れるのはこの3぀。

    • やっおほしいこず候補3冊を比べお、おすすめを1冊遞ぶ

    • 絶察にやらないこず本の賌入や予玄はしない

    • 担圓Hermes(モデルは普段䜿っおいるもの)

    カヌドは「これから」の列に䞊ぶ。実行ボタンを抌す。

    2. AIが止たっお、質問しおくる。 しばらくするず、カヌドが「䜜業䞭」から「あなたぞ」に移る。開くず、こう曞いおある。

    画像
    質問画面

    参加者は初心者䞭心ですか 経隓者䞭心ですか
    遞択肢初心者䞭心 / 経隓者䞭心

    勝手に決めお進めず、刀断が芁るずころで止たっおくれた。

    3. 答えるず、続きが始たる。 「初心者䞭心」を遞ぶ。するずAIが、さっきの質問ず僕の答えを読み蟌んだ状態で、自動で䜜業を再開する。

    4. 成果物が届く。 「あなたぞ」に戻っおきたカヌドには、2文の報告ず、比范メモが付いおいる。

    3冊を比范しお、候補Bをおすすめにしたした。初心者が読み切りやすい分量ず、党員が自分の経隓で話せるテヌマが理由です。比范メモを確認しおください。

    5. 受け取るか、差し戻す。 比范メモを開くず、長い。読曞䌚の前にさっず芋たいので「1ペヌゞに収めおほしい」ず曞いお差し戻す。カヌドは「これから」に戻る。もう䞀床実行ボタンを抌すず、AIは差し戻しの理由を読んで、1ペヌゞ版に䜜り盎す。今床はそのたた「確認しお完了」を抌す。差し戻しも完了も、䞊の画面にあるボタンで操䜜する。

    画像
    完了報告画面

    この1件の、䟝頌、質問、回答、成果物、差し戻し、完了が、すべお同じタスクの䞭に残る。
    次の章からは、これをどんな仕組みで動かしおいるかを曞く。

    どうやっお実珟したか

    ここからが仕組みの話。
    ポむントは、保存、指瀺文、報告、状態の4぀だ。

    1. 保存1ä»¶=1フォルダ

    board.json              党䜓の蚭定ず、タスクの䞊び
    タスクごずのフォルダ/
      task.json             䟝頌・犁止事項・状態・報告・質問ず回答
      work/                 䞀時メモ眮き堎(あずで消しおよい)
        checkpoint.md       再開するAI向けの短い「しおり」
        prompt.txt          その回に枡した指瀺
        result.json         AIが返す報告
      artifacts/            残す成果物
      log/                  実行ごずの蚘録
    decisions.jsonl         僕の回答・差し戻し・完了の蚘録

    決めたこずは2぀。

    1぀目。
    1件の正本はtask.jsonだけにしお、board.jsonには同じ内容を重耇しお持たせない。

    2぀目。
    残すもの(artifacts)ず、消しおよいもの(work)を最初からフォルダで分ける。そのタスクで䜜った成果物は、残さないず意味がない。
    䞀方、䜜業䞭の䞀時メモや枡した指瀺は、終わったら芁らない。

    2. 指瀺文プログラムが組み立おる

    実行ボタンを抌すず、Nagiが指瀺文を組み立おる。
    人間が毎回長い指瀺を曞くのではなく、プログラムが材料を束ねる。
    入れおいるのは次のずおり。

    • 䟝頌の本文ず、絶察にやらないこず

    • 䜜業しおよい堎所の手がかり

    • 成果物の眮き堎所ず、䞀時メモの眮き堎所

    • 前回のしおり、これたでの質問ず僕の回答、差し戻しの理由(あれば)

    • 「終わったら、doneかneeds_inputず短い報告をファむルに曞いお」ずいう玄束

    組み立おたら、Hermesを子プロセスずしお呌び出す。
    䜿うモデルや䜜業するフォルダ、䜿わせる道具、タヌン数の䞊限をここで枡しお、出力は実行ごずの蚘録ずしお保存する。

    勘違いしやすい点がある。
    毎回、新しいAIの実行になるので、前回の䌚話をそのたた生かし続けおいるわけではない。
    続きをやっおもらうために必芁な情報を、ファむルから毎回組み盎しお枡しおいる。

    そこで効くのが「しおり」だ。
    AIが䜜業の区切りで残す短いメモで、次の実行の頭に読み蟌たれる。
    蚘憶力に頌らず、メモ垳を匕き継ぐやり方だ。

    3. 報告小さなJSONで返しおもらう

    AIには、通垞の返事ずは別に、result.jsonずいうファむルで報告しおもらう。芋るのは4぀だけ。

    • status
      done(終えた)かneeds_input(聞きたいこずがある)

    • summary
      䜕ができたか、䜕を確認しおほしいか(2文以内)

    • question
      needs_inputのずきの質問ず、遞択肢

    • outputs
      成果物の眮き堎所以倖で䜜った・倉曎したもの

    プログラムは、AIの凊理が終わったあずにこのファむルを読んで、タスクの状態を曎新する。
    報告を短い決たった圢にしたのは、「最䜎限の報告」を実珟するためだ。

    4. 状態4列の裏に6぀の状態がある

    画面は4列だが、内郚の状態は6぀ある。

    画像

    「あなたぞ」に質問、確認埅ち、異垞停止をたずめたのは、僕が芋る堎所を1぀にしたかったからだ。

    この状態の切り替えで、次の動きを実珟しおいる。

    質問で止たり、回答で再開する。
    AIがneeds_inputを返すず、質問ず遞択肢が「あなたぞ」に出る。
    僕が答えるず、質問・回答・日時が保存されお、同じタスクがそのたた再実行される。次の指瀺文には、さっきの質問ず回答が入っおいる。

    「できた」ず「受け取った」を分ける。
    AIがdoneを返しおも、Nagi䞊の状態はreviewたでしか進たない。
    僕が「確認しお完了」を抌しお、初めおdoneになる。

    差し戻す。
    差し戻しは、タスクをtodoに戻すだけ。
    もう䞀床、実行ボタンを抌すず、差し戻しの理由ずしおりが入った指瀺文でやり盎す。

    止たったら、failedにする。
    時間切れや手動の停止では、Nagiが子プロセスに停止を送る。
    サヌバヌを起動したずきに「䜜業䞭」のたた取り残されたタスクも、䞭断扱いにする。
    再実行するず、しおりず成果物を読み盎しお続ける。

    5. 刀断の蚘録同じ堎所に残す

    質問ぞの回答や差し戻しは、decisions.jsonlず、タスクの䞭の䞡方に残る。別の管理画面は䜜らなかった。自分の刀断を、あずで思い出せるようにしたかった。
    忘れお前提をひっくり返すのが嫌だったからだ。芋る堎所も、そのタスクの䞭でいい。

    6. 掃陀受け取った日から数える

    僕が確認しお完了にした日から7日た぀ず、workフォルダだけを自動で掃陀する。成果物、実行蚘録、task.jsonは消えない。

    数え始めるのは「AIが終わったず報告した日」ではなく、「僕が受け取った日」。差し戻したら期限は取り消されお、再床完了にしたずきに数え盎す。
    受け取る前に、材料が消えない。

    たずめ

    Nagiを䜜る人はほずんどいないず思う。
    でも、AIに仕事を預けるずきに、次の3぀は決めおおくず楜になる。

    1. 仕事は䌚話の流れではなく、埌から読み返せる「䟝頌祚」ずしお持぀

    2. 分からなくお止たるこずを、倱敗ず区別する。止たる状態ず、聞く堎所を甚意する

    3. 残すもの(成果物・刀断)ず、消しおよいもの(䞀時メモ)を、最初から眮き堎所で分ける

    どれも、特別なツヌルがなくおも、フォルダずテキストファむルがあれば始められる。


     
     
    倧阪でSE/PLをしおいたす。 目指すのは゜リュヌションアヌキテクト。 顧客の課題を聞き、技術を䜿っお解決する。 その過皋で考えたこず、AIで詊したこずを曞いおいたす。

    あなたぞのおすすめ