에이전트#
에이전트는 시각적 워크플로에서 이미지, 모델, 조건 및 작업을 연결합니다. YOLO를 사용하여 더 자세히 살펴봐야 할 이미지를 결정하고, 비전 언어 모델에 설명을 요청하거나, 검토를 위해 선택한 이미지를 데이터셋에 수집할 수 있습니다.
사이드바의 워크스페이스 선택기를 사용하여 개인 워크스페이스로 전환하고 설정 > 프로필에서 조기 액세스를 활성화합니다. 그런 다음 사이드바에서 에이전트를 열거나 platform.ultralytics.com/agents로 이동합니다. 조기 액세스는 팀 워크스페이스에서 작업할 때를 포함하여 개인별 설정 사항입니다.
첫 번째 워크플로 실행하기#
- 에이전트를 열고 블록 추가 > 템플릿을 클릭한 다음 YOLO → VLM 모니터를 선택합니다.
- 입력 이미지 블록을 선택하고 업로드된 데이터셋을 선택한 다음 사람이 포함된 이미지를 선택합니다. 공유 체험판에는 최대 4 메가픽셀의 이미지를 사용합니다.
- 기본 YOLO26 나노 모델을 유지합니다. YOLO가 한 명 이상의 사람을 감지하면 조건이 통과됩니다.
- 장면 설명을 선택하고 비전 언어 모델을 선택한 다음 프롬프트를 입력합니다. 아직 추가하지 않았다면 설정 > API 키에서 해당 제공자 키 추가를 수행합니다. 팀 워크스페이스인 경우 워크스페이스 소유자에게 제공자 키를 추가하거나 교체해 달라고 요청합니다.
- 소규모 실행을 위해 공유 체험판 · 60초가 선택된 상태로 유지하고 실행을 클릭합니다.
- 블록이 업데이트되는 것을 지켜보고 출력을 검사합니다. 사람이 감지되지 않으면 설명 분기를 실행하지 않고 조건이 완료됩니다.
저장하기 전에 초안을 실행할 수 있습니다. 워크플로 저장을 사용하여 나중에 사용할 수 있도록 워크플로의 이름을 지정하고 저장하며, 변경 후 다시 저장합니다. Python 버튼은 생성된 워크플로 코드를 보여줍니다.
템플릿으로 시작하기#
| 템플릿 | Workflow | 용도 |
|---|---|---|
| YOLO → VLM 모니터 | 이미지 → YOLO → 조건 → 비전 언어 모델 → 출력 | 사람이 감지된 경우에만 장면 설명하기 |
| 불확실한 감지 결과 수집 | 데이터셋 → 배포 → 신뢰도 조건 → 데이터셋 | 불확실한 감지 결과가 포함된 이미지로부터 검토셋 구축 |
| 캡처 및 알림 | 이미지 → YOLO → 조건 → 데이터셋 및 Slack | 동일한 조건에서 이미지 저장 및 채널에 알림 전송 |
템플릿은 편집 가능한 시작점입니다. 템플릿을 실행하기 전에 워크스페이스에 맞는 이미지, 배포, 대상 데이터셋 및 통합을 선택합니다. 이러한 워크플로는 실행을 클릭할 때 실행되며, 모니터 템플릿은 선택한 입력 이미지를 분석합니다.
실행 위치 선택#
실행 옆의 실행 선택기는 워크플로에 사용할 하드웨어를 선택합니다.
| 선택 항목 | 용도 | 제한 및 가격 |
|---|---|---|
| 공유 체험판 · 60초 | 간단한 워크플로 테스트 | 최대 60초, 각각 최대 4 메가픽셀인 총 20개의 입력 이미지, 최대 20회의 모델/제공자 호출, 공식 YOLO26 나노 모델을 사용하는 하나의 로컬 YOLO 모델 |
| 기존 전용 배포 | 더 큰 데이터셋, 더 긴 실행 시간 또는 기타 로컬 모델 | 적격한 무료 전용 배포를 포함하여 해당 배포의 기존 하드웨어 및 가격 책정 사용, 전체 워크플로 지속 시간 또는 이미지 수 제한 없음 |
| 새 배포… | 빌더에서 전용 하드웨어 생성 | 기존 배포 생성 및 가격 책정 대화상자 열기, 리소스 선택 후 배포가 준비될 때까지 대기 |
공유 체험판은 5분당 두 번의 제출을 허용합니다. 플랫폼 실행은 최대 20개의 블록을 지원합니다. 모델/제공자 호출에는 YOLO, 비전 언어 모델, 배포 예측 및 Slack 작업이 포함되며, 분기로 인해 입력 이미지당 호출 수가 증가할 수 있습니다.
전용 실행은 선택된 배포에서 체크포인트가 지정된 요청으로 계속됩니다. 브라우저를 닫거나 새로고침해도 실행이 중지되지 않습니다. 기존 배포 제한 및 제공자 제한이 계속 적용되며, 언어 모델 사용량은 키에 연결된 제공자를 통해 청구됩니다. 하드웨어 옵션은 배포 가격을 참조하십시오.
배포 블록은 예측 단계에 사용되는 엔드포인트를 선택합니다. 실행 선택기는 워크플로 자체가 실행되는 위치를 선택합니다. 둘 다에 동일한 전용 배포를 선택할 수 있습니다.
블록 구성#
| 블록 | 목적 |
|---|---|
| 이미지 | 업로드된 데이터셋에서 이미지 하나 선택 |
| 수신 연결이 없는 데이터셋 | 선택한 데이터셋 및 분할에서 구성 가능한 입력 제한으로 이미지 읽기 |
| YOLO | 공식 모델 또는 워크스페이스의 학습된 모델 실행 |
| 배포 | 기존의 준비된 플랫폼 배포를 통해 예측 |
| LLM | 이미지 및 업스트림 컨텍스트를 선택한 언어 모델 또는 비전 언어 모델로 전송 |
| 게이트 | 조건 또는 주기로 다운스트림 실행 제어 |
| 수신 연결이 있는 데이터셋 | 수신 이미지를 대상 데이터셋에 추가 |
| Slack | 워크스페이스의 연결된 Slack 채널로 메시지 전송 |
| 내보내기 | 플랫폼의 기존 내보내기 워크플로를 사용하여 모델 내보내기 |
| 출력 | 업스트림 결과 표시 |
설정을 편집할 블록을 선택합니다. 결과를 다운스트림으로 전달하려면 출력을 다른 블록에 연결합니다. 하나의 출력을 여러 블록에 연결할 수 있습니다. 예를 들어 하나의 조건을 대상 데이터셋과 Slack 모두에 연결합니다. 각 분기는 동일한 평가된 조건을 사용합니다.
조건으로 감지 결과 필터링#
감지 수 및 신뢰도 필터에 동일한 게이트 블록을 사용합니다. 업스트림 결과, 임의의 클래스 또는 특정 클래스, 그리고 비교 방식을 선택합니다. 예:
- 사람 수 ≥ 1: 한 명 이상의 사람이 감지될 때 계속 진행합니다.
- 신뢰도 0.25에서 0.5 사이: 일치하는 감지 결과가 해당 양끝 포함 범위 내에 하나 이상 있을 때 계속 진행합니다.
- 신뢰도 범위 내의 특정 클래스: 해당 클래스에 대해서만 불확실한 감지 결과를 수집합니다.
신뢰도 필터는 개별 감지 결과를 검사합니다. 점수가 0.3 및 0.9인 이미지는 하나의 감지 결과가 일치하므로 0.25–0.5 범위를 통과합니다. 감지 결과가 없는 이미지는 신뢰도 조건을 통과하지 못합니다. 평가하려는 감지 결과를 유지할 수 있도록 충분히 낮은 예측 모델 신뢰도 임계값을 설정하십시오.
일치하지 않는 조건은 다운스트림 출력 없이 완료됩니다. 해당 이미지에 대해 연결된 작업이 실행되지 않습니다.
검토용 이미지 수집#
불확실한 감지 결과 수집을 열고 소스 데이터셋 및 분할을 선택하며 예측 배포를 선택하고 신뢰도 범위를 구성합니다. 최종 데이터셋 블록에서 기존 대상 데이터셋을 선택합니다. 필요한 경우 먼저 데이터셋 페이지에서 데이터셋을 생성하십시오.
대상은 train 분기에서 원본 이미지를 라벨 없이 수신합니다. 기존 복사본은 건너뛰며, 일반 데이터셋 저장 용량 할당량이 적용됩니다. 소스 라벨과 모델 예측은 어노테이션으로 복사되지 않습니다. 수집된 이미지를 검토하고 라벨을 지정하려면 기존 어노테이션 편집기에서 대상을 엽니다.
워크스페이스가 액세스할 수 있는 호스팅된 이미지와 편집할 수 있는 대상 데이터셋을 사용합니다. 연결된 클라우드 스토리지 및 온프레미스 데이터셋은 수집 대상으로 사용할 수 없습니다.
조건부 Slack 알림 전송#
설정 > 통합에서 Slack 연결을 수행한 다음 조건을 Slack 블록에 연결합니다. 메시지를 입력하고 {output}을 사용하여 업스트림 결과를 포함합니다. 캡처 및 알림은 또한 동일한 조건을 데이터셋에 연결하므로 일치하는 이미지가 수집되고 연결된 채널로 메시지가 전송됩니다.
워크플로 Slack 메시지는 블록에서 구성됩니다. 이는 설정의 학습, 내보내기 및 배포 알림 선택 사항과는 별개입니다.
진행 상황 추적 및 실행 중지#
활성 블록에는 초록색 스피너가 표시됩니다. 완료된 블록에는 초록색 체크표시와 초록색 윤곽선이 표시되고, 실패한 블록에는 빨간색 윤곽선이 표시됩니다. 카운트는 어떤 입력이 각 블록에 도달했는지 보여주며, 조건이 일치하지 않을 때 다운스트림 블록은 실행되지 않은 상태로 유지됩니다.
페이지를 새로 고치면 실행 진행 상황과 선택한 실행 배포가 복원됩니다. 완료된 결과는 일치하는 워크플로에 대해 계속 표시됩니다. 활성 실행을 취소하려면 중지를 클릭합니다. 취소는 실행 중인 블록이 취소 지점에 도달할 때까지 대기합니다. 실행 배포를 중지하거나 삭제해도 워크플로가 취소됩니다.
문제 해결#
- 사이드바에 에이전트가 누락된 경우: 개인 설정 > 프로필에서 조기 액세스를 활성화합니다.
- 실행이 공유 체험판 제한을 초과하는 경우: 적격한 무료 배포를 포함하여 전용 배포를 선택하거나 이미지 해상도, 입력 수, 모델/제공자 호출 수를 줄입니다.
- 배포가 준비 중이거나 중지된 경우: 준비될 때까지 기다리거나 배포에서 시작합니다.
- 제공자 키가 누락된 경우: 설정 > API 키에서 선택한 제공자 연결을 수행합니다. 팀 워크스페이스인 경우 워크스페이스 소유자에게 키를 추가하거나 교체해 달라고 요청합니다.
- 대상에 도달하는 이미지가 없는 경우: 조건 및 예측 신뢰도 임계값을 검사합니다. 빈 감지 결과는 신뢰도 범위를 만족하지 않습니다.
- 수집된 이미지에 라벨이 없는 경우: 수집 시 검토를 위해 원본 이미지가 추가됩니다. 라벨을 지정하려면 기존 어노테이션 도구를 사용합니다.