GitLab Duo Chat을 사용할 때 다음 문제가 발생할 수 있습니다.

GitLab Duo Chat 버튼이 표시되지 않음#

UI 오른쪽 위에 버튼이 보이지 않으면 GitLab Duo Chat 이 활성화되어 있는지 확인합니다.

GitLab Duo 기능이 비활성화된 그룹과 프로젝트에서는 GitLab Duo Chat 버튼이 표시되지 않습니다.

GitLab Duo Chat을 활성화한 뒤 버튼이 나타나기까지 몇 분이 걸릴 수 있습니다.

이렇게 해도 해결되지 않으면 다음 문제 해결 문서도 확인할 수 있습니다:

• GitLab Duo Code Suggestions.
• VS Code.
• Microsoft Visual Studio.
• JetBrains IDEs.
• Neovim.
• Eclipse.
• GitLab Duo 문제 해결.
• GitLab Duo Self-Hosted 문제 해결.

오류 M2000#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, I couldn't find any documentation to answer your question. Error code: M2000.

이 오류는 Chat 이 질문에 답할 관련 문서를 찾지 못할 때 발생합니다. 검색 쿼리가 사용 가능한 문서와 일치하지 않거나 문서 검색 기능에 문제가 있는 경우에 나타날 수 있습니다.

다시 시도하거나 GitLab Duo Chat 모범 사례 문서를 참고해 질문을 다듬습니다.

오류 M3002#

다음과 같은 오류가 표시될 수 있습니다. I am sorry, I cannot access the information you are asking about. A group or project owner has turned off Duo features in this group or project. Error code: M3002.

이 오류는 GitLab Duo가 꺼져 있는 프로젝트나 그룹에 속한 항목에 대해 질문할 때 발생합니다.

GitLab Duo가 켜져 있지 않으면 해당 그룹이나 프로젝트의 항목(이슈, 에픽, 머지 리퀘스트 등)에 대한 정보를 GitLab Duo Chat 이 처리할 수 없습니다.

오류 M3003#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, I can't generate a response. You might want to try again. You could also be getting this error because the items you're asking about either don't exist, you don't have access to them, or your session has expired. Error code: M3003.

이 오류는 다음과 같은 경우에 발생합니다:

• 액세스 권한이 없는 항목(이슈, 에픽, 머지 리퀘스트 등)이나 존재하지 않는 항목에 대해 GitLab Duo Chat에 질문한 경우.
• 세션이 만료된 경우.

액세스 권한이 있는 항목에 대해 다시 질문합니다. 문제가 계속되면 세션 만료가 원인일 수 있습니다. GitLab Duo Chat을 계속 사용하려면 다시 로그인합니다. 자세한 내용은 GitLab Duo 사용 가능 여부 제어를 참고합니다.

오류 M3004#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, I can't generate a response. You do not have access to GitLab Duo Chat. Error code: M3004.

이 오류는 필요한 액세스 권한 없이 GitLab Duo Chat에 접근하려 할 때 발생합니다.

GitLab Duo Chat을 사용할 액세스 권한이 있는지 확인합니다.

오류 M3005#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, this question is not supported in your Duo Pro subscription. You might consider upgrading to Duo Enterprise. Error code: M3005.

이 오류는 GitLab Duo 구독 티어에 포함되지 않은 GitLab Duo Chat 도구에 접근하려 할 때 발생합니다.

GitLab Duo 구독 티어에 선택한 도구가 포함되어 있는지 확인합니다.

오류 M3006#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, you don't have the GitLab Duo subscription required to use Duo Chat. Please contact your administrator. Error code: M3006.

이 오류는 GitLab Duo 구독에 GitLab Duo Chat 이 포함되어 있지 않을 때 발생합니다.

GitLab Duo 구독 티어에 GitLab Duo Chat 이 포함되어 있는지 확인합니다.

구독 티어에 이미 GitLab Duo Chat 이 포함되어 있는데도 이 오류가 계속 표시되면, 사용자 환경 설정에서 기본 GitLab Duo 네임스페이스를 선택했는지 확인합니다. 기본 GitLab Duo 네임스페이스를 구성하지 않으면 오류 G3002 대신 오류 M3006 이 발생할 수 있습니다.

오류 M4000#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, I can't generate a response. Please try again. Error code: M4000.

이 오류는 슬래시 명령 요청을 처리하는 중에 예기치 않은 문제가 생겼을 때 발생합니다. 요청을 다시 시도합니다. 문제가 계속되면 명령 구문이 올바른지 확인합니다.

슬래시 명령에 대한 자세한 내용은 다음 문서를 참고합니다:

• /tests
• /refactor
• /fix
• /explain

오류 M4001#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, I can't generate a response. Please try again. Error code: M4001.

이 오류는 요청을 완료하는 데 필요한 정보를 찾는 과정에 문제가 있을 때 발생합니다. 요청을 다시 시도합니다.

오류 M4002#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, I can't generate a response. Please try again. Error code: M4002.

이 오류는 CI/CD 관련 질문에 답하는 과정에 문제가 있을 때 발생합니다. 요청을 다시 시도합니다.

오류 M4003#

다음과 같은 오류가 표시될 수 있습니다. This command is used for explaining vulnerabilities and can only be invoked from a vulnerability detail page. 또는 Vulnerability Explanation currently only supports vulnerabilities reported by SAST. Error code: M4003.

이 오류는 Explain Vulnerability 기능을 사용하는 중에 문제가 있을 때 발생합니다.

오류 M4004#

다음과 같은 오류가 표시될 수 있습니다. This resource has no comments to summarize.

이 오류는 Summarize Discussion 기능을 사용하는 중에 문제가 있을 때 발생합니다.

오류 M4005#

다음과 같은 오류가 표시될 수 있습니다. There is no job log to troubleshoot. 또는 This command is used for troubleshooting jobs and can only be invoked from a failed job log page..

이 오류는 Troubleshoot job 기능을 사용하는 중에 문제가 있을 때 발생합니다.

오류 M5000#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, I can't generate a response. Please try again. Error code: M5000.

이 오류는 항목(이슈, 에픽, 머지 리퀘스트 등)과 관련된 콘텐츠를 처리하는 중에 문제가 있을 때 발생합니다. 요청을 다시 시도합니다.

오류 A1000#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, I couldn't respond in time. Please try again. Error code: A1000.

이 오류는 처리 중에 시간이 초과될 때 발생합니다. 요청을 다시 시도합니다.

오류 A1001#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, I can't generate a response. Please try again. Error code: A1001.

이 오류는 요청을 처리한 AI 서비스에서 문제가 발생했다는 뜻입니다.

가능한 원인은 다음과 같습니다:

• GitLab 코드의 버그로 인한 클라이언트 측 오류.
• Anthropic 코드의 버그로 인한 서버 측 오류.
• AI Gateway에 도달하지 못한 HTTP 요청.

오류 원인을 더 명확히 표시하기 위한 이슈가 있습니다.

이 문제를 해결하려면 요청을 다시 시도합니다.

오류가 계속되면 /new 또는 /reset 명령으로 새 대화를 시작합니다. 그래도 문제가 계속되면 GitLab 지원 팀에 문제를 보고합니다.

GitLab Duo Self-Hosted#

GitLab Duo Self-Hosted로 Chat을 사용할 때 이 오류가 발생했다면 AI Gateway 연결에 문제가 있었던 것입니다.

이 문제를 해결하려면 셀프 호스팅 디버깅 스크립트로 GitLab 인스턴스에서 AI Gateway에 접근할 수 있고 정상적으로 동작하는지 확인합니다.

문제가 계속되면 GitLab 지원 팀에 문제를 보고합니다.

오류 A1002#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, I couldn't respond in time. Please try again. Error code: A1002.

이 오류는 AI Gateway에서 이벤트가 반환되지 않거나 GitLab 이 이벤트를 파싱하지 못했을 때 발생합니다.

요청을 다시 시도하거나 AI Gateway 로그에 오류가 있는지 확인합니다.

오류 A1003#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, I couldn't respond in time. Please try again. Error code: A1003.

이 오류는 AI Gateway의 스트리밍 응답이 실패했을 때 발생합니다. 요청을 다시 시도합니다.

긴 응답이 오류 없이 도중에 멈춘다면 프록시, 로드 밸런서, 방화벽이 연결을 끊었을 수 있습니다. 자세한 내용은 다음을 참고합니다:

• GitLab 인스턴스에서 GitLab Duo 로의 아웃바운드 연결 허용.
• GitLab Duo Self-Hosted의 오류 없이 응답이 잘리는 문제.

GitLab Duo Self-Hosted#

GitLab Duo Self-Hosted로 Chat을 사용할 때 이 문제가 발생했다면 스트리밍이 동작하는지 확인합니다:

1. AI Gateway 컨테이너에서 다음 명령을 실행합니다:

   curl --request 'POST' \
   'http://localhost:5052/v2/chat/agent' \
   --header 'accept: application/json' \
   --header 'Content-Type: application/json' \
   --header 'x-gitlab-enabled-feature-flags: expanded_ai_logging' \
   --data '{
     "messages": [
       {
         "role": "user",
         "content": "Hello",
         "context": null,
         "current_file": null,
         "additional_context": []
       }
     ],
     "model_metadata": {
       "provider": "custom_openai",
       "name": "mistral",
       "endpoint": "<change here>",
       "api_key": "<change here>",
       "identifier": "<change here>"
     },
     "unavailable_resources": [],
     "options": {
       "agent_scratchpad": {
         "agent_type": "react",
         "steps": []
       }
     }
   }'
   

   스트리밍이 동작하면 청크 단위 응답이 표시됩니다. 동작하지 않으면 응답이 비어 있습니다.

2. 모델 배포 문제인지 확인하려면 AI Gateway 로그에서 구체적인 오류 메시지를 확인합니다.

3. 연결을 검증하려면 AI Gateway 컨테이너에서 AIGW_CUSTOM_MODELS__DISABLE_STREAMING 환경 변수를 설정해 스트리밍을 비활성화합니다:

   docker run .... -e AIGW_CUSTOM_MODELS__DISABLE_STREAMING=true ...
   

오류 A1004#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, I couldn't respond in time. Please try again. Error code: A1004.

이 오류는 AI Gateway 프로세스에서 오류가 발생했을 때 나타납니다. 요청을 다시 시도합니다.

오류 A1005#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, you've entered too many prompts. Please run /clear or /reset before asking the next question. Error code: A1005.

이 오류는 프롬프트 길이가 LLM의 최대 토큰 한도를 초과할 때 발생합니다. /new 명령으로 새 대화를 시작한 다음 요청을 다시 시도합니다.

오류 A1006#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, Duo Chat agent reached the limit before finding an answer for your question. Please try a different prompt or clear your conversation history with /clear. Error code: A1006.

이 오류는 ReAct 에이전트가 질의에 대한 해답을 찾지 못했을 때 발생합니다. 다른 프롬프트를 시도하거나 /new 또는 /reset으로 새 대화를 시작합니다.

오류 A1007#

There was an error processing your request. Please try again or contact support if the issue persists. Error code: A1007라는 오류가 표시될 수 있습니다.

이 오류는 GitLab Duo Agent Platform에서 요청을 처리하는 중에 예기치 않은 오류가 발생했을 때 나타납니다.

오류 A1008#

There was an error processing your request. Please try again or contact support if the issue persists. Error code: A1008라는 오류가 표시될 수 있습니다.

이 오류는 GitLab Duo Agent Platform 이 사용하는 업스트림 LLM 공급자에 요청이 제출되었을 때 발생합니다.

오류 A6000#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, I couldn't respond in time. Please try a more specific request or enter /clear to start a new chat. Error code: A6000.

이 오류는 GitLab Duo Chat에 문제가 있을 때 나타나는 대체 오류입니다. 더 구체적으로 요청하거나, /new를 입력해 새 채팅을 시작하거나, 개선에 도움이 되도록 피드백을 남깁니다.

오류 A9999#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, I couldn't respond in time. Please try again. Error code: A9999.

이 오류는 ReAct 에이전트에서 알 수 없는 오류가 발생했을 때 나타납니다. 요청을 다시 시도합니다.

문제가 계속되면 GitLab 지원 팀에 문제를 보고합니다.

오류 G3001#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, but answering this question requires a different Duo subscription. Please contact your administrator..

이 오류는 구독에서 GitLab Duo Chat을 사용할 수 없을 때 발생합니다. 다른 요청을 시도하고 관리자에게 문의합니다.

오류 G3002#

다음과 같은 오류가 표시될 수 있습니다. I'm sorry, you have not selected a default GitLab Duo namespace. Please select a default GitLab Duo namespace in your user preferences..

이 오류는 여러 GitLab Duo 네임스페이스에 속해 있거나, GitLab 원격이 구성되지 않은 프로젝트를 로컬에서 작업할 때 발생합니다.

이 문제를 해결하려면 기본 GitLab Duo 네임스페이스를 설정합니다.

Chat 응답의 링크를 선택할 수 없음#

GitLab Duo Chat은 외부 웹사이트와 서드파티 도메인의 URL을 응답에서 선택 가능한 링크로 표시하지 않습니다.

Chat은 이런 URL을 링크 텍스트만 보여 주는 코드 서식 텍스트로 변환합니다. 대상 URL은 표시하지 않습니다.

이 제한은 AI 응답에 생성될 수 있는 악의적인 링크로부터 사용자를 보호하는 데 도움이 됩니다.

Chat은 응답에서 다음 유형의 링크를 선택 가능하게 표시합니다:

• docs.gitlab.com의 GitLab 문서 링크.
• GitLab 프로젝트, 이슈, 머지 리퀘스트를 비롯한 gitlab.com 링크.
• GitLab 인스턴스 내의 상대 URL.

GitLab Duo Agentic Chat 고유의 문제#

GitLab Credits 부족#

GitLab Credits를 모두 소진하면 Chat에 대한 액세스 권한을 잃을 수 있습니다.

이 문제를 해결하려면 다음 중 하나를 수행합니다:

• GitLab Credits를 추가로 구매합니다.
• 비에이전트 Chat으로 전환합니다. 전환하면 새 대화가 시작됩니다. 이전 에이전트 Chat 대화는 계속 볼 수 있지만 읽기 전용입니다.

느린 응답 시간#

에이전트 Chat은 요청을 처리하고 응답하는 속도가 비에이전트 Chat보다 느릴 수 있습니다.

에이전트 Chat은 정보를 모으기 위해 여러 번 API를 호출하므로 응답이 훨씬 오래 걸릴 수 있습니다.

제한된 권한#

에이전트 Chat은 사용자의 GitLab 계정에 액세스 권한이 있는 리소스에만 접근할 수 있습니다. 에이전트 Chat 이 요청에 답하는 데 필요한 리소스에 접근하지 못한다면 사용자 권한을 확인합니다.

검색 제한#

에이전트 Chat은 의미 기반 검색이 아니라 키워드 기반 검색을 사용합니다. 검색에 사용한 정확한 키워드가 들어 있지 않은 관련 콘텐츠는 에이전트 Chat 이 놓칠 수 있습니다.

헤더 불일치 문제#

구체적인 오류 코드 없이 I'm sorry, I can't generate a response. Please try again이라는 오류가 표시될 수 있습니다.

Sidekiq 로그에서 Header mismatch 'X-Gitlab-Instance-Id' 오류가 있는지 확인합니다.

이 오류가 보이면 GitLab 지원 팀에 문의해 라이선스용 새 활성화 코드를 요청해 해결합니다.

자세한 내용은 이슈 103을 참고합니다.

Cloud Connector 상태 확인#

GitLab은 Cloud Connector와 관련된 다음과 같은 여러 구성 요소의 상태를 검증하는 스크립트를 제공합니다:

• 액세스 데이터
• 토큰
• 라이선스
• 호스트 연결
• 기능 접근성

더 자세한 출력을 보고 보고서 파일을 생성하려면 이 스크립트를 디버그 모드로 실행할 수 있습니다.

1. 단일 노드 인스턴스에 SSH로 접속해 스크립트를 내려받습니다:

   wget https://gitlab.com/gitlab-org/gitlab/-/snippets/3734617/raw/main/health_check.rb
   

2. Rails Runner로 스크립트를 실행합니다.

   스크립트의 전체 경로를 사용해야 합니다.

   Usage: gitlab-rails runner full_path/to/health_check.rb
          --debug                     Enable debug mode
          --output-file <file_path>   Write a report to a specified file
          --username <username>       Provide a username to test seat assignments
          --skip [CHECK]              Skip specific checks (options: access_data, token, license, host, features, end_to_end)