Roboflow Agent

Workflows と Rapid モデルを構築、実行、デバッグするアプリ内 Roboflow Agent。HTTP チャット API も含みます。

概要

Roboflow Agent はあなたのワークスペースを作成、編集、実行、デバッグできますワークフロー。また、これを使って設定することもできます Rapid モデルです。ワークスペースの左サイドバーで「Agent」をクリックして Agent にアクセスできます。

機能

Agent は次のものを扱えます:

ワークフロー：平易な説明から作成し、画像、RTSP ストリーム、動画、またはウェブカメラで実行し、ライブプレビューを確認し、失敗を自動修復し、実行エラーを調査し、検出ゾーンを描画できます。
添付メディア：チャットにドロップした画像や MP4/MOV 動画を分析し、それらを使ってワークフローを作成・検証できます。
Rapid モデル：セットアップ、管理、トレーニング失敗の診断。
プロジェクト：プロジェクトを作成、開始モデルのトレーニング, 分割の再調整、およびプロジェクトを統合.
データセット：ラベリング段階ごとに画像を閲覧, ワークスペースの画像をモデルに追加し、ラベリングを開始、バッチをレビューに送るか編集のために戻し、画像をデータセットに受け入れ、作業を未割り当てに戻します。
バッチ処理：Asset Library の画像に対して公開済みのワークフローを実行し、ジョブを一覧表示し、1件のステータスを報告します。
アクティブラーニング：プロジェクトごとに収集のオン/オフを切り替え、その制限と条件を編集します。
ビジョンイベント：ワークフローにブロックを追加し、イベントデータについての質問に答え、およびスケジュールサマリーレポート.
使用状況：あなたのクレジット使用量ダッシュボードを表示します。質問に合ったフィルター付きで。
エッジデバイス：あなたのデプロイメントマネージャーフリート、テレメトリ、ログ、ストリームへの読み取り専用アクセスで質問に答えます。
タブ：開いているワークフロー、モデル、プロジェクト、使用状況ビューを整理し、ドラッグで並べ替え、閉じた項目を再度開くか、「+」タブから新規作成できます。

バックグラウンドタスク

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

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

HTTP API

Agent API を使うと、Roboflow AI agent と次を通じて対話できます api.roboflow.com。自然言語の指示を送って作成または編集できますワークフロー、その後、準備ができたら公開できます。明示的に公開するまで、すべての編集は下書きとして保存されます。

認証は次を通じて行われます API キー。もしスコープ付き API キーにフォルダー制限がある場合、agent はそのフォルダー範囲内のワークフローとモデルにのみアクセスでき、フォルダー外のプロジェクトは表示されません。agent にワークスペースのモデル一覧を要求すると、呼び出し元がすでに閲覧できるモデルのみが返されます。

チャット

Agent にメッセージを送信します。新しい会話を開始するか、次を渡して既存の会話を続けます conversation_id.

Chat with the agent

post

Send a message to the agent. The agent can create new Workflows, edit existing ones, and answer questions about your workspace. Workflow changes are saved as drafts. Requires the workflow:create and workflow:update scopes.

パスパラメータ

workspacestring必須

Workspace URL slug.

Example: my-workspace

本文

api_keystring必須

Workspace API key.

messagestring必須

The instruction or question for the agent.

Example: Build me a workflow that detects cars and counts them

conversation_idstringオプション

ID of an existing conversation to continue. Omit to start a new conversation.

Example: conv_xyz789

modestring · enumオプション

agent (default) makes changes. In plan mode the agent outlines what it would do without making changes.

Default: agent可能な値:

レスポンス

200

The agent's reply.

application/json

textstringオプション

The agent's response text.

Example: I created a workflow called 'Car Counter' that detects and counts cars.

conversation_idstringオプション

The conversation ID. Pass it back in later requests to continue the conversation.

Example: conv_xyz789

400

Bad request (ex: missing message, no draft to publish).

application/json

401

API key missing or invalid.

application/json

402

Insufficient credits.

application/json

403

Insufficient scopes, Workflow outside the API key's folder scope, or agent features disabled for the workspace (error_type AGENT_DISABLED).

application/json

404

Workflow or conversation not found.

application/json

500

Internal server error.

application/json

post/{workspace}/agent/chat

POST /{workspace}/agent/chat HTTP/1.1
Host: api.roboflow.com
Content-Type: application/json
Accept: */*
Content-Length: 131

{
  "api_key": "text",
  "message": "Build me a workflow that detects cars and counts them",
  "conversation_id": "conv_xyz789",
  "mode": "agent"
}

{
  "text": "I created a workflow called 'Car Counter' that detects and counts cars.",
  "workflows": [
    {
      "id": "wf_abc123",
      "name": "Car Counter",
      "url": "car-counter",
      "specification": {}
    }
  ],
  "conversation_id": "conv_xyz789"
}

ワークフローを公開

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

Publish a Workflow

post

Deploy the latest draft version of a Workflow that the agent created or edited. Returns 400 if there is no unpublished draft. Requires the workflow:update scope.

パスパラメータ

workspacestring必須

Workspace URL slug.

Example: my-workspace

workflowUrlstring必須

Workflow URL slug.

Example: car-counter

クエリパラメータ

api_keystring必須

Workspace API key.

レスポンス

200

The draft was published.

application/json

workflowIdstringオプションExample: wf_abc123

workflowUrlstringオプションExample: car-counter

versionIdstringオプションExample: v-1700000000

statusstringオプションExample: published

400

Bad request (ex: missing message, no draft to publish).

application/json

401

API key missing or invalid.

application/json

403

Insufficient scopes, Workflow outside the API key's folder scope, or agent features disabled for the workspace (error_type AGENT_DISABLED).

application/json

404

Workflow or conversation not found.

application/json

500

Internal server error.

application/json

post/{workspace}/agent/workflows/{workflowUrl}/publish

POST /{workspace}/agent/workflows/{workflowUrl}/publish?api_key=text HTTP/1.1
Host: api.roboflow.com
Accept: */*

{
  "workflowId": "wf_abc123",
  "workflowUrl": "car-counter",
  "versionId": "v-1700000000",
  "status": "published"
}

会話一覧

List conversations

get

Return all agent conversations in the workspace. Requires the workflow:read scope.

パスパラメータ

workspacestring必須

Workspace URL slug.

Example: my-workspace

クエリパラメータ

api_keystring必須

Workspace API key.

sourcestring · enumオプション

Filter by origin: api or web.

可能な値:

workflowstringオプション

Filter by Workflow URL slug. Only returns conversations that reference this Workflow.

レスポンス

200

The workspace's conversations.

application/json

401

API key missing or invalid.

application/json

403

Insufficient scopes, Workflow outside the API key's folder scope, or agent features disabled for the workspace (error_type AGENT_DISABLED).

application/json

500

Internal server error.

application/json

get/{workspace}/agent/conversations

GET /{workspace}/agent/conversations?api_key=text HTTP/1.1
Host: api.roboflow.com
Accept: */*

{
  "conversations": [
    {
      "id": "conv_xyz789",
      "name": "Car Counter",
      "source": "api",
      "workflowIds": [
        "wf_abc123"
      ],
      "created_on": "2026-05-14T20:00:00.000Z",
      "updated_on": "2026-05-14T20:05:00.000Z"
    }
  ]
}

会話を取得

Get a conversation

get

Return the full conversation including all messages. Requires the workflow:read scope.

パスパラメータ

workspacestring必須

Workspace URL slug.

Example: my-workspace

idstring必須

Conversation ID.

Example: conv_xyz789

クエリパラメータ

api_keystring必須

Workspace API key.

レスポンス

200

The conversation with its messages.

application/json

idstringオプションExample: conv_xyz789

namestringオプションExample: Car Counter

sourcestring · enumオプション

Where the conversation started: api or web.

Example: api可能な値:

workflowIdsstring[]オプション

IDs of Workflows referenced by the conversation.

Example: ["wf_abc123"]

created_onstring · date-timeオプションExample: 2026-05-14T20:00:00.000Z

updated_onstring · date-timeオプションExample: 2026-05-14T20:05:00.000Z

typestringオプションExample: agent

401

API key missing or invalid.

application/json

403

Insufficient scopes, Workflow outside the API key's folder scope, or agent features disabled for the workspace (error_type AGENT_DISABLED).

application/json

404

Workflow or conversation not found.

application/json

500

Internal server error.

application/json

get/{workspace}/agent/conversations/{id}

GET /{workspace}/agent/conversations/{id}?api_key=text HTTP/1.1
Host: api.roboflow.com
Accept: */*

{
  "id": "conv_xyz789",
  "name": "Car Counter",
  "source": "api",
  "workflowIds": [
    "wf_abc123"
  ],
  "created_on": "2026-05-14T20:00:00.000Z",
  "updated_on": "2026-05-14T20:05:00.000Z",
  "type": "agent",
  "messages": [
    {
      "id": "msg_1",
      "role": "user",
      "parts": [
        {
          "type": "text",
          "text": "Build me a workflow that detects cars"
        }
      ]
    }
  ]
}

MCP サーバー

あなたの AI エージェントを次に接続すると MCP サーバー、次のツールで Roboflow Agent に作業を引き継げます：

ツール

説明

agent_chat

Roboflow AI agent とチャットします。

agent_chat_result

実行中だった処理の結果を取得します。

agent_conversations_list

ワークスペース内の agent の会話を一覧表示します。

agent_conversation_get

メッセージ履歴付きで会話を1件取得します。

agent_workflow_publish

Agent が編集したワークフローの最新下書きを公開します。

前へMCP Server

次へワークスペース

最終更新 4 日前

役に立ちましたか？