kagent で Kubernetes の運用を考える

kagent で Kubernetes 運用を考える Oracle Cloud Hangout Café Season12 #2
Yutaka Ichikawa AI Solutions Architect Nov 11, 2026

Profile Belong : AI Solutions Architect AI Platform Unit Cloud
Business Unit Oracle Corporation Japan Role : Principal Solution Architect Yutaka Ichikawa X / GitHub : cyberblack28 2 Copyright © 2026, Oracle and/or its affiliates Community : Oracle Cloud Hangout Cafe Publications :

Agenda title 1 AI エージェントとは？ 2 Kubernetes と AI エージェント
3 kagent とは？ 4 kagent デモ 5 AI エンジニアリングから考察 6 khook デモ 7 kagent のこれから 8 Appendix 3 Copyright © 2026, Oracle and/or its affiliates

はじめに本セッションの前提：kagent 0.9.11 と kagent 1.0 本資料とデモは kagent 0.9.11（0.x 系）がベース
• 準備を進めていた時点では、kagent 1.0 は alpha 版（これから出るもの）という前提発表前日に kagent 1.0 が正式リリース • 2026年11月10日（日本時間）、KubeCon + CloudNativeCon NA 2026 の初日に v1.0.0 が公開 • 実行基盤の Agent Substrate も v1.0.0 となり、GKE 版は GA 本セッションの進め方 • 前半の説明とデモ1〜7は、0.9.11 のまま進める • 「kagent のこれから」で、1.0 で何が変わったかを紹介 4 Copyright © 2026, Oracle and/or its affiliates

AI エージェントとは？

AI エージェントとは何か目的達成のために、考えて行動する AI AI エージェントとは、目的を理解し、必要な情報やツールを選び、自ら行動して結果を返す AI 6 Copyright ©
2026, Oracle and/or its affiliates

AI エージェントとは何か Chatbot（対話型 AI）と AI エージェントの違い Chatbot（対話型 AI） AI
エージェント • 質問に答えることが中心 • 目的達成のために考えて行動する • 1回のやり取りで完結する • 必要に応じてツールを使う • 情報は持っている範囲で回答 • 複数のステップを繰り返して進める 7 Copyright © 2026, Oracle and/or its affiliates

Kubernetes と AI エージェント

Kubernetes と AI エージェント 2つのパターンパターン1:クラスタ上のオブジェクトに対して働く Kubernetes 運用エージェントとして活用 9 Copyright
© 2026, Oracle and/or its affiliates パターン2:AI エージェント基盤として外部連携外部システムと連携し、業務、プロセス全体を支援

Kubernetes と AI エージェント Kubernetes は自律制御、AI エージェントは人の意図を運用に落とし込む Kubernetes は、自律制御型のプラットフォーム AI
エージェントは、ユーザーの意図を実行する宣言型マニフェストによるクラスタ構成の定義と、望ましい AI エージェントは、ユーザーからの依頼を解釈し、必要な状態を維持するための reconciliation loop による自情報を集め、状況に応じて次の作業およびツールを選ん律制御のプラットフォームで実行する Kubernetes は、クラスタの状態を保つ自動化を実現 10 Copyright © 2026, Oracle and/or its affiliates ユーザーの意図を作業に変える自動化

Kubernetes と AI エージェント Kubernetes と AI エージェントを組み合わせると何が変わるか Kubernetes が「望ましい状態を保ち」、AI
エージェントが「調査・提案・次の作業」を支援 • クラスタの状態、イベント、ログ、リソース間の関係を横断的に確認 • 曖昧な依頼を具体的な運用手順に変換 • 原因候補と次に取るべきアクションを整理 • 調査手順と報告形式を標準化し、属人化を抑制人が目的を伝えて判断し、AI エージェントが調査・実行、Kubernetes が状態を維持 11 Copyright © 2026, Oracle and/or its affiliates

kagent とは？

kagent とは？ kagent の概要 Kubernetes 上で AI エージェントを構築・実行するためのプラットフォーム • UI
や CRD を通じてエージェントを定義・配備し、MCP でツール連携、A2A でエージェント連携可能 • Kubernetes オペレーター型の構成で、モデル、ツール、振る舞いをリソースとして管理 • Solo.io 社が開発を開始し、現在は CNCF（Cloud Native Computing Foundation）のサンドボックスプロジェクトとして寄贈（2025年5月） https://kagent.dev/ 13 Copyright © 2026, Oracle and/or its affiliates

kagent とは？ kagent における内部駆動と外部連携内部駆動：クラスタ・オブジェクト操作外部連携：AI エージェント基盤 Kubernetes クラスタ上で稼働し、Pod、Service などの
Kubernetes クラスタ外部と繋がり、MCP や API、チャット UI Kubernetes リソースを診断および操作するを介して、システム連携を可能にする外部システムログ解析、ステータス診断、操作など User 14 Copyright © 2026, Oracle and/or its affiliates User

kagent とは？ kagent のアーキテクチャ kagent は、1つのエージェントで完結するのではなく、複数ツールとエージェントを組み合わせて動かす前提の基盤 • MCP で外部ツールと接続 •
A2A でエージェント同士を連携 • 単体完結ではなく、複数ツールおよびエージェントが前提ユーザー 15 Copyright © 2026, Oracle and/or its affiliates kagent MCP 推論・計画・実行 A2A

kagent とは？ MCP MCP（Model Context Protocol）は、AI と外部のデータやシステムを接続するためのオープンな共通規格（プロトコル） MCP
サーバー MCP サーバー MCP ホスト/クライアント MCP MCP サーバー AI エージェント MCP サーバー 16 Copyright © 2026, Oracle and/or its affiliates ファイルシステム用 MCP サーバー専用 API 通信データソースローカルファイルシステムデータベース用 MCP サーバー専用 API 通信データベース外部サービス用 MCP サーバー専用 API 通信インターネット

kagent とは？ A2A A2A（Agent2Agent）は、AI エージェント同士をつなぐ通信ルール • A2A は、AI エージェント間の連携を標準化するオープンプロトコル
• 2025年4月に Google が発表、同年6月に Linux Foundation に委譲 • Agent Cards で「何ができるか」を伝える • MCP がツール接続、A2A がエージェント連携 MCP サーバー Agent Cards はエージェントの能力と呼び出し方法を記述した自己紹介カード「何ができるか」と「どう接続するか」を他のエージェントが理解するためのメタデータ A2A MCP ユーザー AI エージェント A (相談・依頼) Agent Cards AI エージェント B （実行・回答） Agent A が自分の Agent Cards を公開し、 Agent B がそれを参照 17 Copyright © 2026, Oracle and/or its affiliates MCP サーバー MCP サーバー MCP サーバーデータソースファイルシステム用 MCP サーバー専用 API 通信データベース用 MCP サーバーデータベースローカルファイルシステムデータベース専用 API 通信外部サービス用 MCP サーバー専用 API 通信インターネット

kagent とは？ kagent のユースケース kagent は、運用の中でも調査・診断・分析・最適化のような反復性の高い作業に向いている障害調査・トラブルシューティング • マイクロサービスの接続障害の診断 •
Prometheus のメトリクス分析 • Pod / Service の異常調査 • ログやイベントの分析 • トラブルシューティングの自動化 • 異常検知の原因分析支援 Kubernetes の調査 18 可観測性の活用最適化・専門エージェント • Kubernetes クラスタの調査支援 • リソース最適化の提案 • ネットワークの状況調査 • ネットワーク分析 • ネットワークポリシーの確認 • 専門領域に特化したエージェントの活用 Copyright © 2026, Oracle and/or its affiliates

kagent とは？ kagent の使い方 kagent は、UI からエージェントを作成し、システムプロンプト、モデル、MCP ツール、接続エージェントを設定して配備 1
作成 UI からエージェントを作成 19 Copyright © 2026, Oracle and/or its affiliates 2 設定システムプロンプト、モデル、 MCP ツール、接続エージェントなどを設定 3 デプロイ Kubernetes 上にデプロイすると、エージェントが稼働開始 4 利用チャット UI で対話するだけでなく、API 経由でも利用可能

kagent とは？プリセットエージェント（kagent:v0.9.11） kagent は、プリセットのエージェントやツールサーバー、MCP サーバーが用意されているプリセットエージェント概要 K8s Agent
クラスタの操作・調査・保守を行う総合エキスパート。 Observability Agent Prometheus / Grafana と連携し監視・可視化を担う。 PromQL Agent 自然言語から PromQL を生成。 Helm Agent Helm リリースの調査・リポジトリ管理・チャートのインストール/アップグレードを行い、生成された K8s リソースまで確認する。 Cilium Agent 自然言語から Cilium ネットワークポリシーを生成。 Argo Rollouts Conversion Agent 標準 Deployment を Argo Rollouts(段階的デプロイ)へ変換。 Istio Agent Istio(サービスメッシュ)の運用・トラブルシュート・保守を担うエキスパート。 kgateway Agent Envoy と Kubernetes Gateway API を基盤とするクラウドネイティブ API ゲートウェイ「kgateway」の導入・設定・トラブルシュートを行う。Gateway / HTTPRoute の設定や状態診断が中心。 20 Copyright © 2026, Oracle and/or its affiliates

kagent とは？プリセットエージェント（kagent:v0.9.11） 21 Copyright © 2026, Oracle and/or its
affiliates

kagent とは？ kagent 基本構造（kagent:v0.9.11） kagent を構成する3つのコンポーネントコンポーネント概要 UI （ユーザーインターフェース）
フロントエンド（Web画面）として動作する Pod。ユーザーがチャットをしたり、設定する画面を提供。 Controller （コントロールプレーン） kagent の本体。Kubernetes の CRD を監視し、エージェント Pod を新しく立ち上げたり、全体を制御。 Engine （実行基盤 / ツール群）「ツールサーバー（Tool Server）」および「AI エージェント Pod（実行体）」が、LLM と対話し、実際にコマンドを叩いたり、外部 MCP サーバーを呼び出して作業を実行する実務部隊。 • kagent は、Kubernetes の Operator モデルで構成され、CRD を通じて設定を管理 • 主な設定要素は、モデル設定、MCP サーバー設定、ローカル MCP、エージェント設定 • 特にエージェント設定では、どのモデルを使うか、どのツールに接続するか、どう振る舞うかを定義 22 Copyright © 2026, Oracle and/or its affiliates

kagent とは？ kagent アーキテクチャ（kagent:v0.9.11）モデルは ModelConfig で決め、ツールは MCP、他のエージェントは A2A でつながる
クラスタ外 ModelConfig で指定（設定であり、動くものではない） LLM OCI Generative AI など RemoteMCPServer すでに別の方法で動いている MCP サーバー（クラスタ内外）に URL でつなぐ登録 Agent MCP kagent-tools（プリセット例） Deployment＋Service（Helm が作成）プロンプト＋モデル＋ツール ← ツールの実体（クラスタ内で完結） Pod 内のアプリが kubectl などを実行し、 Kubernetes の API サーバーとやり取りする外部の MCP Server クラスタ外（SaaS など）登録名：kagent-tool-server A2A MCP MCPServer kmcp （kagent に同梱のコントローラー）に起動と管理を任せる MCP サーバー他の Agent type: Agent my-mcp（自作） Deployment＋Service（kmcp が作成） Kubernetes クラスタ 23 Copyright © 2026, Oracle and/or its affiliates 外部の API など必要な場合のみ

kagent とは？マニフェスト例（kagent:v0.9.11）：Agent が ModelConfig と MCP サーバーを名前で参照する Agent（主役）モデル・プロンプト・ツールを1つにまとめる
① ModelConfig どの LLM を、どこに、どう呼ぶか apiVersion: kagent.dev/v1alpha2 kind: Agent metadata: name: my-agent namespace: kagent spec: type: Declarative description: demo-app を調査するエージェント declarative: systemMessage: | あなたは Kubernetes の運用担当です。 modelConfig: default-model-config # ① モデル tools: - type: McpServer mcpServer: apiGroup: kagent.dev kind: RemoteMCPServer # ② プリセット name: kagent-tool-server toolNames: [k8s_get_resources, k8s_get_pod_logs] - type: McpServer mcpServer: apiGroup: kagent.dev kind: MCPServer # ③ 自作 name: my-mcp - type: Agent # ④ 他のエージェント（A2A） agent: name: promql-agent apiVersion: kagent.dev/v1alpha2 kind: ModelConfig metadata: name: default-model-config # ① spec: provider: OpenAI model: openai.gpt-oss-120b apiKeySecret: kagent-oci-genai apiKeySecretKey: OCI_GENAI_API_KEY openAI: baseUrl: <OCI Generative AI のエンドポイント> ①〜③ は、右のマニフェストの name と対応 ④ の promql-agent も、同じ kind: Agent のマニフェストで定義されている 24 Copyright © 2026, Oracle and/or its affiliates ② RemoteMCPServer 動いている MCP サーバーの URL を登録 apiVersion: kagent.dev/v1alpha2 kind: RemoteMCPServer metadata: name: kagent-tool-server # ② spec: description: Official KAgent tool server url: http://kagent-tools.kagent:8084/mcp ③ MCPServer コンテナイメージを渡すと kmcp が起動 apiVersion: kagent.dev/v1alpha1 # kmcp の CRD kind: MCPServer metadata: name: my-mcp # ③ spec: transportType: stdio deployment: image: docker.io/<user>/my-mcp:0.1.0 cmd: python args: ["server.py"]

kagent とは？プリセットのツールと自作のツール（kagent:v0.9.11） 25 Copyright © 2026, Oracle and/or its
affiliates

kagent とは？ kagent が目指す世界エージェントを Kubernetes のリソースとして扱うことで、活用の幅が広がる世界へ 26 Copyright ©
2026, Oracle and/or its affiliates

kagent デモ

kagent デモ kagent on Kubernetes Demo（kagent:v0.9.11） Kubernetes クラスタ上の kagent で、クラスタ内オブジェクトの調査・診断・運用支援
• デモ1: CrashLoopBackOff の原因調査と修復 • デモ2: ImagePullBackOff の原因調査と修復 • デモ3: Service と Pod のつながり確認 • デモ4: 自作エージェントを UI から作るコンポーネント概要 kagent-controller 制御プレーンの中心 kagent-ui Web 画面 kagent-kmcp-controllermanager MCP 系の管理 kagent-postgresql 永続データ kagent-tools 共通ツール群 k8s-agent クラスタ内を調査するエージェント本体 28 Copyright © 2026, Oracle and/or its affiliates

kagent デモ ModelConfig ModelConfig は、エージェントが「どの AI モデルを、どこに、どう呼び出すか」を決める設定 • provider: どの種類の
AI を使うか OpenAI gpt-oss-120b • model: どのモデル名を使うか • apiKeySecret: 認証情報をどこから読むか • baseUrl: どこへリクエストを送るか kagent OCI Generative AI 今回のデモでは、default-model-config を OCI Generative AI 向けに切り替えて利用 kagent の AI エージェントは、OCI Generative AI の OpenAI 互換エンドポイントを使用。 OCI Generative AI では Cohere、Gemini、Llama、GPT、Grok のモデルを利用可能。 https://docs.oracle.com/ja-jp/iaas/Content/generative-ai/pretrained-models.htm 29 Copyright © 2026, Oracle and/or its affiliates

kagent デモデモ1: CrashLoopBackOff の原因調査と修復 - ログから原因を特定し、同じ会話のまま修復まで任せる - 31 Copyright
© 2026, Oracle and/or its affiliates

kagent デモデモ2: ImagePullBackOff の原因調査と修復 – コンテナは一度も起動せず、ログは空、Event から原因を読み取って修復する - 33
Copyright © 2026, Oracle and/or its affiliates

kagent デモデモ3:Service と Pod のつながり確認 - Pod は正常なのに届かない、複数のリソースの関係を読み解かせる -
35 Copyright © 2026, Oracle and/or its affiliates

kagent デモデモ4: 自作エージェントを UI から作るデモ1〜3は「用意されたエージェントを使う」、ここでは自分の運用ルールを持ったエージェントを、UI からその場で作成。 ※プリセットされている
k8s-agent 利用「demo-app 専属・読み取り専用の調査エージェント」 • エージェント = システムプロンプト + モデル + ツール選択、という構造 • ツールを読み取り系に絞る = エージェントに「できないこと」を作る • 報告フォーマットの固定 = 属人化しがちな障害報告の標準化 37 Copyright © 2026, Oracle and/or its affiliates

kagent デモデモ4: 自作エージェントを UI から作る - 運用ルール（プロンプト）と権限（ツール）を持たせたエージェントを、その場で作る - 38

kagent デモ補足デモ4は、「読み取り専用の調査エージェント」を通じて、kagent のツール単位で「できないこと」を設計する一例。より細かい粒度で制御する方法として、Falco Prempti をサイドカーコンテナとして配置し、ツール呼び出しを引数レベルまで見て Falco
ルールで判定するアプローチ。 kagent 自体の設定ではなくその外側で制御するため、フレームワークに依存しない共通ルールとしてガードレールを定義。 https://speakerdeck.com/kumorn5s/falco-prempti-de-tsukuru-kura-udo-neitibuna-ai-agent-guardrail 39 Copyright © 2026, Oracle and/or its affiliates

kagent デモ補足 Prempti は Falco プロジェクト（CNCF Graduated）の公式サブプロジェクト。(https://github.com/falcosecurity/prempti) 従来の Falco
が「システムコールを監視してコンテナの異常を検知する」のに対し、Prempti は「エージェントが実行しようとしているツール呼び出しを評価する」。(Syscall を見ないのでカーネル権限不要) モード動作 guardrails（既定）ルールが判定を下し、エージェントの動作を実際に制御する。ブロック時は LLM が理解できる説明が返り、エージェントはそれを読んで方針を変える monitor 40 すべて実行させるが、ルール評価とログ記録は行う（可視化のみ） Copyright © 2026, Oracle and/or its affiliates

kagent デモデモ5: Deployment → Argo Rollouts カナリアへの移行デモ5では、 kagent
にプリセットされている argo-rollouts-conversion-agent を利用して、「カナリアリリースをエージェントに実行させる」デモを実施。 42 Copyright © 2026, Oracle and/or its affiliates

kagent デモデモ5: Deployment → Argo Rollouts カナリアへの移行 - 書き方を知らなくても、対話でカナリアを導入、昇格の「承認」は人
- 43 Copyright © 2026, Oracle and/or its affiliates

AI エンジニアリングから考察

AI エンジニアリングから考察 AI エンジニアリングの5つのレイヤー LLM（大規模言語モデル）の活用技術は、単一の「指示文（プロンプト）」を工夫する時代から、複数 AI を連携させた「複雑なシステム構築」の時代へと進化。レイヤー焦点
概要・アプローチプロンプトエンジニアリング指示の最適化（言葉選び） AI への「指示文」の工夫。役割設定（ペルソナ）や出力形式の指定で単発の回答精度を高める。コンテキストエンジニアリング情報の最適化（記憶・背景）判断に必要な背景情報（文脈）を整理・補填。RAG などで社内データや長文を適切に与えて事実性を向上させる。ハーネスエンジニアリング環境・制約の整備（道具・制約）ハーネス（安全帯）のように安全枠や外部ツールを整え、意図しない操作やエラーのリスクを抑える。ループエンジニアリング試行錯誤の自動化（自己修正）生成 ➔ 評価 ➔ 修正の反復（フィードバックループ）を回す。コード実行エラー時に AI 自身で修復・再実行させる。グラフエンジニアリング複数 AI の構造化（組織・構造）役割の異なる AI エージェントを、委譲先として宣言してつなぎ、必要な仕事をエージェントに任せ合って複雑な作業をこなす。 ※レイヤーは置き換わるのではなく、積み上がる 45 Copyright © 2026, Oracle and/or its affiliates

AI エンジニアリングから考察実際に動かしてみた上での一つの整理本日のセッションで実施したデモをベースに各レイヤーに当てはめてみると以下の通り。レイヤー何を設計するか kagent での実体本日のセッションプロンプトエンジニアリング
依頼の仕方・意図の伝え方チャット / システムプロンプトデモ1〜3 コンテキストエンジニアリング何を見せるか（情報の供給） MCP 経由で describe / logs / events をエージェント自身が取りに行くデモ2 ハーネスエンジニアリング何を「させない」か・実行環境ツールの選択で、できることを制限（権限設計）デモ4 ループエンジニアリングいつ動くか（起動の契機） khook が Kubernetes Event を検知し、A2A でエージェントを自動起動デモ5（人承認）デモ6（自動）グラフエンジニアリング誰に任せるか（役割分担） agent-as-tool（type: Agent）で A2A 委譲デモ7 例：observability-agent → promql-agent Human in the loop から Human on the loop として、運用することもできるのではないか？ 46 Copyright © 2026, Oracle and/or its affiliates

AI エンジニアリングから考察イベントを検知して、エージェントを自動起動する仕組み khook • khook は、Kubernetes の Event を監視して
kagent のエージェントを自動起動するコントローラ。 • 1つの Hook で複数のイベント種別を扱え、同一イベントは 10 分間重複抑制される。 • 呼び出しは A2A のため、kagent 以外のエージェントも対象にできる。監視できるイベント(2026年11月時点) https://github.com/kagent-dev/khook pod-restart、pod-pending、oom-kill、probe-failed、node-not-ready khook (Kubernetes controller) Kubernetes Event 検知エージェント A2A 調査報告実行 kagent 本体は「呼ばれたら動く」ので、khook が「呼ぶ人」を代行してくれる＝対話駆動からイベント駆動(ループ)への橋渡し。 47 Copyright © 2026, Oracle and/or its affiliates

khook デモ

kagent デモデモ6:イベント駆動でエージェントを自動起動する(khook) 意図的に障害を起こして、khook によってエージェントが起動、エージェントが調査、改善を提示障害 Pod（restart pod）をデプロイ OCI Generative
AI OCI Kubernetes Engine 50 Copyright © 2026, Oracle and/or its affiliates ① ② 検知エージェント起動エージェントが調査し、改善を提示 kagent/k8s-agent ③

kagent デモデモ6:イベント駆動でエージェントを自動起動する(khook) - K8s の Event がエージェントを呼ぶ - 51

kagent デモデモ6:イベント駆動でエージェントを自動起動する(khook) トリガーとなるイベントを指定いつ動くかループ起動するエージェントとそのエージェントのネームスペースを指定誰に任せるか
エージェントに依頼するプロンプトの内容を指定何を頼むかグラフプロンプトエージェント含めてどう設計していくかがカギとなりそう? 52 Copyright © 2026, Oracle and/or its affiliates

kagent デモデモ7:メトリクスにしか出ない障害を調べるデモ7では、 kagent にプリセットされている observability-agent と promql-agent を利用して、メトリクスにだけ現れる
障害を検知、その過程で observability-agent が promql-agent に委譲（A2A）して PromQL 生成させて調査というグラフ（誰に任せるか）の流れを確認。 54 Copyright © 2026, Oracle and/or its affiliates

kagent デモのまとめ • デモ1は、ログから原因を特定し、チャットの指示だけで修復する流れ • デモ2は、ログではなく Event から原因を特定し、同じ対話の型で修復する流れ • デモ3は、複数リソースの関係を読み解かせ、意図だけ伝えて修復する流れ
• デモ4は、運用ルールを持ったエージェントを UI で作る流れ • デモ5は、調査・修復だけでなく、カナリアのようなリリース手法の導入まで任せ、昇格の「承認」だけ人が担う流れ • デモ6は、イベントが障害を検知して、エージェントを呼んで自動で調査を実行させる流れ • デモ7は、情報源をメトリクスにまで広げて、エージェント同士が仕事を分担する流れ 56 Copyright © 2026, Oracle and/or its affiliates

kagent のこれから

kagent のこれから実行基盤の課題イベント駆動や承認待ちが増えるほど、「待っているエージェント」をどう持つかが課題になる求められるものこれまでの kagent（0.x 系） • •
• • エージェントは Deployment として常駐 Khook が起動するたびに会話が増える承認待ちの間も Pod がリソースを占有ランタイムの隔離・会話ごとの独立性がないどの状態でも Pod は起動したまま Agent Pod 稼働中 Agent Pod 承認待ち Copyright © 2026, Oracle and/or its affiliates 2 休眠と復帰待ちの間はリソースを返し、状態ごと再開 3 集約多数の会話を少ない Pod で回す Agent Pod アイドルこれを担うのが「エージェントサンドボックス」 58 1 隔離生成されたコードやコマンドを安全に実行

kagent のこれからエージェントサンドボックスとは ? エージェントを安全に、効率よく動かすための実行環境隔離のしくみライフサイクル管理通常のコンテナ gVisor microVM
エージェントエージェントエージェント（隔離層なし）ユーザー空間カーネルゲストカーネルホストカーネルホストカーネルホストカーネルカーネル共有 syscall を仲介専用カーネル隔離：弱強起動稼働休眠復帰プールから即時に払い出し会話を処理状態を保存しリソース解放保存した状態から再開通常の Pod との違い状態を持ったまま止めて、また起こせる Kubernetes 上の代表的な実装が Agent Substrate と Agent Sandbox 59 Copyright © 2026, Oracle and/or its affiliates

kagent のこれから Agent Substrate の位置づけ Substrate は Kubernetes を置き換えず、エージェント専用の層として上に載る kagent
はアプリ層（Agent Application Layer）エージェントの定義（AgentTemplate）と実行方法（Harness）を管理し、 Substrate の上で動かす（kagent 1.0）置き換えない Kubernetes の上に載る、エージェント専用の層共存する Deployment や StatefulSet など、普通のワークロードと並んで動く隔離は Substrate の中で gVisor / microVM で実行環境を分け、休眠中の状態は Blob storage へ出典：Google Cloud Blog（https://storage.googleapis.com/gweb-cloudblog-publish/images/Agent_Substrate__Diagram_1.max-2200x2200.avif） 60 Copyright © 2026, Oracle and/or its affiliates

kagent のこれから Agent Substrate：会話を休眠させて詰め込む専用ランタイム 1会話＝1 Actor。Actor を snapshot で止めて起こし、少数の Worker
で時間多重化する kagent atenet-router クライアントリクエストを振り分け制御プレーン ate-api-server PostgreSQL（状態管理）約250 Actor を 8 Pod で多重化（公式デモ）操作動き Suspend snapshot を保存し Worker を空ける（ノードと object storage へ） Resume 空いている Worker に snapshot から復帰（同じノードなら高速） WorkerPool（Worker Pod の集まり） Actor A 稼働中空き Actor C 稼働中 snapshot 保存先 GCS / S3：休眠中の状態ノード側：atelet が snapshot を送受信、ateworker が起動と checkpoint 認証情報はエージェントに持たせない Google GKE チームが開発を開始、CNCF Sandbox／ v1.0.0（2026年11月）、GKE 版は GA 外向き通信の出口で差し込む（atenet-egress）「待っている会話」は Worker を空けて、メモリごと保持 61 Copyright © 2026, Oracle and/or its affiliates

kagent のこれから Agent Substrate の構成（公式ドキュメントより）各ノードに1つずつ置かれ（DaemonSet）、そのノード上の Worker Pod の ateworker
と連携して、snapshot をオブジェクトストレージとの間で送受信。 3つの層 AI フレームワーク層 kagent などのエージェント基盤。セッション、ツール呼び出し、 A2A Substrate 層 Actor・Atelet・Router・ate-api-server（DB と identity broker） Kubernetes 層 Worker Pod・Service・Deployment・DaemonSet。普通の Kubernetes リソースで動く本編の Agent Substrate の図は、この構成を簡略化したもの Actor（エージェントの1プロセス）が動く隔離環境。gVisor （runsc）か microVM （Cloud Hypervisor）で作られる。 ateom（現 ateworker）：sandbox の起動と、Actor の状態の保存（checkpoint）・復元（restore）を担当。 62 Copyright © 2026, Oracle and/or its affiliates 出典：agent-substrate/substrate v0.5.0 docs/assets/threat-modeldiagram.svg（Apache License 2.0）宛先の Actor が動いている Worker Pod に振り分ける入口。

kagent のこれから Agent Sandbox：Kubernetes ネイティブなサンドボックス Sandbox CRD ＝ Pod 1つ。Kubernetes
標準の仕組みで組み立てる SandboxTemplate Pod テンプレート＋ポリシー SandboxWarmPool 起動済み Sandbox のプール払い出し SandboxClaim 利用者が作成 Sandbox Pod＋PVC＋Service （1:1）休眠＝Pod を削除、PVC と Service は保持（メモリは消える）特徴 • 隔離は RuntimeClass（gVisor / Kata）に委譲 • すべて CRD。kubectl / RBAC / GitOps で運用 • 普通の PodSpec・GPU・sidecar をそのまま利用 • warm pool から即座に Sandbox を払い出し連携例 OpenHands / NVIDIA NeMo Gym / LangChain DeepAgents Kubernetes SIG Apps のサブプロジェクト（Google 主導、Solo.io・NVIDIA・Microsoft なども貢献）／ v1.0.10（2026年11月時点）、GKE 版は GA Kubernetes の標準実装で、エージェントを安全に動かせる 63 Copyright © 2026, Oracle and/or its affiliates

kagent のこれから Agent Sandbox の構成（公式ドキュメントを元に作成）起動済みの Sandbox を用意しておくプール。 Claim が来たら待たずに払い出す。
SDK からのリクエストを、宛先の Sandbox （Service）に振り分ける入口。 3つの層 AI フレームワーク層 OpenHands や LangChain DeepAgents などのエージェント基盤。SDK（Python / Go）で Sandbox を要求する Agent Sandbox 層 CRD 4種（Claim・WarmPool・Sandbox・Template）と agent-sandboxcontroller、Sandbox Router。状態はすべて CRD Kubernetes 層 Sandbox ごとに Pod・PVC・Service。隔離は RuntimeClass に任せる Substrate との違い：専用の API サーバーや DB を持たず、 1 Sandbox ＝ 1 Pod の普通の Kubernetes リソースで動く出典：kubernetes-sigs/agent-sandbox の README・公式ドキュメントを元に作成（Apache-2.0）隔離そのものは RuntimeClass（gVisor / Kata）に任せる。 64 Copyright © 2026, Oracle and/or its affiliates Sandbox ごとの宛先。休眠中も PVC と Service は残る。

kagent のこれから 2つのサンドボックスをどう選ぶか「待っている間の状態を残したい」か「Kubernetes の標準実装で行いたい」か Agent Substrate 位置づけ Google GKE
チームが開発を開始、現在は CNCF Sandbox プロジェクト寄贈。 Agent Sandbox Kubernetes SIG Apps Agent Substrate が向くケース • 待機中の会話が多い • 承認待ちでプロセスを凍結したい代償：第2の制御プレーンと snapshot 用バケット実行単位 1会話＝ 1 Actor 1 Sandbox ＝ 1 Pod 休眠時に残るものメモリごと保持 PVC のみ制御プレーン専用 API＋PostgreSQL CRD＋コントローラ隔離 gVisor / microVM RuntimeClass に委譲 Agent Sandbox が向くケース • Kubernetes 標準の運用に乗せたい • GPU や sidecar をそのまま使いたい代償：休眠するとプロセスのメモリは消える kagent は Substrate を採用：休眠と会話の集約を重視したため 65 Copyright © 2026, Oracle and/or its affiliates

kagent のこれから API v2（kagent 1.0）：Harness と AgentTemplate Substrate に乗せるため、エージェントの定義を「中身」と「乗せ方」に分ける AgentTemplate（何をするか）
• Agent モデル / システムプロンプト • ツール（承認必須を指定可） • skills / plugins Agent ＝ AgentTemplate ＋ Harness controller が Substrate 用の定義（ActorTemplate）に変換会話（Session）が始まる会話1つにつき Actor が1つ作られる Substrate の接点（組み合わせ） Harness（どう走らせるか）デモ4 の「プロンプト＋モデル＋ツール」は、そのまま AgentTemplate へ Substrate の上での動き • kagent / codex / claude / byo • どの WorkerPool で動かすか • snapshot をどこに置くか Worker Pod の上で動く Harness が指定した WorkerPool に載る待ちの間は snapshot へ退避 Worker を空けて、次のメッセージで復帰会話ごとに Actor、待ちの間は snapshot へ ─「待っているエージェント」の課題を解消 66 Copyright © 2026, Oracle and/or its affiliates

kagent のこれからマニフェスト例（kagent:v1.0.0）：Agent が AgentTemplate と Harness を組にする Agent（組み合わせ）どの中身を、どの乗せ方で動かすか
① AgentTemplate 何をするか（エージェントの中身） apiVersion: api.kagent.dev/v1alpha3 kind: Agent metadata: name: my-agent namespace: kagent spec: template: ref: name: my-template # ① 何をするか harnessRef: name: my-harness # ② どう走らせるか apiVersion: api.kagent.dev/v1alpha3 kind: AgentTemplate metadata: name: my-template # ① namespace: kagent spec: modelConfig: name: my-model-config # 今と同じく名前で参照 systemPrompt: You are a concise, helpful coding assistant. # tools / skills もここに書く（詳しくは右下のドキュメント） 2026年11月時点の情報 • kagent 1.0 は正式リリース済み（v1.0.0）。apiVersion は v1alpha3 のまま • 例は kagent 1.x 公式ドキュメント（Agent harness）より • Harness と AgentTemplate はお互いを参照しない。組み合わせは Agent で決める ② Harness どう走らせるか（Substrate への乗せ方） apiVersion: api.kagent.dev/v1alpha3 kind: Harness metadata: name: my-harness # ② namespace: kagent spec: kagent: {} # kagent / codex / claude / byo の1つ workload: image: <registry>/<image>@sha256:<digest> # byo は必須（digest 固定） command: ["/my-agent"] # byo のときは必須 substrate: # ← Substrate の接点 workerPoolRef: name: kagent-default # どの WorkerPool で動かすか snapshotPolicy: location: s3://ate-snapshots/kagent/ # snapshot の保存先詳しくは公式ドキュメントへ（2026年11月時点） Harness / Agent：https://kagent.dev/docs/kagent/1.x/agents/agent-harness/ tools：https://kagent.dev/docs/kagent/1.x/skills-and-mcp/about-tools/ skills：https://kagent.dev/docs/kagent/1.x/skills-and-mcp/skills/ 67 Copyright © 2026, Oracle and/or its affiliates

kagent のこれから本セッションでのデモ環境とバージョンについて kagent 1.0（API v2）で API を刷新。0.x 系と 1.0
系では CRD 体系が大きく異なる 0.x 系（従来版） 1.0 系（最新版）注意点バージョン 0.9.11（0.10.x も同じ API） v1.0.0 （日本時間 11月10日リリース） • 本セッションのデモ：0.9.11 API kagent.dev/v1alpha2 api.kagent.dev/v1alpha3 • kagent 側の定義（ModelConfig・エージェント定義 Agent / SandboxAgent / AgentHarness Agent ＝ AgentTemplate ＋ Harness 実行の単位 Deployment または Actor Session ごとの Actor Substrate 任意必須エージェント・構築スクリプト）は v1alpha2 前提 • khook の 1.0 での動作は未検証 ※ kagent 1.0 は Agent Substrate（v1.0.0）が必須。Kubernetes 1.37 以上、0.x 系からは新規構築が前提本セッションのデモ環境は2026年11月時点、今後の変更による稼働影響はご了承ください 68 Copyright © 2026, Oracle and/or its affiliates

Appendix

Appendix 参考ドキュメント kagent 公式サイト：https://kagent.dev/ kagent GitHub：https://github.com/kagent-dev/kagent デモソース：https://github.com/cyberblack28/kagent-demo/tree/main 参考資料：「Deployment の先にある
AI Agent 基盤」 Kubernetes 祭 #2（2026/9/16） https://speakerdeck.com/masayaaoyama/k8s-matsuri-2-ai-agent-platform-amsy810 「Falco Prempti でつくるクラウドネイティブな AI Agent Guardrail」 Kubernetes 祭 #2（2026/9/16） https://speakerdeck.com/kumorn5s/falco-prempti-de-tsukuru-kura-udo-neitibuna-ai-agent-guardrail 「Agent Substrateの概要」 Qiita（2026/10/18） https://qiita.com/yosshi_/items/9ee846659e4d0ef860d7 「Agent Substrate, with Tim Hockin and Brandon Royal」 Kubernetes Podcast（2026/9/3） https://kubernetespodcast.com/episode/272-agent-substrate/ 「kagent 1.0 Is Here: Open Source Agents on Agent Substrate」 kagent Blog（2026/11） https://kagent.dev/blog/kagent-v1-0-release 70 Copyright © 2026, Oracle and/or its affiliates

Appendix Solo.io のハンズオン Lab（kagent） Solo.io Labs：https://www.solo.io/resources/lab?product=kagent 本編との対応はじめに：Getting started with
kagent デモ1〜3（調査）：Improve cloud native operations & troubleshooting with kagent デモ4（MCP ツール）：Kagent Lab: Integrate tools from MCP servers with kagent デモ4（自作 MCP）：Build, run & deploy MCP servers to Kubernetes Agent Substrate：Agent Substrate Basics Agent Substrate：Run Sandboxed Agents with kagent and Agent Substrate そのほか Agent Skills：Build AI agents with agent skills kagent CLI：Local development with the kagent CLI Substrate 応用：Advanced agent substrate ※ Lab 名から各ページへリンク。一覧には Istio・kgateway・agentgateway などの Lab も並ぶ（2026年11月時点） 71 Copyright © 2026, Oracle and/or its affiliates

Appendix KubeCon + CloudNativeCon North America 2026 の kagent 関連セッション
会期：2026年11月9日〜12日（米国ソルトレイクシティ）「Agent Substrate: Open Layers for Agentic Systems」 Keynote（11/9） Eitan Yarmush、Jaana Dogan（Microsoft）、Dmitry Berkovich（Google）、Luiz Scheidegger（Anthropic）「A platform engineers dilemma: agent-sandbox or agent-substrate?」 Agent Substrate Day（11/9） Jeremy Cowan ※ 本編の「2つのサンドボックスをどう選ぶか」と同じテーマ「Kagent 1.0 with Agent Substrate」 Lightning Talk（11/9） Peter Jausovec 「Lessons Learned Sandboxing Agents with kagent」 Session（11/10） Peter Jausovec、Nina Polshakova、Eitan Yarmush 「Pods Are Not Enough for AI Agents, Meet Agent-substrate」 Session（11/11） Christian Posta 「Agentic + Cloud Native: Getting Started Contributing to Kagent」 ContribFest（11/12） Lin Sun、Peter Jausovec、Eitan Yarmush、Dmytro Rashko（Amdocs）「Agentic Karpenter: Using kagent + Claude to Tune Your Autoscaling」 Demo Theater Vikram Seshadri ※ エージェントが Karpenter の設定を調べて修正を提案し、人が承認してから適用出典（Solo.io）：https://www.solo.io/events/kubecon-cloudnativecon-north-america-2026 Demo Theater は KubeCon 公式スケジュールより。録画は CNCF の YouTube チャンネルで公開予定 72 Copyright © 2026, Oracle and/or its affiliates

kagent で Kubernetes の運用を考える

kagent で Kubernetes の運用を考える

More Decks by oracle4engineer

Featured

Transcript