개발 워크플로에 AI 모델 통합

GitHub Models 확장을 사용하면 Copilot Chat과 GitHub CLI 모두에서 특정 AI 모델을 호출할 수 있습니다. 이러한 확장은 개발 워크플로에 직접 통합되어 컨텍스트 전환 없이 모델을 프롬프트할 수 있습니다.

Copilot Chat의 AI 모델 사용

Copilot 구독이 있는 경우, 다음 두 가지 방법으로 Copilot Chat에서 AI 모델을 사용하여 작업할 수 있습니다.

• GitHub Models Copilot 확장을 사용합니다. 이 확장을 사용하면 특정 기준에 따라 모델 권장 사항을 요청하고 특정 모델과 채팅할 수 있습니다. GitHub Models Copilot 확장 사용을 참조하세요.
• Copilot Chat에서 다중 모델 지원을 사용합니다. 다중 모델 Copilot Chat을 사용하면 대화에 사용할 특정 모델을 선택한 다음, 평소처럼 Copilot Chat 프롬프트를 표시합니다. Copilot Chat에 대한 AI 모델 변경을(를) 참조하세요.

GitHub Models Copilot 확장 사용

1. GitHub Models Copilot 확장을 설치합니다.

   • Copilot Pro를 구독하는 경우 개인 계정에 확장을 설치할 수 있습니다.
   • Copilot Business 또는 Copilot Enterprise 구독을 통해 Copilot에 액세스할 수 있는 경우:
     • 조직 소유자 또는 기업 소유자는 조직 또는 기업에 대해 Copilot 확장 정책을 사용하도록 설정해야 합니다.
     • 조직 소유자는 조직에 확장을 설치해야 합니다.

2. GitHub Copilot 확장를 지원하는 Copilot Chat의 구현을 엽니다. 지원되는 Copilot Chat 구현 목록은 확장을 사용하여 외부 도구를 Copilot 채팅과 통합을(를) 참조하세요.

3. 채팅 창에서 @models YOUR-PROMPT를 입력한 다음, 프롬프트를 보냅니다. GitHub Models Copilot 확장에는 다음을 포함하여 몇 가지 사용 사례가 있습니다.

   • 사용자가 제공하는 컨텍스트와 조건을 기반으로 특정 모델을 추천합니다. 예를 들어 함수 호출을 지원하는 저렴한 OpenAI 모델을 요청할 수도 있습니다.
   • 특정 모델을 사용하여 프롬프트를 실행합니다. 이 기능은 현재 다중 모델 Copilot Chat에서 사용할 수 없는 모델을 사용하려는 경우에 특히 유용합니다.
   • GitHub Models를 통해 현재 사용할 수 있는 모델 나열

GitHub Actions를 통해 AI 모델 사용

GitHub Actions 토큰(GITHUB_TOKEN)을 사용하여 워크플로 내에서 AI 모델을 직접 호출할 수 있습니다.

권한 설정

워크플로에서 AI 모델을 사용하려면 워크플로 구성에서 models 권한을 사용하도록 설정해야 합니다. 이 권한을 통해 워크플로는 GitHub Models 추론 API에 액세스할 수 있습니다. 이 권한 자체를 직접 설정하거나 일반 read-all 또는 write-all 권한을 사용할 수 있습니다. GitHub 앱에 필요한 권한을(를) 참조하세요.

워크플로 파일 작성

워크플로에서 직접 추론 API를 호출할 수 있습니다. 예:

name: Use GitHub Models

on:
  workflow_dispatch:

permissions:
  models: read

jobs:
  call-model:
    runs-on: ubuntu-latest
    steps:
      - name: Call AI model
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          curl "https://models.github.ai/inference/chat/completions" \
             -H "Content-Type: application/json" \
             -H "Authorization: Bearer $GITHUB_TOKEN" \
             -d '{
              "messages": [
                  {
                     "role": "user",
                     "content": "Explain the concept of recursion."
                  }
               ],
               "model": "openai/gpt-4o"
            }'

명령줄에서 AI 모델 사용

GitHub CLI용 GitHub Models 확장을 사용하여 명령줄에서 AI 모델을 프롬프트하고 명령 출력에서 컨텍스트로 파이프할 수도 있습니다.

필수 조건

GitHub Models CLI 확장을 사용하려면 GitHub CLI가 설치되어 있어야 합니다. GitHub CLI에 대한 설치 지침은 GitHub CLI 리포지토리를 참조하세요.

익스텐션 설치

1. 아직 GitHub CLI에 인증하지 않은 경우 터미널에서 다음 명령을 실행합니다.

   Shell

   gh auth login
   

2. GitHub Models 확장을 설치하려면 다음 명령을 실행합니다.

   Shell

   gh extension install https://github.com/github/gh-models
   

확장 사용

사용 가능한 모든 명령어 목록을 보려면 gh models을(를) 실행합니다.

확장을 사용할 수 있는 몇 가지 주요 방법이 있습니다.

• 채팅 환경을 사용하여 모델에게 여러 질문을 하려면, gh models run을 실행합니다. 나열된 모델 중에서 모델을 선택한 다음, 프롬프트를 보냅니다.
• 모델에게 질문 하나를 물으려면, 터미널에서 gh models run MODEL-NAME "QUESTION"을 실행합니다. 예를 들어, GPT-4.1 모델에 하늘이 왜 파란색인지 이유를 묻으려면 gh models run openai/gpt-4.1 "why is the sky blue?"를 실행하면 됩니다.
• 모델을 호출할 때 명령 출력을 컨텍스트로 제공하려면, 파이프 문자(|)극 사용하여 별도의 명령과 모델 호출을 결합할 수 있습니다. 예를 들어, GPT-4.1 모델을 사용하여 현재 디렉터리의 추가 정보 파일을 요약하려면 cat README.md | gh models run openai/gpt-4.1 "summarize this text"를 실행하면 됩니다.