Skip to content
プロダクト

コードを書くワークフローを構築:Coding Agentステップの紹介

JieGouワークフローに、サンドボックス環境内でファイルの読み書き・編集やシェルコマンドの実行を自律的に行うコーディングエージェントを含められるようになりました。仕組みと重要性を解説します。

JT
JieGou Team
· · 2 分で読めます

ほとんどのAI自動化プラットフォームはテキストで止まります。レポートの生成、メールの下書き、ドキュメントの要約が可能です。しかし、ワークフローがコードを書く、テストを実行する、設定ファイルを更新する、マイグレーションスクリプトを生成する必要がある場合はどうでしょうか?

本日、Coding Agentをリリースします — 自動化にコードベースと自律的にインタラクションする能力を与える新しいワークフローステップタイプです。

Coding Agentとは?

Coding Agentは、任意のJieGouワークフローに追加できる新しいステップタイプです。タスク説明を与え、オプションでGitリポジトリを指定します。エージェントは以下を行います:

  1. リポジトリをクローン(または一時ディレクトリで作業)
  2. コードベースを探索 — ファイルを読み、globとgrepで検索
  3. 見つけた内容に基づいてアプローチを計画
  4. 変更を実装 — 新しいファイルを書き、既存のファイルを編集
  5. 作業を検証 — テストを実行し、エラーをチェック
  6. サマリーと変更ファイルリストとともに報告

これらすべてが自律的に、ターンごとに、タスクが完了するか設定されたターン制限に達するまで行われます。

6つの組み込みツール

エージェントは6つのツールにアクセスでき、各ツールは特定の操作用に設計されています:

ツール機能
readオプションの行範囲でファイル内容を読み取り
writeファイルを作成または上書き
editファジーUnicodeマッチング付きの正確な文字列置換
bashタイムアウト強制付きでシェルコマンドを実行
globパターンでファイルを検索
grep正規表現でファイル内容を検索

ステップごとに個別のツールを有効または無効にできます。例えば、「読み取り専用分析」ステップではreadglobgrepのみを有効にできます。

デフォルトでサンドボックス化

LLMにファイルシステムとシェルへのアクセスを与える場合、セキュリティは譲歩できません。本番環境のすべてのCoding Agentステップは、厳格な制約を持つDockerコンテナ内で実行されます:

  • ネットワークアクセスなし — コンテナはアウトバウンド接続不可
  • メモリ制限 — 512 MBでハードOOMキル
  • CPU制限 — コアの25%に制限
  • PID制限 — フォーク爆弾を防止(最大50プロセス)
  • 読み取り専用ルートファイルシステム — 作業ディレクトリのみ書き込み可能
  • パス制限 — すべてのファイル操作が作業ディレクトリ内に留まるよう検証、シンボリックリンクトラバーサルをブロック
  • タイムアウト強制 — bashコマンドは設定されたタイムアウト後にハードキル(デフォルト:2分)

開発モードでは、エージェントはより高速な反復のためにローカルファイルシステム操作を使用します。プラグ可能なFileOperationsインターフェースにより、同じツール定義が両方の環境で機能します。

長いセッションのための反復コンパクション

複雑なコーディングタスクは多くのターン — 20、30、50ものツール呼び出しを必要とする場合があります。それは多くのコンテキストです。Coding AgentはJieGouの会話型AIと同じ反復コンパクションシステムを使用して長いセッションを処理します:

  • 蓄積されたメッセージがモデルのコンテキストウィンドウに近づくと、古いターンが構造化されたサマリーに圧縮されます
  • サマリーは目標、進捗、主要な決定、ファイル参照を保持します
  • 後続のコンパクションは最初から再生成するのではなく、既存のサマリーを更新します

これにより、数十ターンにわたるセッションでも、エージェントは何をしたかを見失うことはありません。

リアルタイムイベントストリーミング

エージェントが行うすべてのアクションは構造化されたイベントを発行します:

  • turn_start / turn_end — ターン数とトークン使用量を追跡
  • tool_call / tool_result — どのツールが使用されているかとその出力を表示
  • assistant_message — エージェントの推論と説明
  • compaction — コンテキストが圧縮された時
  • agent_end — 合計ターン、トークン、変更ファイルの最終サマリー

これらのイベントはワークフロー実行UIでのリアルタイム進捗表示に使用され、コンプライアンスのために監査証跡にログされます。

ユースケース

チームが既にCoding Agentを使用している方法をいくつか紹介します:

  • 自動テスト生成 — モジュールを指定して単体テストの記述を依頼
  • ドキュメント更新 — コード変更からAPIドキュメント、README、変更ログを生成
  • マイグレーションスクリプト — スキーマ変更に基づいてデータベースマイグレーションファイルを記述
  • 設定生成 — テンプレートからTerraform、Kubernetes YAML、CI/CD設定を生成
  • コードレビュー支援 — diffを分析してレビューコメントを生成
  • 依存関係更新 — パッケージバージョンを更新し破壊的変更を修正

ワークフローへの統合方法

Coding Agentは通常のワークフローステップです。以下が可能です:

  • 入力マッピング経由で前のステップからの入力を受信(例:WebhookトリガーからのPR diff)
  • 下流ステップが消費する結果を出力(エージェントのレスポンス、変更ファイルリスト、トークン使用量)
  • 依存関係宣言とともに他のステップと並行してDAGモードで実行
  • 任意のLLMプロバイダーを使用 — コーディングタスクに最適なモデルを選択(複雑なリファクタリングにはClaude Opus、シンプルな編集にはHaiku)

プランゲーティングとコスト見積もり

Coding AgentはProプラン以上で利用可能です。コスト見積もりは設定されたmaxTurnsにターンあたりの平均トークンを掛けて計算されるため、ワークフロー実行開始前に正確な見積もりが得られます。

エンタープライズプランでは、より高い並行性と分離のための専用コンテナプールが利用できます。

はじめに

  1. ワークフローを作成または編集
  2. 新しいステップを追加し、タイプとしてCoding Agentを選択
  3. タスク説明を記述(具体的に — ファイルパス、期待される動作、テストコマンドを含める)
  4. オプションでリポジトリURLとブランチを設定
  5. ツールアクセス、最大ターン、モデル選択を設定
  6. ワークフローを実行

Coding Agentは、チームが既にコンテンツ生成、データ処理、運用ワークフローを実行しているのと同じプラットフォームにソフトウェアエンジニアリング機能をもたらします。別のツール不要、コンテキスト切り替え不要 — パイプラインのもう1つのステップです。

ProおよびTeamプランで今すぐ利用可能。始めましょう

coding-agent workflows automation devops sandboxing docker
この記事をシェアする

この記事はお役に立ちましたか?

ワークフローのヒント、製品アップデート、自動化ガイドをメールでお届けします。

No spam. Unsubscribe anytime.