본문으로 건너뛰기

LaaS API 커넥터를 활용한 컨플루언스 검색 자동화

image-20241104-070152.png

예상 소요 시간: 10분

이 가이드는 LaaS의 API 커넥터 기능을 활용하여 컨플루언스(Confluence) 검색 API를 연동하는 방법을 설명합니다.
API 커넥터를 활용하면 Function Calling을 설정하지 않고도 외부 API와 직접 연동하여 검색 결과를 자동으로 가져올 수 있습니다.

🔗 LaaS 무료 체험하기

1. 개요​

LaaS API 커넥터를 활용하면 외부 API를 직접 호출하여 실시간 데이터를 기반으로 AI 응답을 생성할 수 있습니다.
본 가이드는 컨플루언스 검색 API와 LaaS API를 연동하여, 챗봇이 사용자에게 검색 결과를 제공하는 방법을 다룹니다.

📌 API 커넥터 활용의 이점​

✅ Function Calling 없이 API 연동 가능: 별도의 함수 호출 설정 없이 API 커넥터에서 직접 데이터를 가져옴
✅ 자동화된 검색 프로세스: 사용자가 입력한 키워드를 바탕으로 컨플루언스에서 문서를 자동 검색
✅ 실시간 데이터 활용: LaaS API를 통해 검색 결과를 가공하여 최신 정보를 사용자에게 제공
✅ 업무 생산성 향상: 검색 결과 요약, 사용자 맞춤형 응답 자동 생성

2. API 커넥터 설정 방법​

LaaS API 커넥터를 활용하여 컨플루언스 검색 API와 연동하는 과정은 다음과 같습니다.

2.1 API 커넥터 추가하기​

  1. LaaS 에디터에서 [API 커넥터] 메뉴 선택

  2. 새 API 추가 버튼 클릭

  3. API 정보 입력

    • 이름: Confluence Search

    • 요청 URL:

      https://wantedlab.atlassian.net/wiki/rest/api/content/search

    • 요청 방식: GET

    • 파라미터 추가

      • cql → space=GT AND ancestor=3263758774 AND type=page AND text~"${text}" ORDER BY lastmodified DESC

      • limit → 10

      • expand → body.editor

    • 인증 방식: Basic Auth (이메일 & API 키 입력)

  4. API 요청 미리보기를 실행하여 올바르게 설정되었는지 확인

  5. 저장 후 적용

3. API 커넥터와 프리셋 연동​

API 커넥터 설정을 완료한 후, 이를 LaaS 프리셋과 연동하여 검색 요청을 자동 처리할 수 있습니다.

3.1 프리셋에서 API 커넥터 활용​

LaaS 프리셋을 생성하고, 프리셋 설정에서 API 커넥터를 연결하면 Function Calling 없이도 API를 호출할 수 있습니다.

  1. 프리셋 생성 및 설정

    • LaaS 에디터에서 새로운 프리셋을 생성

    • 시스템 메시지: "컨플루언스 검색 API를 통해 관련 문서를 찾아 제공합니다."

    • 유저 메시지: 사용자 입력을 기반으로 API 호출

  2. API 커넥터 연결

    • 프리셋 설정에서 API 커넥터 옵션을 활성화

    • 앞서 추가한 Confluence Search API 커넥터 선택

    • 요청 파라미터에 {text} 추가하여 동적 검색 가능

  3. 테스트 및 적용

    • 샌드박스에서 프리셋 실행하여 검색 결과 확인

    • 챗봇 응답이 적절하게 생성되는지 확인 후 저장

4. 컨플루언스 API 응답 처리​

컨플루언스 API 응답을 가공하여, LaaS가 최적의 응답을 생성하도록 설정할 수 있습니다.

4.1 API 응답 예시​

{
  "results": [
    {
      "title": "RAG 개요 문서",
      "url": "https://wantedlab.atlassian.net/wiki/spaces/GT/pages/12345"
    },
    {
      "title": "RAG 기술 문서",
      "url": "https://wantedlab.atlassian.net/wiki/spaces/GT/pages/67890"
    }
  ]
}

4.2 최종 응답 포맷​

{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "system",
      "content": "컨플루언스 검색 결과를 요약하여 제공합니다."
    },
    {
      "role": "user",
      "content": "컨플루언스에서 'RAG' 키워드로 문서를 검색해줘."
    },
    {
      "role": "api_connector",
      "name": "Confluence Search",
      "content": {
        "results": [
          {"title": "RAG 개요 문서", "url": "https://wantedlab.atlassian.net/wiki/spaces/GT/pages/12345"},
          {"title": "RAG 기술 문서", "url": "https://wantedlab.atlassian.net/wiki/spaces/GT/pages/67890"}
        ]
      }
    }
  ]
}

4.3 챗봇 최종 응답 예시​

검색 결과:
1. [RAG 개요 문서](https://wantedlab.atlassian.net/wiki/spaces/GT/pages/12345)
2. [RAG 기술 문서](https://wantedlab.atlassian.net/wiki/spaces/GT/pages/67890)

5. 고급 구현 방안​

5.1 다중 키워드 검색​

사용자가 여러 개의 키워드를 입력하면 OR 조건을 활용하여 검색할 수 있습니다.

📌 예제 CQL 쿼리

space=GT AND ancestor=3263758774 AND type=page AND (text~"RAG" OR text~"FAQ") ORDER BY lastmodified DESC

5.2 최신 문서만 검색​

마지막 수정일이 최근 7일 이내인 문서만 검색하도록 설정할 수 있습니다.

📌 예제 CQL 쿼리

space=GT AND ancestor=3263758774 AND type=page AND text~"RAG" AND lastmodified --> startOfDay(-7d)

6. 문제 해결 (FAQ)​

🔹 Q1: API 커넥터를 설정했는데 검색 결과가 반환되지 않습니다.​

✅ 컨플루언스 API 키 및 인증 정보가 올바른지 확인하세요.
✅ space, ancestor 값이 정확하게 입력되었는지 검토하세요.

🔹 Q2: 검색 결과가 너무 많거나 적게 나옵니다.​

✅ limit 값을 조정하여 최대 반환 개수를 설정하세요.
✅ text~"${text}" 부분을 수정하여 검색 정확도를 조정하세요.



이제 LaaS API 커넥터를 활용하여 컨플루언스 검색 API와 연동된 챗봇을 쉽게 구현해 보세요! 🚀

image-20241104-070152.png