GitLab Duo Chat으로 작업할 때 다음 문제가 발생할 수 있습니다.

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

UI 오른쪽 상단에 버튼이 표시되지 않는 경우 GitLab Duo Chat이 활성화되어 있는지 확인하세요.

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

GitLab Duo Chat을 활성화한 후 버튼이 표시되는 데 몇 분이 걸릴 수 있습니다.

이것이 작동하지 않으면 다음 트러블슈팅 문서를 확인할 수도 있습니다:

• GitLab Duo 코드 제안.
• VS Code.
• Microsoft Visual Studio.
• JetBrains IDE.
• 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이 포함되어 있는지 확인하세요.

오류 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라는 오류 메시지가 표시될 수 있습니다.

이 오류는 취약점 설명 기능을 사용할 때 문제가 있는 경우 발생합니다.

오류 M4004#

This resource has no comments to summarize라는 오류 메시지가 표시될 수 있습니다.

이 오류는 토론 요약 기능을 사용할 때 문제가 있는 경우 발생합니다.

오류 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.라는 오류 메시지가 표시될 수 있습니다.

이 오류는 작업 트러블슈팅 기능을 사용할 때 문제가 있는 경우 발생합니다.

오류 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 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 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 상태 확인#

다음과 같은 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)