> 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

Workflowsと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」をクリックすると、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>

### 機能

Agent は以下を扱えます：

* [ワークフロー](https://docs.roboflow.com/workflows)：平易な説明から構築し、画像、RTSP ストリーム、動画、またはウェブカメラで実行し、指定した動画の一部だけを実行し、ライブプレビューを確認し、自動で失敗を修正し、実行エラーを調査し、検出ゾーンを描画します。
* 添付メディア：チャットに追加した画像や MP4 または MOV 動画を分析し、それらを使ってワークフローを構築・検証します。
* 画像生成：まだ写真がない場合でも、テキスト説明から 1〜10 枚の画像を生成します。Agent は生成を依頼したときに開始します。見積もりが欲しい場合は、先に価格を尋ねてください。各画像はあなたの [アセットライブラリ](/get-started/ja/purattofmu/workspaces/asset-library.md)に保存され、保存された画像に対してのみ料金が発生します。Agent はあなた自身の画像を参照として使用できません。
* [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).
* Universe データセット： [Universe](https://docs.roboflow.com/datasets/universe/universe/what-is-roboflow-universe)上の公開データセットを見つけ、比較し、 [データセット全体または指定枚数の画像をコピーする](https://docs.roboflow.com/datasets/universe/universe/fork-a-universe-dataset#roboflow-agent) をプロジェクトに取り込みます。Agent が何かをコピーする前に、チャット内でソース、画像数、クラス変更について合意します。
* データセット： [ラベリング段階ごとに画像を閲覧する](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)、バッチをレビューに送るか編集のために戻し、Review で画像を承認または却下し（ジョブ数と画像数を確認した後）、画像をデータセットに取り込み、作業を未割り当てに戻します。
* [バッチ処理](https://docs.roboflow.com/deployment/roboflow-cloud/batch-processing)：Asset Library 内の画像に対して公開済みのワークフローを実行し、チャットで新しいジョブを設定し、ジョブ一覧を表示し、1 件の状態を報告します。
* [アクティブラーニング](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) フリート、テレメトリ、ログ、ストリームへの読み取り専用アクセスで質問に答えます。
* タブ：開いているワークフロー、モデル、プロジェクト、使用状況ビューを整理し、ドラッグで並べ替え、閉じた項目を再度開いたり、「+」タブから新規作成したりできます。

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

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

タスクが完了すると、タブを閉じて後で戻ってきた場合でも、Agent はチャットで通知します。ここに表示されるのは、会話の中から開始されたジョブだけです。アプリの他の場所や 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) をフォルダ制限付きで使用すると、Agent はそのフォルダ範囲内のワークフローとモデルにのみアクセスでき、フォルダ外にあるプロジェクトは表示されません。Agent にワークスペースのモデル一覧を求めると、呼び出し元がすでに見られるモデルのみが返されます。

### チャット

Agent にメッセージを送信します。新しい会話を開始するか、 `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 %}

### を渡して既存の会話を続けます。

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

{% 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>Agent が編集したワークフローの最新下書きを公開します。</td></tr></tbody></table>
