적용 대상: Azure Logic Apps(표준)
메모
이 미리 보기 기능은 Microsoft Azure 미리 보기에 대한 추가 사용 약관의 적용을 받습니다.
조직에서는 문서, 스프레드시트, API 및 내부 시스템에서 구조화되지 않은 데이터를 생성합니다. Azure Logic Apps의 서비스형 지식 베이스(KBaaS) 기능을 사용하면 이 콘텐츠를 에이전트형 워크플로의 에이전트 루프가 작업을 완료하는 데 사용할 수 있는 구조화되고 더 쉽게 검색할 수 있는 지식 베이스로 변환할 수 있습니다. 기술 자료는 특정 도메인과 관련된 문서 또는 파일과 같은 관련 지식 원본을 구성하는 논리 컨테이너 입니다.
예를 들어 HR 정책 및 절차와 관련된 모든 문서를 포함하는 기술 자료를 만들 수 있습니다. 기술 자료를 만들 때 KBaaS는 필요한 Azure Cosmos DB 데이터베이스, 컨테이너 및 인덱싱 정책을 자동으로 설정합니다. 자세한 내용은 Azure Cosmos DB 데이터베이스, 컨테이너 및 항목 참조하세요.
이 가이드에서는 기술 자료를 만들고, 기술 자료를 업로드하고, 기술 자료를 에이전트 루프가 표준 에이전트 워크플로에서 사용할 수 있는 도구로 추가하는 방법을 보여 줍니다.
Limitations
이 미리 보기 릴리스에는 다음과 같은 제한 사항이 있습니다.
이 미리 보기는 다음 기능을 지원합니다.
- 지식 아티팩트의 소스 유형으로서의 업로드된 파일
- DOC, DOCX, HTML, MD, PDF, PPT, PPTX, TXT, XLS, XLSX 형식의 파일입니다.
- 이미지가 아닌 문서에서의 텍스트 기반 콘텐츠 파싱
- 사용자 지정 청크가 아닌 기본 청크 설정입니다.
기술 자료 연결을 만든 후에는 연결 및 Azure OpenAI 모델의 표시 이름만 편집할 수 있습니다. 인증 유형 또는 엔드포인트 정보와 같은 다른 값은 편집할 수 없습니다.
현재 이 기능에는 Azure 포털만 지원됩니다.
기술 자료의 작동 방식
KBaaS는 데이터 변환을 간소화하고 Azure Cosmos DB 및 Azure OpenAI를 통해 추상화 계층을 제공하여 워크플로가 RAG(사용자 지정 Retrieval-Augmented 생성) 파이프라인을 빌드하지 않고도 구조화된 지식을 보다 쉽게 사용, 처리 및 검색할 수 있도록 합니다.
KBaaS에는 다음과 같은 파이프라인이 있습니다.
수집 파이프라인: 문서 또는 기술 원본을 기술 자료에 업로드할 때 서비스는 콘텐츠를 자동으로 구문 분석, 청크, 요약 및 벡터화합니다. 그런 다음, 서비스는 결과를 Azure Cosmos DB 저장합니다.
Retrieval pipeline: 에이전트 루프가 기술 자료를 쿼리할 때 서비스가 필요한 경우 쿼리를 다시 작성하고, 벡터 표현을 생성하고, Azure Cosmos DB 대한 의미 체계 검색을 수행하고, 응답 생성을 위해 가장 관련성이 큰 청크를 LLM(대규모 언어 모델)에 반환합니다.
사전 요구 사항
Azure 계정 및 구독 무료 Azure 계정을 만듭니다.
Azure OpenAI 리소스입니다. 자세한 내용은 Azure OpenAI Service 리소스 만들기 및 배포 참조하세요.
리소스에는 다음과 같은 배포된 모델이 필요합니다.
- gpt-4o와 같은 완성 모델입니다.
- text-embedding-3-small와 같은 임베딩 모델.
NoSQL 계정에 대한 Azure Cosmos DB.
기술 자료를 만들기 전에 Cosmos DB 계정에서 벡터 검색을 사용하도록 설정합니다 . 이 작업은 완료되기까지 최대 15분이 걸릴 수 있습니다.
자세한 내용은 다음을 참조하세요:
표준 논리 앱 및 에이전트 워크플로입니다.
자세한 내용은 다음을 참조하세요:
Azure Logic Apps Azure Logic Apps
Authentication
KBaaS 기능은 Microsoft Entra ID 및 관리 ID 또는 API 키를 사용하여 인증을 지원합니다. 가능하면 최적의 보안을 위해 관리 ID를 설정하고 사용합니다 . 자격 증명, 비밀 또는 액세스 키를 수동으로 제공하고 관리할 필요가 없습니다.
API 키를 사용하는 경우 자격 증명, 비밀, 액세스 키, 연결 문자열, 인증서, 지문 및 보안 수준이 가장 높거나 지원되는 유사한 정보와 같은 중요한 개인 데이터를 보호하고 보호합니다. Microsoft Entra ID 및 Azure Key Vault 사용하여 이러한 정보를 안전하게 저장합니다. 이 정보를 하드 코딩하거나, 다른 사용자와 공유하거나, 다른 사용자가 액세스할 수 있는 모든 곳에 일반 텍스트로 저장하지 마세요. 비밀 정보가 노출되거나 침해된 경우 교체하거나 폐기할 수 있도록 계획을 수립합니다.
자세한 내용은 다음 리소스를 참조하세요.
1: 기술 자료 연결 만들기
지식 베이스 연결을 만들려면 다음 단계에 따라 Cosmos 데이터베이스와 Azure OpenAI 리소스 모델을 연결하세요:
1a: Cosmos 데이터베이스 연결 설정
Azure Portal에서 표준 논리 앱 리소스를 엽니다.
논리 앱 사이드바의 에이전트 아래에서 기술 자료를 선택합니다.
기술 자료 페이지에서 설정을 선택합니다.
설정 창의 기본 사항 탭에서 다음 정보를 제공합니다.
매개 변수 Required 설명 표시 이름 예 지식 기반 연결에 대해 사람이 읽을 수 있는 이름입니다. 검색 작업이 올바른 연결과 연결될 수 있도록 생성하려는 기술 자료와 동일한 이름을 사용하세요. 인증 형식 예 키 기반 또는 관리 서비스 ID Subscription 예 Azure 구독. 데이터베이스 예 귀하의 Cosmos 데이터베이스. URL 엔드포인트 예 데이터베이스를 선택하면 이 값이 자동으로 채워집니다. 키 예 키 기반 인증을 선택한 경우에만 사용할 수 있습니다. 데이터베이스를 선택하면 이 값이 자동으로 채워집니다. 완료되면 다음을 선택합니다.
1b: Azure OpenAI 리소스 연결 설정
모델 탭에서 다음 정보를 제공합니다.
매개 변수 Required 설명 인증 형식 예 URL 및 키 기반 인증 또는 관리 서비스 ID Subscription 예 Azure 구독. Azure OpenAI 리소스 예 Azure OpenAI 리소스입니다. API 엔드포인트 예 Azure OpenAI 리소스 선택은 이 값을 자동으로 채웁니다. API 키 예 URL 및 키 기반 인증을 선택한 경우에만 사용할 수 있습니다. Azure OpenAI 리소스 선택은 이 값을 자동으로 채웁니다. 완성 모델 예 Azure OpenAI 리소스에 배포된 완성 모델의 표시 이름을 입력합니다. 임베딩 모델 예 Azure OpenAI 리소스에 대해 배포된 embeddings 모델의 표시 이름을 입력합니다. 완료되면 만들기를 선택합니다.
2: 지식 아티팩트 추가
기술 자료 연결을 만든 후 기술 자료에서 지식 아티팩트로 사용할 원본 정보 파일을 추가합니다.
Azure Portal에서 표준 논리 앱 리소스를 엽니다.
논리 앱 사이드바의 에이전트 아래에서 기술 자료를 선택합니다.
파일을 추가하기 전에 그룹을 만들려면 기술 자료 페이지 도구 모음에서 새>그룹 만들기를 선택한 다음 프롬프트에 따라 그룹을 만듭니다.
기술 자료 페이지에서 파일 추가를 선택합니다. 또는 페이지 도구 모음에서 새>파일 추가를 선택합니다.
파일 추가 창에서 다음 작업을 완료합니다.
그룹 섹션에서 다음 정보를 입력합니다.
매개 변수 Required 설명 Name 예 지식 베이스에서 파일을 구성하는 그룹 이름입니다. 새 이름을 입력하거나 기존 그룹을 선택합니다. 설명 No 그룹에 대한 선택적 설명입니다. 파일 추가 섹션에서 찾아보기를 선택하여 업로드하거나 파일을 그룹으로 끌어서 놓습니다. 각 파일에 대해 다음 정보를 입력합니다.
매개 변수 Required 가치 설명 Name 예 < source-name> 지식 소스로 사용할 파일 이름(예: HRPolicyDocument)설명 No < source-description> 지식 소스로서 파일에 대한 선택적 설명입니다.
완료되면 추가를 선택합니다.
KBaaS는 다음 Cosmos DB 컨테이너를 만듭니다.
컨테이너 Purpose KnowledgeHubs 기술 자료 메타데이터를 저장합니다. KnowledgeArtifacts 원본 메타데이터 및 원본 문서 참조를 저장합니다. KnowledgeArtifactChunks 전체 텍스트 문서 청크를 저장합니다. KnowledgeArtifactChunkSummaries 의미 체계 검색을 위해 요약된 청크를 벡터 포함으로 저장합니다. KBaaS는 업로드 진행률을 추적하기 위한 작업 ID와 함께 202 수락된 응답을 반환합니다.
업로드 프로세스 중에 KBaaS는 Cosmos DB 컨테이너에 벡터화된 콘텐츠를 구문 분석, 청크, 요약, 포함 및 저장하는 작업을 수행합니다. 프로세스가 완료되면 결과에 따라 원본 상태가 완료 됨 또는 실패로 변경됩니다.
Azure 포털에서 또는 작업 ID를 사용하여 업로드 상태를 모니터링합니다.
KBaaS가 완료되면 에이전트 표준 워크플로에서 사용할 에이전트 루프에 대한 도구로 기술 자료를 추가할 수 있도록 다음 섹션으로 계속 진행합니다.
3: 기술 자료를 도구로 추가
이제 에이전트 루프에 기술 자료를 추가하여 에이전트 표준 워크플로의 도구로 사용할 수 있습니다. 에이전트 루프는 기술 자료를 자동으로 쿼리하여 업로드된 문서에서 의미상 관련 정보를 검색합니다.
기술 자료를 포함하는 동일한 표준 논리 앱의 디자이너에서 에이전트 워크플로를 열고 원하는 에이전트 루프를 선택합니다.
에이전트 정보 창의 기술 자료 섹션에서 만들기를 선택합니다.
연결 만들기 창의 원본 목록에서 기술 자료를 선택합니다.
기술 자료에 더 많은 파일을 업로드하려면 + 업로드를 선택합니다.
기술 자료 및 원본 관리
기술 자료 또는 원본을 나열, 보기 및 삭제하려면 Azure 포털 또는 REST API를 사용합니다.
모든 기술 자료 나열
Azure Portal에서 표준 논리 앱 리소스를 엽니다.
논리 앱 사이드바의 에이전트 아래에서 기술 자료를 선택합니다.
또는 다음 REST API 호출을 수행합니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs
특정 기술 자료 보기
Azure 포털의 Knowledge base 페이지에서 기술 자료 이름을 선택합니다.
또는 다음 REST API 호출을 수행합니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}
응답에는 기술 자료 정보, 연결된 원본이 있는 목록 및 업로드 상태가 포함됩니다.
기술 자료실의 출처 목록
Azure 포털에서 기술 자료를 선택하여 원본을 봅니다.
또는 다음 REST API 호출을 수행합니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}/knowledgeArtifacts
지식 원본 삭제
이 작업은 Cosmos DB에서 원본 메타데이터, 전체 텍스트 청크 및 벡터 포함을 제거합니다. 이 서비스는 삭제 진행 상황을 추적하기 위한 작업 ID를 사용하여 202 수락된 응답을 반환합니다.
Azure 포털에서 기술 자료를 선택하여 원본을 봅니다.
소스를 선택합니다. 도구 모음에서 삭제를 선택합니다.
또는 다음 REST API 호출을 수행합니다.
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}/knowledgeArtifacts/{artifactName}
기술 자료 삭제
이 작업은 Cosmos DB에서 기술 자료 및 관련 원본, 청크 및 요약을 제거합니다.
Azure 포털에서 기술 자료를 선택합니다.
도구 모음에서 삭제를 선택합니다.
또는 다음 REST API 호출을 수행합니다.
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{logicAppName}/hostruntime/runtime/webhooks/workflow/api/management/knowledgehubs/{knowledgeBaseName}