> 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/deployment/ko/monitoring-and-analytics/vision-events/get-custom-metadata-schema.md).

# 사용자 지정 메타데이터 스키마 가져오기

사용 사례의 Vision Event 전반에 사용되는 사용자 지정 메타데이터 필드와 유형을 검색합니다.

## 개요

이 엔드포인트는 지정된 [Vision Events](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events.md) 내에서 사용된 사용자 지정 메타데이터 필드를 반환합니다. 지정된 [Use Case](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/use-cases.md)에 따라 사용자 지정 메타데이터가 고정 스키마가 아닌 이벤트별로 정의되므로, 이를 사용해 존재하는 필드와 유형을 확인한 후 [이벤트 쿼리](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/query-events.md) 또는 대시보드 필터를 구성하세요.

## HTTP API

지정된 사용 사례의 이벤트에서 사용된 사용자 지정 메타데이터 필드의 스키마를 가져옵니다. 이를 통해 [쿼리 요청](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/query-events.md#http-api).

**필수 범위:** `vision-events:read` 또는 `device:read`

{% openapi src="/files/07bb573a8b2a5a268b550bc4e2d87e5feae31c5d" path="/vision-events/custom-metadata-schema/{useCaseId}" method="get" %}
[openapi.yaml](https://1826078061-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-0988c6c6c600d725f72d1ecfe0cbeba9b717363f%2Fopenapi.yaml?alt=media)
{% endopenapi %}

## Python SDK

에서 필터링에 사용할 수 있는 메타데이터 필드를 확인할 수 있습니다. 지정된 사용 사례의 이벤트에서 사용된 사용자 지정 메타데이터 필드를 확인합니다. 이는 다음을 사용해 쿼리를 작성하는 데 유용합니다. `customMetadataFilters`.

```python
import roboflow

roboflow.login()

rf = roboflow.Roboflow()
ws = rf.workspace()

schema = ws.get_vision_event_metadata_schema("a1b3c8e1")

for field, info in schema["fields"].items():
    print(f"{field}: {info['types']}")
```

응답에는 `fields` 키가 발견된 각 필드 이름을 관찰된 유형에 매핑하는 dict가 포함됩니다(예: `["string"]`, `["number"]`). 이 정보를 사용하면 [이벤트를 쿼리할 때](https://docs.roboflow.com/deployment/ko/monitoring-and-analytics/vision-events/query-events.md#python-sdk):

```python
page = ws.query_vision_events(
    "a1b3c8e1",
    customMetadataFilters=[
        {"field": "temperature", "operator": "gt", "value": 70, "type": "number"}
    ],
)
```

자세한 내용은 [REST API 참조 문서](#http-api).

## MCP 서버

AI 에이전트를 [MCP Server](https://docs.roboflow.com/agents/mcp-server) 에 연결하면 다음 도구를 사용해 사용자 지정 메타데이터 스키마를 읽을 수 있습니다:

<table data-search="false"><thead><tr><th width="290">도구</th><th>설명</th></tr></thead><tbody><tr><td><code>vision_events_custom_metadata_schema_get</code></td><td>사용 사례에서 검색된 사용자 지정 메타데이터 스키마를 가져옵니다.</td></tr></tbody></table>
