Search Anomaly Results tool

원문 보기 위키 갱신 2026.10.14

출처: 문서

본문

Search Anomaly Results 도구

2.13에서 도입됨 {: .label .label-purple }

SearchAnomalyResultsTool은 이상 탐지기 결과에 대한 정보를 검색합니다. 이상 탐지기에 대한 자세한 내용은 이상 탐지를 참조하세요.

1단계: SearchAnomalyResultsTool을 실행할 플로우 에이전트 등록

플로우 에이전트는 일련의 도구를 순서대로 실행하고 마지막 도구의 출력을 반환합니다. 플로우 에이전트를 생성하려면 다음 등록 에이전트 요청을 보내세요.

POST /_plugins/_ml/agents/_register
{
  "name": "Test_Agent_For_Search_Anomaly_Results_Tool",
  "type": "flow",
  "description": "this is a test agent for the SearchAnomalyResultsTool",
  "memory": {
    "type": "demo"
  },
  "tools": [
    {
      "type": "SearchAnomalyResultsTool",
      "name": "DemoSearchAnomalyResultsTool",
      "parameters": {}
    }
  ]
}

{% include copy-curl.html %}

매개변수 설명은 등록 매개변수를 참조하세요.

OpenSearch는 에이전트 ID로 응답합니다.

{
  "agent_id": "HuJZYo0B9RaBCvhuUlpy"
}

2단계: 에이전트 실행

에이전트를 실행하려면 다음 요청을 보내세요.

POST /_plugins/_ml/agents/HuJZYo0B9RaBCvhuUlpy/_execute
{
  "parameters": {
    "question": "Do I have any anomalies?"
  }
}

{% include copy-curl.html %}

OpenSearch는 클러스터에 설정된 개별 이상 탐지기 목록(각 결과에는 탐지기 ID, 이상 등급, 신뢰 수준이 포함됨)과 발견된 이상 결과의 총 개수로 응답합니다.

{
  "inference_results": [
    {
      "output": [
        {
          "name": "response",
          "result": "AnomalyResults=[{detectorId=ef9lYo0Bk4MTqircmjnm,grade=1.0,confidence=0.9403051246569198}{detectorId=E-JlYo0B9RaBCvhunFtw,grade=1.0,confidence=0.9163498216870274}]TotalAnomalyResults=2"
        }
      ]
    }
  ]
}

이상이 발견되지 않으면 OpenSearch는 결과에 빈 배열로 응답합니다.

{
  "inference_results": [
    {
      "output": [
        {
          "name": "response",
          "result": "AnomalyResults=[]TotalAnomalyResults=0"
        }
      ]
    }
  ]
}

등록 매개변수

다음 표는 에이전트를 등록할 때 사용할 수 있는 모든 도구 매개변수를 나열합니다. 모든 매개변수는 선택 사항입니다.

매개변수	유형	설명
`detectorId`	String	결과를 반환할 탐지기의 ID입니다.
`realTime`	Boolean	실시간 이상 탐지기 결과를 반환할지 여부입니다. 이 매개변수를 `false`로 설정하면 기록 분석 결과만 반환합니다.
`anomalyGradeThreshold`	Float	반환된 이상 탐지기 결과의 최소 이상 등급입니다. 이상 등급은 데이터 포인트가 얼마나 이상한지를 나타내는 0과 1 사이의 숫자입니다.
`dataStartTime`	Long	이상 탐지기 결과를 반환할 가장 이른 시간(에포크 밀리초)입니다.
`dataEndTime`	Long	이상 탐지기 결과를 반환할 가장 늦은 시간(에포크 밀리초)입니다.
`sortOrder`	String	결과의 정렬 순서입니다. 유효한 값은 `asc`(오름차순) 및 `desc`(내림차순)입니다. 기본값은 `desc`입니다.
`sortString`	String	결과를 정렬할 탐지기 필드를 지정합니다. 기본값은 `data_start_time`입니다.
`size`	Integer	반환할 결과 수입니다. 기본값은 `20`입니다.
`startIndex`	Integer	시작할 결과의 페이지 인덱스입니다. 기본값은 `0`입니다.

실행 매개변수

다음 표는 에이전트를 실행할 때 사용할 수 있는 모든 도구 매개변수를 나열합니다.

매개변수	유형	필수/선택	설명
`question`	String	필수	LLM에 보낼 자연어 질문입니다.

도구 테스트

이 도구는 에이전트 워크플로의 일부로 실행하거나 Execute Tool API를 사용하여 독립적으로 실행할 수 있습니다. Execute Tool API는 개별 도구를 테스트하거나 독립 실행형 작업을 수행하는 데 유용합니다.

더 알아보기 (Learn more)

원문 전체: https://docs.opensearch.org/latest/ml-commons-plugin/agents-tools/tools/search-anomaly-results/