GitHub Copilot CLI에 Foundry IQ(Azure AI 검색) 기술 설치

인용을 사용하여 기존 foundry IQ(Azure AI 검색) 기술 자료를 쿼리하고 GitHub Copilot CLI에서 Foundry IQ 기술을 사용하여 지식 그래프를 작성합니다. 이 문서에서는 foundry-iq-skills 플러그 인을 설치하고 Azure 리소스에 foundry-iq-skills 플러그 인의 foundry-iq 기술을 사용합니다.

Foundry IQ Skills에서 공용 플러그 인 소스를 찾습니다.

Important

GitHub Copilot CLI에 대한 Foundry IQ skills 통합은 공개 미리 보기로 제공되며 Microsoft Azure 미리 보기에 대한 추가 사용 약관의 적용을 받습니다.

이 기능과 관련된 미리 보기 관련 약관은 미리 보기 기능을 참조하세요.

Prerequisites

  • 플러그인 마켓플레이스를 추가하는 데 필요한 Git
  • Windows 또는 Linux용 GitHub Copilot CLI
  • 플러그 인의 도우미 스크립트에 필요한 Python 3.12 이상.
  • 기존 지식 베이스 및 해당 Azure 구독 및 리소스에 대한 액세스입니다.
  • 이 플러그인으로 기존 기술 자료를 쿼리하려면 Azure CLI를 설치하고 로그인합니다. 요청된 읽기 또는 변경에 대한 권한이 있는 인증된 Azure 자격 증명을 사용합니다. 쿼리 액세스 요구 사항은 기술 자료 검색 필수 구성 요소를 참조하세요.
  • 쿼리 액세스 외에도 기술 자료 및 지식 원본 정의를 볼 수 있는 권한입니다. Reader 역할은 개체 정의를 볼 수 있습니다. 기본 제공 역할을 참조하세요.

플러그 인 설치

운영 체제의 셸이 아닌 GitHub Copilot CLI에서 슬래시 명령을 실행합니다.

  1. 마켓플레이스를 추가합니다.

    /plugin marketplace add microsoft/azure-skills
    
  2. 플러그인을 설치합니다.

    /plugin install foundry-iq-skills@azure-skills
    

설치된 플러그인을 업데이트하려면 Copilot CLI에서 다음 명령을 실행하세요.

/plugin update foundry-iq-skills@azure-skills

기존 지식 베이스 쿼리

스킬은 읽기 전용 검사로 시작합니다. 탐색 범위를 기존 리소스로 한정하도록 기존 리소스를 식별합니다. 리소스를 선택하는 것은 변경에 대한 승인이 아닙니다.

  1. Copilot CLI에서 기존 Foundry IQ 서비스 및 기술 자료를 식별합니다. 질문: "인용 포함 이 기술 자료에 질문하세요."

  2. 기술에서 기존 서비스를 사용할지, 호환되는 서비스를 찾을지 또는 서비스를 만들 것인지 묻는 경우 USE EXISTING을 선택합니다. 요청하는 기존 리소스 세부 정보를 제공합니다.

  3. 기술 자료의 콘텐츠에 대해 질문합니다.

  4. 지식 베이스에서 관련 콘텐츠가 있는지 검색된 답변과 해당 인용을 검토합니다.

변경 및 정리 경계 검토

기존 기술 자료를 쿼리하는 작업은 읽기 작업이며 쓰기 승인이 필요하지 않습니다. 다른 작업은 Azure 리소스를 변경할 수 있습니다.

변경 사항을 승인하기 전에 스킬에서 보여 준 계획을 검토합니다. 서비스, 기술 자료 또는 기술 자료를 만들거나, 기술 자료를 에이전트에 연결하거나, 계획된 다른 리소스를 변경하려면 승인이 필요합니다. 승인은 변경되지 않은 계획에만 적용됩니다. 계획이 변경되면 스킬이 다시 묻습니다.

정리 작업을 별도의 계획 워크플로로 간주합니다. 워크플로에서 만든 리소스의 지원되는 리소스 삭제에는 별도의 승인이 필요합니다. 만들기 및 정리 승인을 결합하지 마세요.

지원되는 워크플로 확인

검색 외에도 이 스킬은 로컬 파일 및 Azure Blob Storage 또는 Azure Data Lake Storage 지식 원본, 검색 유효성 검사를 사용한 기술 자료 생성, 기존 에이전트 연결, 진단 및 정리 계획을 지원합니다. 소스 개념은 지식 원본 개요를 참조하세요.

이 스킬은 기술 자료를 변경하지 않고 기존 다중 원본 기술 자료를 기존 에이전트에 연결할 수 있도록 지원합니다.

문제 해결

마켓플레이스 등록, 설치 또는 업데이트 명령이 오류를 보고하는 경우 지식 베이스 절차를 수행하기 전에 중지하세요. GitHub Copilot CLI 내에서 슬래시 명령을 실행하고 있고 Git을 사용할 수 있는지 확인합니다. 설치 지침은 Foundry IQ 플러그 인 설치 지침을 참조하세요.