시작하기 전에

• 사용 사례 시나리오를 검토하세요. 자세한 내용은 사용 사례 시나리오를 참조하세요.
• IBM Cloud 계정이 있는지 확인합니다.
• IBM Cloud 에서 Milvus 또는 Elasticsearch DB 인스턴스를 프로비저닝합니다.
• 인덱싱된 코드 저장소 목록을 가져오고 벡터 스토어에 있는 문서를 가져옵니다.

연결 자산 만들기

Watsonx Code Assistant 배포 공간의 연결 자산을 사용하여 벡터 스토어에서 인덱싱된 코드 저장소 콘텐츠에 액세스합니다. 벡터 스토어에서 각 인덱스에 대한 연결 에셋을 생성합니다.

연결 자산의 이름은 코드 저장소의 이름과 일치해야 합니다. 예를 들어 리포지토리 URL이 git@github.ibm.com:my-org/mycode.git 인 경우 연결 에셋의 이름은 mycode 이어야 합니다. 문서 인덱스에 대한 연결 자산을 만드는 경우 연결 자산의 이름은 docs_<name> 형식이어야 합니다. <name> 를 색인된 문서의 이름에 접두사 docs 로 바꿀 수 있습니다.

Watsonx Code Assistant 는 연결 자산의 설명 섹션을 사용하여 벡터 스토어에 대한 자세한 구성 세부 정보를 읽습니다.

연결 자산을 만들려면 다음과 같이 하세요:

1. watsonx Code Assistant 서비스 인스턴스를 엽니다.

2. 탐색 메뉴 아이콘 클릭한 다음 배포를 선택합니다.

3. 배포 공간을 선택합니다.

4. 배포 공간의 자산 탭으로 이동합니다.

5. 자산 가져오기 > 데이터 액세스 > 연결로 이동합니다.

6. 연결 추가에서 Elasticsearch 또는 Milvus 연결 유형을 선택합니다.

   • Elasticsearch 연결 유형의 경우 다음 필드를 추가합니다:

     Elasticsearch 연결 유형 설정

     매개변수	설명
     이름	Elasticsearch 연결의 이름을 입력합니다. @repo 명령을 사용하려면 Elasticsearch 연결 이름이 리포지토리 이름과 같아야 하고, docs_ 명령을 사용하려면 @docs 명령으로 시작해야 합니다.
     설명	연결 자산의 추가 정보를 다음 필드와 함께 JSON 형식으로 입력합니다: { "index_name": "인덱스 이름 추가", "db_type": "elasticsearch", "ssl_assert_fingerprint": "your_fingerprint", "embedding_details": { "model_id": "msmarco-MiniLM-L-6-v3" } }
     URL	Elasticsearch 인스턴스에 대해 URL 연결을 입력합니다.
     사용자 이름 및 비밀번호	Elasticsearch 인스턴스의 자격 증명을 입력합니다.
     SSL 인증서	선택 사항입니다: Elasticsearch 인스턴스와 보안 연결을 만들려면 SSL 인증서를 입력합니다. SSL 인증서 없이는 Elasticsearch 연결을 테스트할 수 없지만 연결 저장을 클릭하여 연결을 저장할 수 있습니다.

   • Milvus 연결 유형의 경우 다음 필드를 추가합니다:

     Milvus 연결 유형 설정

     매개변수	설명
     이름	Milvus 연결의 이름을 입력합니다. Milvus 연결 이름은 @repo 명령의 리포지토리 이름과 같거나 docs_ 로 시작하여 @docs 명령을 사용해야 합니다.
     설명	연결 자산의 추가 정보를 다음 필드와 함께 JSON 형식으로 입력합니다: { "index_name": ""인덱스 이름 추가"", "db_type": "밀버스", "embedding_details": { "model_id": "msmarco-MiniLM-L-6-v3" } }
     host	Milvus 인스턴스에 URL 호스트를 입력합니다.
     포트	Milvus 인스턴스의 포트 번호를 입력합니다.
     데이터베이스	데이터베이스 매개변수를 기본값으로 설정합니다.
     사용자 이름 및 비밀번호	사용자 아이디를 ibmlhapikey 로 설정하고 IBM Cloud 계정에서 생성한 API 키와 IBM watsonx.data 인스턴스를 비밀번호 필드에 입력합니다.
     SSL 인증서	선택 사항입니다: Milvus 인스턴스와 보안 연결을 만들려면 SSL 인증서를 입력합니다. SSL 인증서 없이 Milvus 연결을 테스트할 수 있습니다.

7. 작성을 클릭하십시오.