운영 에이전트 모범 사례 및 제한 사항

이 문서에서는 Real-Time Intelligence에서 작업 에이전트를 사용할 때의 모범 사례 및 제한 사항을 간략하게 설명합니다.

모범 사례

운영 에이전트는 조직이 실시간 데이터를 지속적으로 모니터링하고 명시적 임계값을 평가하며 정의된 조건이 충족될 때 작업을 권장하여 명확한 비즈니스 목표를 운영할 수 있도록 지원합니다. 예를 들어 작업 에이전트는 재고 가용성이 중요한 수준으로 떨어질 때 사전에 대응하는 데 도움이 됩니다. 작업 에이전트에 대해 다음 모범 사례를 사용합니다.

  • Eventhouse 테이블: Eventhouse 테이블에 JSON과 같은 중첩 열이 포함된 경우 에이전트를 구성하기 전에 테이블을 평면화합니다. 설명이 포함된 열 이름이 있는 플랫 테이블은 에이전트가 데이터를 구문 분석하고 평가하는 기능을 향상시킵니다.

  • Eventhouse 열 설명: 열의 용도가 이름에서 명확하지 않은 경우 KQL 테이블 스키마의 설명 필드를 사용하여 일반 언어 설명을 추가합니다. 이 설명은 에이전트가 데이터 값을 올바르게 해석하는 데 도움이 됩니다.

  • 수집 시간 열: 작업 에이전트는 기본적으로 테이블의 수집 시간을 사용하여 레코드가 도착한 시기를 식별합니다. 에이전트는 최신 데이터를 쿼리하고 시간이 지남에 따라 데이터의 변경 내용을 계산할 때 이 값을 사용합니다. 수집 시간 값이 입력되어 있는지 확인하세요.

  • 비즈니스 개체 식별: 에이전트가 스테이션, 센서 또는 직원 레코드와 같은 특정 비즈니스 개체를 모니터링해야 하는 경우 개체를 고유하게 식별하는 열(예 StationID : 또는 SensorID)을 식별합니다. KQL 데이터베이스 원본을 사용하는 경우 해당 데이터베이스가 속한 테이블을 지정합니다. 온톨로지 원본을 사용하는 경우 에이전트에서 사용해야 하는 엔터티를 지정합니다.

  • 필드 이름 따옴표: 규칙이 밑줄 또는 하이픈과 같은 특수 문자를 포함하는 열 또는 속성 이름을 참조하는 경우 열 이름을 따옴표("")로 묶습니다. 이 방법은 에이전트가 올바르게 식별하도록 합니다.

  • 정량화 가능한 조건: 규칙이 "저가용성" 또는 "고온"과 같은 정성적 언어를 사용하는 경우 특정 숫자 임계값으로 대체합니다.

    • 예를 들어 "3대 미만의 자전거 사용 가능" 또는 "온도가 80을 초과합니다"와 같은 구를 사용합니다. 에이전트는 기본 LLM 지식을 사용하여 "산성 조건"이 pH <7을 의미하는 것과 같은 일반적인 용어에 대한 임계값을 제안합니다.

  • 규칙 분리: 여러 규칙을 정의하는 경우 각 규칙을 별도의 줄 또는 글머리 기호 지점으로 설명합니다. 동일한 문장에서 다른 규칙의 조건을 결합하지 마세요.

  • 규칙 순서: 에이전트가 특정 규칙의 우선 순위를 지정해야 하는 경우 우선 순위가 높은 규칙을 먼저 나열합니다. LLM은 프롬프트의 위치에 따라 정보를 다르게 해석할 수 있습니다.

  • 에이전트 쿼리 및 데이터 액세스를 추적합니다. 모니터링되는 Eventhouse 또는 KQL 데이터베이스를 확인하여 에이전트가 사용하는 데이터 원본 및 쿼리를 검토합니다. 쿼리 인사이트 탭을 사용하여 실행된 쿼리를 보고 생성된 KQL의 유효성을 검사합니다.

    KQL 데이터베이스의 쿼리 인사이트 탭 스크린샷

샘플 지침

다음은 에이전트의 운영 규칙 및 데이터 필드에 대한 의미 체계 정보를 명확히 하기 위해 에이전트에 지침을 배치하는 방법의 예입니다.

*** Operational Instructions ***
1. Alert me when a trip has high occupancy level.
2. Alert me when a trip has high departure delay.

*** Semantic Instructions ***
1. Information about a trip can be found in 'TripUpdateFlattened' table, each identified by the 'trip_id' column.
2. Information about a vehicle can be found in 'VehiclePositionsFlat' table, each identified the 'vehicle_id' column.
3. A trip is a associated with multiple vehicles via shared trip ID.
4. Occupancy status of a trip is calculated as the latest occupancy status from the vehicle the trip is associated with. The value 'HIGH' means high occupancy level.
5. The departure delay is measured in number of seconds. Higher than 300 seconds of delay is considered significant.

제한점

운영 에이전트에는 규칙을 디자인하고 시나리오를 모니터링할 때 고려해야 하는 기능, 플랫폼 및 동작 제한 사항이 있습니다.

데이터 원본 제한 사항

  • 현재 운영 에이전트는 일반 Eventhouse 테이블의 모니터링 데이터만 지원합니다. 바로 가기 테이블, 함수 및 구체화된 뷰는 지원되지 않습니다.
  • 에이전트의 데이터 원본으로 Fabric 온톨로지 사용 시:
    • 온톨로지 작업 에이전트와 동일한 작업 영역에 있어야 합니다.
    • 에이전트에서 모니터링하려는 온톨로지 엔터티에는 엔터티의 식별자로 사용할 정적 속성이 하나 이상 있어야 합니다. Timeseries 속성은 Eventhouse 필드에 바인딩되어야 합니다.

모니터링 및 규칙 제한 사항

  • 온톨로지 모니터링은 기본 속성 값만 지원합니다. 평균, 최소 또는 최대값과 같은 집계는 지원되지 않습니다.
  • 'AND' 조건이 필요한 규칙은 지원되지 않습니다(예: 활주로의 제동 인덱스가 0.8 이상이고 표면 온도가 40) < .

언어 및 모델 동작 제한 사항

런타임 제한 사항

  • 에이전트는 활성 상태일 때 5분마다 쿼리를 실행합니다.
  • 3일 이내에 아무 작업도 수행되지 않으면 작업이 만료됩니다. 만료 후에는 작업을 더 이상 승인할 수 없습니다.

사용 권한 및 액세스 제한 사항

  • 에이전트는 해당 작성자의 위임된 ID 및 권한을 사용하여 작동합니다. 즉, 다음을 의미합니다.
    • 쿼리 및 작업은 작성자의 자격 증명을 사용합니다.
    • 기본적으로 작성자는 권장 사항 메시지를 받습니다. 받는 사람을 변경해도 쿼리 및 작업에 사용되는 자격 증명은 변경되지 않습니다.

메시징 및 스로틀링 제한 사항

  • 사용량이 많을 경우 메시지 제한이 발생할 수 있습니다. 이러한 경우 LLM에서 생성되지 않은 간소화된 메시지가 Microsoft Teams 전송될 수 있습니다.

지역 및 작업 영역 제한 사항

  • 운영 에이전트는 미국 중남부 및 미국 동부를 제외한 Azure 퍼블릭 클라우드 Microsoft Fabric 지역에서 사용할 수 있습니다.
  • 운영 에이전트는 현재 GCC-High 및 Bleu를 포함한 주권 클라우드에서 사용할 수 없습니다.
  • 작업 에이전트는 현재 Fabric 작업 영역에 대해 Customer 관리형 키로 암호화된 작업 영역에서 지원되지 않습니다.
  • Last updated on