> 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/ko/agents/roboflow-agent.md).
# Roboflow Agent
워크플로와 Rapid 모델을 만들고, 실행하고, 디버깅하며, HTTP 채팅 API도 제공합니다.
## 정보
Roboflow Agent는 귀하의 [워크스페이스](/get-started/ko/platform/workspaces/key-concepts.md) 그리고 생성, 편집, 실행, 디버깅할 수 있는 [워크플로](https://docs.roboflow.com/workflows). 또한 이를 사용하여 설정할 수도 있습니다 [Rapid](https://docs.roboflow.com/models/rapid/rapid) 모델입니다. 워크스페이스의 왼쪽 사이드바에서 "Agent"를 클릭하여 Agent에 액세스하세요.
### 기능
Agent는 다음과 함께 작업할 수 있습니다:
* [워크플로](https://docs.roboflow.com/workflows): 일반 설명으로부터 빌드하고, 이미지, RTSP 스트림, 비디오 또는 웹캠에서 실행하고, 요청한 비디오 부분만 실행하며, 실시간 미리보기를 보고, 실패를 자동 수정하고, 실행 오류를 조사하고, 감지 영역을 그립니다.
* 첨부 미디어: 채팅에 드롭한 이미지와 MP4 또는 MOV 동영상을 분석하고, 이를 사용해 워크플로를 빌드하고 검증합니다.
* 이미지 생성: 아직 사진이 없을 때 텍스트 설명으로 1\~10장의 이미지를 생성합니다. Agent는 생성하도록 요청하면 시작됩니다. 견적을 원하면 먼저 가격을 문의하세요. 각 이미지는 귀하의 [자산 라이브러리](/get-started/ko/platform/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): 자산 라이브러리의 이미지에 대해 게시된 워크플로를 실행하고, 채팅에서 새 작업을 설정하며, 작업 목록을 보여주고, 하나의 상태를 보고합니다.
* [능동 학습](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/ko/platform/billing-and-plans/credits/view-credit-usage.md) 질문에 맞는 필터로.
* 엣지 디바이스: 귀하의 ...에 대한 읽기 전용 액세스로 질문에 답하고 [배포 관리자](https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager) 플릿, 원격 측정, 로그, 스트림에 대해.
* 탭: 열려 있는 워크플로, 모델, 프로젝트, 사용량 보기를 정리하고, 드래그하여 순서를 바꾸며, 닫힌 항목을 다시 열거나 "+" 탭에서 새 항목을 생성합니다.
### 백그라운드 작업
Agent가 시작한 긴 작업은 채팅하는 동안 계속 실행됩니다: 모델 학습, Universe 데이터셋 복사, 자동 라벨링, 데이터셋 버전 생성, 프로젝트 병합, 클래스 재매핑, 분할 재조정, 배치 처리 작업. 채팅 상자 위의 알약 모양 표시가 실행 중인 작업 수를 셉니다. 이를 클릭하거나 왼쪽 메뉴에서 "Background Tasks"를 클릭하면 "Running"과 "Finished" 아래에 목록이 표시되는 패널이 열립니다. 작업을 클릭하여 생성된 페이지를 엽니다.
탭을 닫았다가 나중에 돌아오더라도 작업이 완료되면 Agent가 채팅에서 알려줍니다. 대화 안에서 시작된 작업만 여기에 표시됩니다. 앱의 다른 곳이나 API를 통해 시작한 학습은 표시되지 않으며, 대신 Activity Center에서 추적합니다.
## HTTP API
Agent API를 사용하면 Roboflow AI agent와 다음을 통해 상호작용할 수 있습니다 `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/0e5638be82bf2745ff3620eb2bd9f5a98dedf9b1" path="/{workspace}/agent/chat" method="post" %}
[agent-api.yaml](https://83860450-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/0e5638be82bf2745ff3620eb2bd9f5a98dedf9b1" path="/{workspace}/agent/workflows/{workflowUrl}/publish" method="post" %}
[agent-api.yaml](https://83860450-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/0e5638be82bf2745ff3620eb2bd9f5a98dedf9b1" path="/{workspace}/agent/conversations" method="get" %}
[agent-api.yaml](https://83860450-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/0e5638be82bf2745ff3620eb2bd9f5a98dedf9b1" path="/{workspace}/agent/conversations/{id}" method="get" %}
[agent-api.yaml](https://83860450-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 agent를 다음에 연결하면 [MCP 서버](/get-started/ko/agents/mcp-server.md) 그리고 다음 도구로 Roboflow Agent에 작업을 넘길 수 있습니다:
