> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/get-started/ja/jento/roboflow-agent.md).

# Roboflow Agent

ワークフローとRapidモデルを構築、実行、デバッグするアプリ内Roboflow Agentと、そのHTTPチャットAPI。

## 概要

Roboflow Agent はあなたの [ワークスペース](/get-started/ja/purattofmu/workspaces/key-concepts.md) にアクセスでき、 [ワークフロー](https://docs.roboflow.com/workflows)を作成、編集、実行、デバッグできます。また、これを使って [Rapid](https://docs.roboflow.com/models/rapid/rapid) モデルを設定することもできます。ワークスペースの左サイドバーで「Agent」をクリックすると、エージェントにアクセスできます。

<figure><img src="https://2537277549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-e08163ee75bce9853bb94d3581efc5910405e091%2Frf-agent.png?alt=media" alt=""><figcaption></figcaption></figure>

### 機能

エージェントは次の対象を扱えます：

* [ワークフロー](https://docs.roboflow.com/workflows)：平易な説明から作成し、画像、RTSP ストリーム、動画、またはウェブカメラ上で実行し、ライブプレビューを確認し、自動で失敗を修正し、実行エラーを調査し、検出ゾーンを描画できます。
* 添付メディア：チャットにドロップした画像や MP4 または MOV 動画を分析し、それらを使ってワークフローを作成・検証できます。
* [Rapid](https://docs.roboflow.com/models/rapid/rapid) モデル：学習の設定、管理、失敗の診断を行えます。
* プロジェクト： [プロジェクトを作成](https://docs.roboflow.com/datasets/create-and-upload/create-a-project#create-a-project-from-the-agent)、開始 [モデル学習](https://docs.roboflow.com/models/train/train-a-model#train-from-the-agent), [分割の再バランス](https://docs.roboflow.com/datasets/versions/dataset-versions/create-a-dataset-version#readjusting-train-validation-test-splits)、および [プロジェクトの統合](https://docs.roboflow.com/datasets/manage/merge-datasets).
* データセット： [ラベリング段階ごとに画像を閲覧](https://docs.roboflow.com/datasets/annotate/annotate/team-collaboration#browse-labeling-work-from-the-agent), [ワークスペースの画像をモデルに追加し、ラベリングを開始](https://docs.roboflow.com/datasets/annotate/annotate/team-collaboration#add-images-and-start-annotating)、バッチをレビューに回すか編集に戻し、画像をデータセットに受け入れ、作業を未割り当てに戻します。
* [バッチ処理](https://docs.roboflow.com/deployment/roboflow-cloud/batch-processing)：アセットライブラリの画像に対して公開済みワークフローを実行し、チャット内で新しいジョブを設定し、ジョブ一覧を表示し、個々のジョブのステータスを報告します。
* [アクティブラーニング](https://docs.roboflow.com/deployment/monitoring-and-analytics/active-learning)：プロジェクトごとに収集のオン／オフを切り替え、その制限と条件を編集します。
* [ビジョンイベント](https://docs.roboflow.com/deployment/monitoring-and-analytics/vision-events)：ワークフローにブロックを追加し、 [イベントデータに関する質問に答え](https://docs.roboflow.com/deployment/monitoring-and-analytics/vision-events/query-events)、およびスケジュール [サマリーレポート](https://docs.roboflow.com/deployment/monitoring-and-analytics/vision-events/summary-reports).
* 使用状況：あなたの [クレジット使用状況ダッシュボード](/get-started/ja/purattofmu/billing-and-plans/credits/view-credit-usage.md) を質問に一致するフィルターで表示します。
* エッジデバイス：あなたの [デプロイメントマネージャー](https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager) フリート、テレメトリ、ログ、ストリームへの読み取り専用アクセスで質問に答えます。
* タブ：開いているワークフロー、モデル、プロジェクト、使用状況ビューを整理し、ドラッグで並べ替え、閉じた項目を再度開くか、「+」タブから新規作成できます。

### バックグラウンドタスク

エージェントが開始した長時間ジョブは、チャット中も実行され続けます：モデル学習、自動ラベリング、データセット版の生成、プロジェクトの統合、クラスの再マッピング、分割の再バランス、バッチ処理ジョブ。チャットボックス上のピル型表示が実行中の件数を数えます。それをクリックするか、左メニューの「Background Tasks」をクリックすると、これらが「Running」と「Finished」に分かれて一覧表示されるパネルが開きます。タスクをクリックすると、そのタスクが作成したページを開けます。

タスクが完了すると、タブを閉じて後で戻ってきた場合でも、エージェントがチャットで知らせます。ここに表示されるのは会話内から開始したジョブだけです。アプリの別の場所や API から開始した学習は表示されず、その代わり Activity Center で追跡します。

## HTTP API

Agent API を使うと、Roboflow AI エージェントと `api.roboflow.com`を通じてやり取りできます。自然言語の指示を送って作成または編集でき、 [ワークフロー](https://docs.roboflow.com/workflows/build/create-a-workflow)、準備ができたら公開できます。すべての編集は、明示的に公開するまで下書きとして保存されます。

認証方法は [API キー](https://docs.roboflow.com/reference/platform/rest-api/authenticate-with-the-rest-api)です。もし [スコープ付き API キー](https://docs.roboflow.com/reference/authentication/authentication/scoped-api-keys) をフォルダ制限付きで使用すると、エージェントはそのフォルダ範囲内のワークフローとモデルにのみアクセスでき、フォルダ外のプロジェクトは見えません。エージェントにワークスペースのモデル一覧を求めると、呼び出し元がすでに見えるモデルだけが返されます。

### チャット

エージェントにメッセージを送信します。新しい会話を始めるか、次を渡して既存の会話を継続できます `conversation_id`.

{% openapi src="/files/8a54e6ff076fb3a16ed8efea3adc214ee711d1cd" path="/{workspace}/agent/chat" method="post" %}
[agent-api.yaml](https://2537277549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-fe7368626d50bfa1cbdc6309c07567b2b9391c85%2Fagent-api.yaml?alt=media)
{% endopenapi %}

### ワークフローを公開

エージェントが作成または編集したワークフローの最新下書きをデプロイします。

{% openapi src="/files/8a54e6ff076fb3a16ed8efea3adc214ee711d1cd" path="/{workspace}/agent/workflows/{workflowUrl}/publish" method="post" %}
[agent-api.yaml](https://2537277549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-fe7368626d50bfa1cbdc6309c07567b2b9391c85%2Fagent-api.yaml?alt=media)
{% endopenapi %}

### 会話一覧

{% openapi src="/files/8a54e6ff076fb3a16ed8efea3adc214ee711d1cd" path="/{workspace}/agent/conversations" method="get" %}
[agent-api.yaml](https://2537277549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-fe7368626d50bfa1cbdc6309c07567b2b9391c85%2Fagent-api.yaml?alt=media)
{% endopenapi %}

### 会話を取得

{% openapi src="/files/8a54e6ff076fb3a16ed8efea3adc214ee711d1cd" path="/{workspace}/agent/conversations/{id}" method="get" %}
[agent-api.yaml](https://2537277549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-fe7368626d50bfa1cbdc6309c07567b2b9391c85%2Fagent-api.yaml?alt=media)
{% endopenapi %}

## MCP サーバー

あなたの AI エージェントを [MCP サーバー](/get-started/ja/jento/mcp-server.md) に接続すると、次のツールを使って Roboflow Agent に作業を引き継げます：

<table data-search="false"><thead><tr><th width="290">ツール</th><th>説明</th></tr></thead><tbody><tr><td><code>agent_chat</code></td><td>Roboflow AI エージェントとチャットします。</td></tr><tr><td><code>agent_chat_result</code></td><td>まだ実行中だった処理の結果を取得します。</td></tr><tr><td><code>agent_conversations_list</code></td><td>ワークスペース内のエージェント会話を一覧表示します。</td></tr><tr><td><code>agent_conversation_get</code></td><td>1 件の会話とそのメッセージ履歴を取得します。</td></tr><tr><td><code>agent_workflow_publish</code></td><td>エージェントが編集したワークフローの最新下書きを公開します。</td></tr></tbody></table>
