Integration Connector 도구

커넥터 도구는 상담사가 Integration Connectors에서 구성된 연결을 사용하여 작업을 실행하는 데 사용할 수 있습니다. 각 커넥터 도구는 단일 연결과 하나 이상의 작업으로 구성됩니다. 필요한 경우 단일 연결에 여러 도구를 만들어 에이전트가 사용할 수 있도록 다양한 작업을 함께 그룹화할 수 있습니다.

커넥터 도구는 다음 커넥터 유형을 지원합니다.

연결 만들기

연결을 만들려면 다음 단계를 따르세요.

  • 에이전트 빌더에서 도구 > 만들기로 이동합니다.
  • 통합 커넥터 도구 유형을 선택합니다.
  • 선택한 커넥터 유형을 선택합니다.
  • 연결 만들기 버튼을 사용합니다.

이렇게 하면 여러 필드가 미리 입력된 통합 커넥터 생성으로 이동합니다.

또는 Integration Connectors로 이동하여 연결 만들기 안내를 따를 수 있습니다.

커넥터 작업

각 커넥터 도구에는 에이전트가 사용할 수 있는 두 가지 유형의 작업이 있습니다 (자세한 내용은 항목, 작업, 작업 참고).

  1. 엔티티 CRUD 작업

    각 연결에는 해당 데이터 소스의 객체에 해당하는 '엔티티'가 있습니다 (BigQuery의 경우 테이블, Salesforce의 경우 '주문' 또는 '케이스'와 같은 객체).

    각 항목에 대해 CRUD 작업을 실행할 수 있습니다.

    • 만들기: 지정된 필드 값으로 항목을 만듭니다.
    • 목록: 필터 기반 항목 인스턴스 검색
    • 업데이트: 엔티티 필드 값을 변경하는 필터 기반 메서드
    • 삭제: 항목을 삭제합니다.
    • Get은 entityId를 사용하여 단일 항목을 검색합니다.

    커넥터 문서에서 항목 CRUD 작업 세부정보에 대해 자세히 알아보세요.

  2. 커넥터별 작업

    많은 커넥터가 'ExecuteCustomQuery' 작업을 지원합니다. 이 작업을 사용하면 데이터 소스에 대해 SQL 쿼리를 실행할 수 있으며, 각 데이터 소스 항목을 테이블로 참조할 수 있습니다. 지원되는 커넥터 목록을 참고하세요.

    추가 작업은 커넥터 유형에 따라 다릅니다. 예를 들어 BigQuery 커넥터 작업 또는 Salesforce 커넥터 작업을 참고하세요.

CRUD 작업을 위한 입력 / 출력 필드 구성

커넥터 도구 작업에서 사용할 특정 입력 또는 출력 필드를 선택하면 상담사의 작업 복잡성을 제한할 수 있습니다.

예를 들어 필드의 하위 집합이 있는 항목만 만들어야 하는 경우 작업에서 이 필드 집합을 구성하면 에이전트의 작업이 간소화됩니다.

출력 필드 집합을 지정하면 도구 응답 크기가 줄어들고 (토큰 한도가 우려되는 경우 유용함) 관련 필드만 노출하여 에이전트의 출력 처리가 간소화됩니다.

인증

사용 중인 연결이 인증 재정의를 허용하도록 구성된 경우 지정된 세션 매개변수에서 사용자 인증 정보를 전달하도록 도구를 구성할 수 있습니다.

에이전트 빌더는 이러한 사용자 인증 정보가 세션 매개변수에 채워지는 방식을 관리하며, 도구의 작업이 호출되면 도구는 인증에 사용하도록 데이터 소스에 사용자 인증 정보를 자동으로 전달합니다.