ツール

OmnaraのオープンソースAgent Runtime、永続化をAPI化

Omnaraは、Agent Loop、実行環境、権限管理、Postgresによる状態管理を1つのAPIに集約している。本稿ではその設計を分解し、オープンソース化为使用时哪些运维成本仍然无法消除かを整理する。

文字サイズ

Omnaraは単なるAgent SDKではない

Hacker Newsで話題を呼んでいるOmnaraは、Claude Managed Agentsの代替を目指して開発されている。Agent Loop、サンドボックス、権限、Postgres上の状態管理を1つのオープンソースAPIにまとめている。バックグラウンドでAgentを継続稼働させたいチームにとっては、独自でキュー、実行環境、復旧機構を組むより楽だが、プラットフォームへの依存も一つ増える。

元のプロジェクト:https://github.com/omnara-ai/omnara

Omnaraは単なるAgent SDKではない

OmnaraはClaude Managed Agentsのオープンソース代替として位置づけている。

モデル呼び出しをAPIで包むだけの仕組みでも、LangChainやLangGraphの抽象をいくつか再包装したものでもない。プロジェクト概要には、開発者は1回のAPI呼び出しでAgentを作成し、その後はOmnaraがAgent Loopを実行すると明記されている。

開発者がメッセージを送ると、イベントをストリーミングで受け取れる。Agentは隔離されたサンドボックス内でコマンドを実行し、ランタイムがsecrets、permissions、RBACを管理する。各Agentの状態はPostgresに保存され、サービス再起動後も処理を継続できる。

これは「ツールを使えるチャットボットを1つ作る」という уровеньを一段超えた仕組みである。提供されるのはモデルではなく、継続実行されるAgentに必要なコントロールプレーンだ。

多くのAgent SDKが解決するのは「フローをどう記述するか」だった。ノードの接続、ツールの登録、イベントのコールバック処理は、通常、開発者が行う。

こうしたSDKはしばしばPythonまたはTypeScriptのプロセスとして動く。ローカルで起動すれば、Agentも開発者のマシン上で実行される。プロセス終了時にタスクも止まる。

OmnaraはよりAgent Runtimeに近い。プロジェクト概要によれば、開発者がAPI経由でAgentを作成すれば、プラットフォームがAgent Loopを動かし続ける。ユーザーはメッセージを送り、Agentが生成したイベントをAPI経由でストリーミング受信できる。

重要なのは「継続」という点だ。

実用的なバックグラウンドAgentには、少なくとも次のようなケースを処理する機能が必要となる。

  • ツール呼び出しが通常のHTTPリクエストより長い時間かかる
  • 外部イベントを待つ必要があり、モデルを常時占有してはいけない
  • コンテナやホストが再起動してもタスクを失わない
  • 異なるユーザー間で、共有してはいけない鍵を分離する
  • 暴走したshellコマンドが他のタスクへ影響を及ぼさない

したがって、Agent SDKとAgent Runtimeの境界は、プロンプトテンプレートではなく、ライフサイクル管理にある。

Omnaraはこの部分を托管サービスに組み込んでいる。利用者に公開されるのはAgent APIで、実行環境、状態、制御権限は下層で管理される。

1回のAPI呼び出しでAgentを作成

Omnaraの利用方法は、意図的に薄い構成になっている。

まずAgentを作成する。

from omnara import Omnara

client = Omnara(api_key="YOUR_API_KEY")
agent = client.agents.create(
    name="research-agent",
    instructions="Research the assigned topic and save the findings.",
)

次にAgentへメッセージを送り、ストリーミングイベントを処理する。

for event in client.agents.message(
    agent.id,
    message="Find three reliable sources and summarize their key claims.",
):
    print(event)

このコードで重要なのは、実装の詳細より構造である。作成と対話を分離し、Agentを先にプラットフォーム上のオブジェクトとして生成してからメッセージを受信する。各対話で発生したイベントは、ストリームとして返される。

クライアントが推論ループを動かすために長接続を維持する必要はない。プラットフォームがAgent Loopを実行し、モデルが次の動作を決め、サンドボックスが処理を実行して、イベント 调用元へストリーミングで返す。

这也是、Omnaraが単なる「SDK」ではない理由である。SDKは通常、構築用の部品を提供するが、プロセス起動、workerのデプロイ、キュー接続、状態保存は呼び出し側の責任となる。Omnaraはこうしたランタイムとしての責務をサーバー側へ移そうとしている。

代价も存在する。コードは減る一方、プラットフォームへの依存は増える。OmnaraのAPI、イベント形式、デプロイ方式に依存し始める。

サンドボックス、secrets、RBACが本当の壁

Omnaraは、コマンドを実行できるサンドボックスをAgentに提供し、secrets、permissions、RBACを管理する。

この機能群は、大多数のAgent Demoよりも本番要件に近い。

Agentがコマンドを実行できるようになると、問題は「回答が正しいか」だけでは収まらない。repositoryを読んだり、内部APIを呼んだり、ファイルを変更したりする、外部Webページの内容を指示として実行する对这些-gradients-trivial習う一遍になる可能性公公西。千.

妥当なランタイムは、少なくとも次の4つの問いに答えられなければならない。

  1. Agentはどのコマンドを実行できるか
  2. どの隔離環境で実行されるか
  3. どのsecretsを、どの範囲で使用できるか
  4. どのユーザーやサービスがメッセージ送信、ログ閲覧、タスク取消を実行できるか

RBACが最後の問いを担い、secretsが3つ目を扱う。サンドボックスは2つ目の問いが影響を及ぼす範囲を制限する。

逆説的なのは、Agent基盤で最も難しい部分が推論とは限らないという点だ。モデルの回答品質は、モデルの変更、プロンプト調整、評価の追加で改善できる。一方、コマンドの隔離、認証情報の漏えい、権限の逸脱は、1回のprompt修正では解決しにくい。

Omnaraのチームは当初、Claude CodeとCodexを遠隔操作するcapacityのcapacityなcapacity智能手机アプリを開発していた。プロジェクト概要には、初期のharnessがノートPC上で動いていたとも記されている。

この経験iciosが、実行環境を重視し、別のチャットUIを作ることに重点を置いた理由だと考えられる。

一方で、慎重な確認も必要だ。プロジェクト概要にはサンドボックス、権限、RBACの機能が記載されているが、提供資料には隔離の実装方式、監査の粒度、本番SLAが開示されていない。高感度ワークロードに利用できるかは、ソースコード、デプロイ文書、独立したセキュリティテストで確認する必要がある。

Postgresで再起動後も処理を継続

プロジェクト概要によると、各Agentの状態はPostgresに保存される。そのため、Agentはサービス再起動をまたいで復旧でき、アイドル中は実行コストが発生しない。

これがOmnaraと多くの「プロセス内Agent」の最も実用的な違いだ。

Agentの状態がメモリにしかない場合、workerの再起動、コンテナのローリングデプロイ、マシン障害のたびにタスクが中断される。状態を補うには、別途データベースと復旧ロジックを組み込む必要がある。

OmnaraはPostgresを永続化の土台にする。タスクは一時停止でき、復旧後に再開できる。実行中のタスクがなければ、モデルや計算資源の費用を常時支払う必要もない。

ただし、Postgresが状態を担うことは、Postgresだけで完全なタスクキューを処理できることを意味しない。両者が解決する問題は異なる。

  • Agentの状態は「タスクがどこまで進んだか」を管理する
  • タスクキューは「次のタスクを誰が受け取るか」を管理する
  • リースとheartbeatは「workerが停止した後、どう再試行するか」を管理する
  • idempotency keyは「メッセージを再送しても二重実行をどう避けるか」を管理する

実運用では、Redis、RabbitMQ、SQSなど別のキューコンポーネントが必要になる 가능성이残る。Omnaraの重要な設計は、Agentの連続性をPostgres上に構築し、クライアントに会話全体と実行現場を保存させる负担を省くことにある。

「アイドル時のコストゼロ(expression-te)」も、正確に解釈する必要がある。プロジェクト概要ではこの表現が使われているが、慢性的な計算費用がないことを示す可能性が高い。ストレージ、データベース、コントロールプレーン的费用が完全にゼロという意味ではない。

オープンソース代替品には運用コストが伴う

Claude Managed Agentsと比較したときのOmnaraの魅力は明確である。プラットフォームのロックインが1つ減り、状態と実行環境を自分のインフラへ近づけられる。

ただし、オープンソースの代替 IntensiveELLOWをローカルに置くだけで請求額が自動的に減るわけではない。

Omnaraを運用する人は、引き続き次の作業,承担起来。

  • Postgresの準備と保守
  • Agent Loop、サンドボックス、イベント流的監視
  • セキュリティパッチと依存関係の更新
  • バックアップ、災害復旧、障害復旧の設計
  • secrets、RBAC、ログポリシーの検証

これこそがManaged Agentプラットフォームが本当に販売しているものだという。_fee_onceモデルリクエストではなく、「この仕組みが常に動き続けることを保証してくれる」点だ。

Omnaraが削減するのは、プラットフォームロックインと一部統合作業である。コストが下がるかどうかは、Populat.

個人開発者にとっては、マネージド版のほうが手間に个省かれる可能性がある。独自の権限、データの管理権、管理対象データや、既存のKubernetesとデータベースの運用があるプラットフォームチームにとって、オープンソースのRuntimeが実際に有利になる可能性があるのはhape.

私としての判断はこうだ。Claude Managed AgentsをOmnaraへ置き換えるなら、チームは少なくとも1つの問いに答える必要がある。深夜にworkerが停止した際、誰がアラートを受け、復旧作業を担うのか。答えが「従来どおりプラットフォームチーム」なら、移行による効果は期待ほど大きくないかもしれない。

編集者の視点

OmnaraはHacker Newsで人気上昇中获得しているだけでなく、Agent Runtimeの境界を可視化licaという点が重要だ。モデルは置き換えられるが、タスク状態、権限の境界、実行環境は、Agentが長期的に動き続けるかどう���決定する。チームを選定する際、比較すべきは単発の一問一答の品質ではなく、障害後の復旧、認証情報の分離、タスクの監査可能性だ。これらは本番障害と運用コストに直結する。

ただし、短期的にClaude Managed Agentsを直接置き換えるとは限らない。むしろ、セルフホスト、.permissionのカスタマイズ、データの管理権を必要とするプラットフォームチームが先に導入すると考えられる。個人開発者は引き続きマネージド版を選ぶだろう。過去のAgent SDKと異なり、Omnaraが奪おうとしているのは開発用の抽象だけでなく、ランタイムの制御権だ。ただし、隔離の強度、Postgresの並行性モデル、大規模イベント流での挙動を検証するにはデータが不足している。最終的な評価は、ソースコードとload testの結果に委ねられる。

出典: https://github.com/omnara-ai/omnara