조사 작업이 예상대로 진행되지 않는 경우 이 가이드를 통해 원인을 파악하고 조치를 취할 수 있습니다. 대부분의 문제는 다음과 같은 몇 가지 범주로 분류됩니다.
- 중단된 작업
- 너무 엄격하거나 너무 느슨한 유효성 검사
- 에이전트 또는 도구 오류
- 예기치 않은 것으로 보이는 인식 동작
새 상태로 중단된 작업
작업은 새로운 상태로 유지됩니다. 일반적인 원인:
충족되지 않은 종속성
이 작업은 터미널 상태가 아닌 다른 작업에 따라 달라집니다.
확인 방법: 작업을 열고 필드에 대한 의존도를 검토합니다 . 각 종속성의 상태를 확인합니다.
해결 방법:
- 종속성이 중단된 경우 먼저 해당 작업을 디버그합니다.
- 종속성이 더 이상 관련이 없는 경우 종속 성 필드에서 제거합니다.
- 종속성이 완료되었지만 작업에 여전히 새로 만들기가 표시되면 인식이 아직 작업에서 작동하지 않습니다. 1-2분 동안 기다립니다.
Cognition이 실행되지 않고 있습니다.
검색 모드가 중지될 수 있습니다.
확인 방법: 조사에서 검색 모드가 사용하도록 설정되어 있는지 확인합니다.
해결 방법: 검색 모드를 사용하도록 설정합니다. 인식은 추론 루프를 시작하고 준비된 작업을 선택합니다.
메모
서비스 업그레이드 중에 검색 모드가 중지할 수 있습니다. 예상된 일입니다. 조사 데이터, 작업 결과 및 실행 기록이 유지됩니다. 검색 모드를 다시 사용하도록 설정하여 다시 시작합니다.
검색 엔진이 시작되지 않음
작업 유효성 검사에 필요한 채팅 모델이 배포되지 않을 수 있습니다.
확인 방법: 작업 영역에 gpt-5-2이라는 이름의 채팅 모델 배포가 있는지 (모델: gpt-5.2) 확인합니다.
해결 방법: 모델을 배포한 다음( 채팅 모델 배포 만들기 참조) 검색 모드를 사용하도록 설정합니다.
인지 기능이 다른 작업으로 바쁩니다.
많은 태스크가 실행 중이거나 유효성 검사 중이면 새 작업을 시작하기 전에 인식이 용량을 기다리고 있을 수 있습니다.
확인 방법: 현재 실행 상태에 있는 작업의 수를 확인합니다. 조사 활동을 확인하여 인식이 대기 주기에 있는지 확인합니다.
해결 방법: 일부 작업이 완료되기를 기다립니다. 인식은 우선 순위 및 종속성 준비 상태를 기반으로 작업의 우선 순위를 지정합니다.
실행 상태에서 작업이 중단됨
에이전트가 작업하는 동안 작업은 실행 중 상태로 유지됩니다. 비정상적으로 오랜 시간 동안 지속되는 경우 뭔가 잘못되었을 수 있습니다.
일반 실행 시간
작업이 중단된 것으로 가정하기 전에 어떤 일이 일어나고 있는지 고려합니다.
- 에이전트 전용 작업 (도구 호출 없음): 일반적으로 1분 안에 완료됩니다.
- 도구 호출이 있는 작업: 세션의 첫 번째 도구 호출은 슈퍼컴퓨터 콜드 시작으로 인해 2-4분이 걸릴 수 있습니다. 후속 호출은 더 빠릅니다(1분 미만).
- 계산이 많은 작업: 일부 도구는 5~15분이 걸리는 시뮬레이션 또는 대규모 분석을 실행합니다.
에이전트의 응답이 중단됨
작업이 도구 작업 없이 15분 이상 실행된 경우 기본 모델 응답이 중단될 수 있습니다.
확인 방법: 현재 실행에 대한 작업의 실행 기록을 확인합니다. 응답에 오랜 기간 동안 새 출력이 없는 "진행 중"이 표시되면 응답이 모델 계층에서 중단될 수 있습니다.
해결 방법:
- 검색 모드를 중지하고 다시 시작합니다. 이로 인해 인식이 모든 작업을 재평가하고 중단된 작업을 다시 시도합니다.
- 문제가 지속되면 작업 영역의 모델 배포가 정상인지 확인합니다.
도구 실행 실패
에이전트가 도구를 호출했지만 도구에서 오류를 반환했습니다.
확인 방법: 도구 호출 결과에 대한 실행 기록을 확인합니다. 일반적으로 도구의 오류 메시지에는 무엇이 잘못되었는지에 대한 세부 정보가 포함됩니다.
일반적인 도구 오류 및 수정 사항:
| 오류 | 가능한 원인 | 수정 |
|---|---|---|
| 로그 없이 "도구 실행 실패" | 슈퍼컴퓨터 노드를 시작할 수 없습니다(VM SKU 제한, 할당량 초과) | 노드 풀 구성 및 VM SKU 가용성 확인 |
| 외부 API에 대한 연결 제한 시간 | 슈퍼컴퓨터 서브넷에 대한 네트워크 제한 사항 | 노드 풀에서 필요한 엔드포인트에 액세스할 수 있는지 확인합니다. 슈퍼컴퓨터 및 노드 풀 관리 참조 |
| 인증 오류(403) | 작업 영역 또는 슈퍼컴퓨터 ID에 대한 역할 할당 누락 | 관리 ID에 스토리지 계정, 컨테이너 레지스트리 및 기타 리소스에 필요한 역할이 있는지 확인합니다. |
| 컨테이너 이미지 끌어오기 실패 | 슈퍼컴퓨터에서 ACR에 액세스할 수 없거나 이미지가 없습니다. | ACR 네트워크 규칙을 확인하고 이미지가 푸시되었는지 확인합니다. |
실행 중과 불완전한 작업 간에 순환하는 작업
태스크가 실행에서 불완전한 작업으로 반복적으로 이동하고 뒤로 이동하면 결과가 유효성 검사 요구 사항을 충족하지 않으므로 인식이 다시 시도됩니다.
유효성 검사 요구 사항이 너무 엄격합니다.
에이전트는 합리적인 결과를 생성하지만 유효성 검사 조건이 요구하는 것과 정확하게 일치하지는 않습니다.
확인 방법: 작업에 대한 유효성 검사 주석을 읽습니다. 각 시도에는 통과된 요구 사항과 실패한 요구 사항을 설명하는 설명이 포함됩니다.
해결 방법:
- 사용 가능한 에이전트 및 도구를 사용하여 달성할 수 있도록 유효성 검사 요구 사항을 조정합니다.
- 철저한 세부 정보를 요구하기보다는 가장 중요한 사항에 집중하기 위한 요구 사항을 다시 설명합니다.
- 유효성 검사 조정에 대한 지침으로 신뢰 관계 및 기본 조사 패턴을 참조하세요.
에이전트가 작업을 수행할 수 없습니다.
할당된 에이전트에 작업에 필요한 작업 유형에 대한 올바른 도구 또는 지침이 없을 수 있습니다.
확인 방법: 특정 에이전트에 할당된 인지를 확인하세요. 에이전트에 작업에 필요한 도구가 있는지 확인합니다. 에이전트의 기능 요약을 작업 요구 사항과 비교합니다.
해결 방법:
- 다른 에이전트가 더 적합한 경우 사용할 에이전트와 이유를 지정하는 주석을 작업에 추가합니다(예: "이 작업에 molToolkit 사용.) SMILES 유효성 검사를 위해 RDKit가 필요합니다"). 인식은 에이전트를 선택할 때 주석을 읽습니다.
- 적합한 에이전트가 없는 경우 에이전트를 만들거나 구성해야 할 수 있습니다. 검색 에이전트 개념을 참조하세요.
작업 설명이 모호함
작업 설명이 에이전트에 충분한 컨텍스트를 제공하지 않는 경우 에이전트는 기술적으로 유효하지만 요점을 놓친 결과를 생성할 수 있습니다.
확인 방법: 에이전트의 결과를 읽고 실제로 원하는 것과 비교합니다. 결과가 설명을 문자 그대로 다루지만 의도를 놓친 경우 설명에 더 많은 컨텍스트가 필요합니다.
해결 방법: 원하는 항목에 대한 자세한 세부 정보로 작업 설명을 업데이트한 다음 상태를 다시 새로 만들기로 설정합니다.
사용자 주의 필요로 플래그가 지정된 작업
인식이 작업에 플래그를 지정하는 경우 인식이 여러 가지 방법을 시도했지만 유효성 검사를 통과하는 결과를 생성할 수 없다는 의미입니다.
진단 방법:
- 실행 기록 확인: 얼마나 많은 실행이 시도되었나요? 어떤 접근 방식이 시도되었습니까?
- 유효성 검사 주석 읽기: 각 시도에서 실패한 특정 요구 사항은 무엇인가요?
- 최신 결과 검토: 필요한 항목인가요, 아니면 꺼져 있나요?
해결 옵션:
- 결과를 수락합니다. 최신 결과가 충분한 경우 유효성 검사 요구 사항을 업데이트하고 작업 완료를 표시합니다.
- 지침 제공: 누락된 내용 또는 시도할 방법을 설명하는 설명을 추가합니다. 상태를 다시 새로 만들기로 설정합니다.
- 작업을 세분화합니다. 작업이 단일 에이전트에 대해 너무 복잡한 경우 더 작은 자식 작업으로 분해합니다.
- 안내 에이전트 선택: 현재 에이전트에 올바른 기능이 없는 경우 사용할 에이전트와 이유를 지정하는 주석을 추가한 다음 상태를 다시 새로 만들기로 설정합니다.
- 작업 제거: 작업이 더 이상 관련이 없는 경우 해당 상태를 제거됨으로 설정하여 인식이 계속되도록 합니다.
인식 동작 문제
인식 준비에는 시간이 오래 걸립니다.
검색 모드를 처음 사용하도록 설정하면 인식은 모든 작업을 검토하고 접근 방식을 계획하여 컨텍스트를 빌드하는 준비 기간을 거치게 됩니다. 일반적으로 30-90초가 걸리며 첫 번째 작업이 시작되기 전에 몇 가지 내부 추론 주기가 포함됩니다.
이것은 정상적인 동작입니다. 예열 중에 검색 모드를 중지하고 다시 활성화하지 마세요. 다시 시작할 때마다 새로운 예열 기간이 시작됩니다.
인식은 작업하는 대신 계속 대기합니다.
인식이 대기 루프에 있는 것처럼 보이는 경우(새 작업을 시작하지 않고 작업 상태를 반복적으로 확인) 활성 상태의 다른 작업을 차단할 수 있습니다.
확인 방법: 오랫동안 있는 실행 또는 유효성 검사 상태의 작업을 찾습니다. 작업 상태가 인식이 앞으로 이동하지 못하도록 차단할 수 있습니다.
해결 방법: 먼저 중단된 작업을 해결합니다. 차단기가 지워지면 인식이 정상 작업을 다시 시작합니다.
인지가 잘못된 에이전트를 지정합니다.
인식은 에이전트 기능 및 작업 요구 사항에 대한 평가에 따라 에이전트를 선택합니다. 경우에 따라 작업에 적합한 도구가 없는 에이전트를 선택할 수 있습니다.
확인 방법: 태스크의 할당된 에이전트를 살펴보고 해당 기능 요약을 작업에 필요한 것과 비교합니다.
해결 방법:
- 사용할 에이전트를 지정하는 작업에 주석을 추가합니다(예: "이 작업에는 paperAnalyzer가 필요합니다. 문헌 검색 기능이 필요합니다"). 인식은 다음 시도에서 에이전트를 선택할 때 주석을 읽습니다.
- 이 문제가 반복적으로 발생하는 경우 에이전트에 명확하고 설명적인 기능 요약이 있는지 확인하여 인식이 더 나은 선택을 할 수 있도록 합니다.
인식은 너무 많은 하위 작업을 만듭니다.
인식은 광범위한 목표를 필요한 것보다 더 많은 하위 작업으로 분해할 수 있습니다.
해결 방법:
- 상태를 Removeed로 설정하여 유용하지 않은 하위 작업을 제거합니다.
- 특정 영역에 집중하도록 인식 안내하는 부모 작업에 주석을 추가합니다.
- 완전한 자율성 대신 단계별 탐색 패턴을 사용하여 인식 경계를 지정합니다.
출력 파일을 볼 수 없습니다.
작업은 완료로 표시되고 결과는 파일 출력을 언급하지만 파일 링크를 클릭하면 액세스 오류가 표시됩니다.
이 경우 에이전트는 플랫폼의 관리 ID를 사용하여 파일을 만듭니다. VS Code에서 파일을 볼 때 브라우저는 ID 를 사용하여 Blob Storage에 직접 액세스합니다. 두 개의 별도 액세스 경로입니다.
파일을 보려면 다음 세 가지가 있어야 합니다.
| 확인 | 필요한 사항 | 누가 수정하는가? |
|---|---|---|
| Network | 스토리지 계정 방화벽에서 IP(또는 VPN)를 허용해야 합니다. | 관리자 |
| CORS | 스토리지 계정은 vscode.dev 및 *.vscode-cdn.net로부터의 요청을 반드시 허용해야 합니다. |
관리자 |
| 권한 | 스토리지 계정에 대해 계정에 Storage Blob Data Reader 권한이 필요합니다. | 관리자 |
파일이 누락된 경우 파일이 성공적으로 만들어졌음에도 불구하고 파일 링크를 클릭할 때 오류가 표시됩니다.
해결 방법: 스토리지 계정 이름(스토리지 컨테이너 속성에 표시됨)으로 관리자에게 문의하고 세 항목을 모두 확인하도록 요청합니다. 전체 구성 요구 사항은 Microsoft 디스커버리의 Azure Blob Storage를 참조하세요.
메모
조사는 파일 액세스와 관계없이 계속 올바르게 작동합니다. 에이전트는 파일을 읽고 쓸 수 있고, 인식은 파일 콘텐츠의 유효성을 검사할 수 있으며, 작업 결과는 텍스트 출력을 캡처합니다. 액세스 문제는 파일을 직접 보는 기능에만 영향을 줍니다.
조사 상태 확인
조사 상태를 빠르게 평가하려면 다음을 수행합니다.
- 상태별 작업 수: 완료 수와 새로 만들기 및 실행 중 및 사용자 주의가 필요한 항목은 몇 개인가요?
- 장애물 식별: 실행 중 또는 사용자의 주의가 필요한 작업 중에서 다른 작업을 지연시키고 있는 것이 있나요?
- 인식 상태 확인: 검색 모드가 사용하도록 설정되어 있나요? 인지가 적극적으로 순환하고 있습니까?
- 최근 활동 검토: 지난 30분 동안 변경된 내용이 있나요? 그렇지 않은 경우 중단될 수 있습니다.
조사 상태 해석에 도움이 필요한 경우 개별 작업에 대한 실행 기록은 발생한 내용과 그 이유에 대한 가장 자세한 정보를 제공합니다.