Roboflow Agent

Workflows와 Rapid 모델을 만들고, 실행하고, 디버깅하는 앱 내 Roboflow Agent와 그 HTTP 채팅 API입니다.

소개

Roboflow Agent는 귀하의 워크스페이스 그리고 생성, 편집, 실행, 디버그할 수 있습니다 워크플로. 또한 이를 사용하여 설정할 수도 있습니다 Rapid 모델. 워크스페이스의 왼쪽 사이드바에서 "Agent"를 클릭하여 에이전트에 액세스하세요.

기능

에이전트는 다음과 함께 작업할 수 있습니다:

워크플로: 일반 설명으로부터 생성하고, 이미지, RTSP 스트림, 비디오 또는 웹캠에서 실행하며, 실시간 미리보기를 확인하고, 실패를 자동 수정하고, 실행 오류를 조사하고, 탐지 영역을 그립니다.
첨부된 미디어: 채팅에 드롭한 이미지와 MP4 또는 MOV 비디오를 분석하고, 이를 사용해 워크플로를 생성하고 검증합니다.
Rapid 모델: 학습 실패를 설정, 관리 및 진단합니다.
프로젝트: 프로젝트 생성, 시작 모델 학습, 분할 재조정, 그리고 프로젝트 병합.
데이터세트: 라벨링 단계별로 이미지를 찾아보기, 워크스페이스의 이미지를 모델에 추가하고 라벨링을 시작합니다, 배치를 검토로 보내거나 수정용으로 되돌리고, 이미지를 데이터세트에 수락하고, 작업을 미지정으로 되돌립니다.
배치 처리: 자산 라이브러리의 이미지에 게시된 워크플로를 실행하고, 작업 목록을 표시하며, 특정 작업의 상태를 보고합니다.
액티브 러닝: 프로젝트별로 수집을 켜거나 끄고, 제한과 조건을 편집합니다.
비전 이벤트: 워크플로에 블록을 추가하고, 이벤트 데이터에 대한 질문에 답하고, 그리고 예약합니다 요약 보고서.
사용량: 귀하의 크레딧 사용량 대시보드 질문에 맞는 필터로.
엣지 디바이스: 다음에 대한 읽기 전용 액세스로 질문에 답하고 배포 관리자 플릿, 텔레메트리, 로그, 스트림.
탭: 열려 있는 워크플로, 모델, 프로젝트, 사용량 보기를 정리하고, 드래그하여 순서를 바꾸며, 닫은 항목을 다시 열거나 "+" 탭에서 새 항목을 만드세요.

백그라운드 작업

에이전트가 시작한 긴 작업은 채팅 중에도 계속 실행됩니다: 모델 학습, 자동 라벨링, 데이터세트 버전 생성, 프로젝트 병합, 클래스 재매핑, 분할 재조정, 배치 처리 작업. 채팅 상자 위의 배지가 실행 중인 작업 수를 표시합니다. 이를 클릭하거나 왼쪽 메뉴에서 "백그라운드 작업"을 클릭하면 "실행 중"과 "완료됨" 아래에 작업을 나열하는 패널이 열립니다. 작업을 클릭하면 생성된 페이지가 열립니다.

에이전트는 작업이 끝나면 탭을 닫았다가 나중에 다시 와도 채팅에서 알려줍니다. 대화 내부에서 시작된 작업만 여기에 표시됩니다. 앱의 다른 곳이나 API를 통해 시작한 학습은 여기에 표시되지 않으며, 대신 활동 센터에서 추적합니다.

HTTP API

Agent API를 사용하면 Roboflow AI 에이전트와 다음을 통해 상호작용할 수 있습니다 api.roboflow.com. 자연어 지침을 보내 생성하거나 편집할 수 있습니다 워크플로, 그런 다음 준비되면 게시할 수 있습니다. 모든 편집 내용은 직접 게시할 때까지 초안으로 저장됩니다.

인증은 다음을 통해 이루어집니다 API 키. 다음을 사용하면 범위 지정 API 키 와 폴더 제한을 사용하면 에이전트는 해당 폴더 범위 내의 워크플로와 모델에만 접근할 수 있으며, 폴더 밖에 있는 프로젝트는 볼 수 없습니다. 에이전트에게 워크스페이스 모델 목록을 요청하면 호출자가 이미 볼 수 있는 모델만 반환됩니다.

채팅

에이전트에게 메시지를 보내세요. 새 대화를 시작하거나 다음을 전달하여 기존 대화를 이어가세요 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.

Path parameters

workspacestringRequired

Workspace URL slug.

Example: my-workspace

Body

api_keystringRequired

Workspace API key.

messagestringRequired

The instruction or question for the agent.

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

conversation_idstringOptional

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

Example: conv_xyz789

modestring · enumOptional

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

Default: agentPossible values:

Responses

200

The agent's reply.

application/json

textstringOptional

The agent's response text.

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

conversation_idstringOptional

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"
}

워크플로 게시

에이전트가 생성하거나 편집한 워크플로의 최신 초안을 배포합니다.

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.

Path parameters

workspacestringRequired

Workspace URL slug.

Example: my-workspace

workflowUrlstringRequired

Workflow URL slug.

Example: car-counter

Query parameters

api_keystringRequired

Workspace API key.

Responses

200

The draft was published.

application/json

workflowIdstringOptionalExample: wf_abc123

workflowUrlstringOptionalExample: car-counter

versionIdstringOptionalExample: v-1700000000

statusstringOptionalExample: 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.

Path parameters

workspacestringRequired

Workspace URL slug.

Example: my-workspace

Query parameters

api_keystringRequired

Workspace API key.

sourcestring · enumOptional

Filter by origin: api or web.

Possible values:

workflowstringOptional

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

Responses

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.

Path parameters

workspacestringRequired

Workspace URL slug.

Example: my-workspace

idstringRequired

Conversation ID.

Example: conv_xyz789

Query parameters

api_keystringRequired

Workspace API key.

Responses

200

The conversation with its messages.

application/json

idstringOptionalExample: conv_xyz789

namestringOptionalExample: Car Counter

sourcestring · enumOptional

Where the conversation started: api or web.

Example: apiPossible values:

workflowIdsstring[]Optional

IDs of Workflows referenced by the conversation.

Example: ["wf_abc123"]

created_onstring · date-timeOptionalExample: 2026-05-14T20:00:00.000Z

updated_onstring · date-timeOptionalExample: 2026-05-14T20:05:00.000Z

typestringOptionalExample: 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_chat_result

아직 진행 중이던 실행의 결과를 수집합니다.

agent_conversations_list

워크스페이스의 에이전트 대화를 나열합니다.

agent_conversation_get

메시지 기록이 포함된 대화 하나를 가져옵니다.

agent_workflow_publish

에이전트가 편집한 워크플로의 최신 초안을 게시합니다.

이전MCP 서버

다음워크스페이스

마지막 업데이트 4일 전

도움이 되었나요?