Question 1

React StrictMode 환경의 Next.js 개발 모드에서 useCopilotAction의 renderAndWaitForResponse가 아무것도 렌더링하지 않는 이유는 무엇인가요?

Accepted Answer

이 문제는 `@copilotkit/react-core` 1.53.x 및 이전 버전의 StrictMode 리마운트 버그로 인해 발생합니다. 프로바이더의 가드된 이펙트가 훅을 통해 등록된 `renderToolCalls`를 props만으로 구성된 목록으로 덮어쓰기 때문에 `next dev`에서 `useHumanInTheLoop` / `renderAndWaitForResponse` UI가 누락됩니다. `@copilotkit/react-core` 1.54.0 이상으로 업그레이드하세요. 1.54.1은 정상 작동이 확인되었습니다: `npm install @copilotkit/react-core@^1.54.1`. `@copilotkitnext/react`와 같은 관련 CopilotKit 패키지도 호환되는 버전으로 업그레이드하세요. 임시 해결 방법으로 `next.config.js`에서 `reactStrictMode: false`로 StrictMode를 비활성화하세요. 프로덕션 빌드는 이펙트를 이중으로 호출하지 않으므로 영향을 받지 않습니다.

Question 2

CopilotKit run을 중지한 후 /connect replay에서 ZodError "threadId Required, runId Required"를 수정하려면 어떻게 해야 하나요?

Accepted Answer

CopilotKit를 v1.76.0 이상으로 업그레이드하세요. 중지 시 생성되는 `RUN_FINISHED` 이벤트가 이제 실행의 `threadId`와 `runId`를 포함하므로, `/connect` 재생(replay) 중에 `@ag-ui/core` 스키마 유효성 검사를 통과합니다.

```bash
npm install @copilotkit/runtime@^1.76.0
# 다른 @copilotkit/* 패키지도 동일한 릴리스로 업데이트하세요
```

즉시 업그레이드할 수 없는 경우, 인메모리 런타임을 재시작하여 유효하지 않은 저장된 이벤트를 삭제하세요. SQLite와 같은 영구 스토리지의 경우, 실행 기록에서 일치하는 `{"type":"RUN_FINISHED"}` 이벤트를 제거하세요. 소스 수준의 해결 방법은 `finalizeRunEvents`를 패치하여, 합성 `RUN_FINISHED`가 `{ type: EventType.RUN_FINISHED }`만 추가하는 대신 해당하는 `RUN_STARTED` 이벤트에서 `threadId`와 `runId`를 복사하도록 하는 것입니다.

Question 3

CopilotKit A2UIProvider (@copilotkit/a2ui-renderer)에서 onAction이 완료되기 전에 dispatchAction이 resolve되는 이유는 무엇인가요?

Accepted Answer

이는 `@copilotkit/a2ui-renderer` (v1.71.1)의 알려진 버그입니다: `OnActionCallback`이 `(message) => void | Promise<void>` 타입으로 선언되어 있음에도 불구하고, `A2UIProvider`는 `MessageProcessor` 액션 핸들러와 surface의 `dispatch` 메서드 양쪽 모두에서 `onActionRef.current(message)`를 호출하면서 그 결과를 반환하지 않습니다. 따라서 프로미스가 누락되고 `dispatchAction`이 즉시 resolve됩니다. **수정 방법:** `packages/a2ui-renderer/src/react-renderer/core/A2UIProvider.tsx`를 패치하여 두 곳 모두에서 콜백의 결과를 반환하도록 하세요:

```tsx
// MessageProcessor action handler
processorRef.current = new MessageProcessor([...], (action) => {
  if (onActionRef.current) {
    // ...build `message`
    return onActionRef.current(message);
  }
});

// dispatch
dispatch: (message: any) => onActionRef.current?.(message),
```

이 변경은 동기 핸들러에도 안전합니다. `@a2ui/web_core`는 이미 프로미스를 전파하므로(`SurfaceModel.dispatchAction`이 `onAction.emit(...)`을 await하고, `EventEmitter.emit`이 각 리스너를 await함), 값을 반환하기만 하면 됩니다. **패치될 때까지의 임시 해결 방법:** `A2UIProvider` 없이 순수한 `MessageProcessor`를 직접 사용하되, 액션 핸들러가 비동기 `onAction` 프로미스를 반환하도록 하세요. 그러면 `dispatchAction`이 핸들러가 완료된 후 올바르게 resolve됩니다.

Question 4

LangGraph에서 `ag_ui`와 `ag-ui` 상태 키 불일치로 인해 발생하는 CopilotKit A2UI 렌더링 실패는 어떻게 해결하나요?

Accepted Answer

LangGraph는 하이픈이 포함된 `ag-ui` 상태 키를 `ag_ui`로 정규화할 수 있는 반면, CopilotKit 미들웨어는 `state["ag-ui"]`만 읽습니다. 그 결과 `a2ui_schema`와 `inject_a2ui_tool`을 찾을 수 없어 A2UI 도구가 주입되지 않고, 컴포넌트가 unknown으로 렌더링될 수 있습니다.

해결 방법: 영향을 받는 각 노드에서 CopilotKit/A2UI 로직이 실행되기 전에 상태 키를 정규화하세요:

```python
async def chat_node(state):
    if "ag_ui" in state and "ag-ui" not in state:
        state["ag-ui"] = state["ag_ui"]

# 기존 에이전트 로직
    response = await model.ainvoke(state["messages"])
    return {"messages": [response]}
```

하위 에이전트 또는 A2UI 상태를 읽는 모든 노드에 동일한 정규화를 적용하세요. 다음과 같이 실제 키를 확인할 수 있습니다:

```python
print("ag-ui" in state, "ag_ui" in state)
print(list(state.keys()))
```

영향을 받는 구성에는 CopilotKit 0.1.94+, `ag-ui-langgraph` 0.0.40+, LangGraph 1.1.0+가 포함됩니다.

Question 5

시작 검사에서 레코드 하나는 나열되지만 모든 레코드를 카운트할 때 시간 초과가 발생하는 경우 PocketBase의 'context deadline exceeded' 오류를 어떻게 해결하나요?

Accepted Answer

PocketBase의 `list()` 메서드는 `perPage`가 1로 설정되어 있어도 기본적으로 전체 레코드 수를 계산합니다. `cvdiag_events`처럼 약 2,360만 개의 행을 가진 대규모 테이블에서는 생성되는 `SELECT COUNT(DISTINCT id)` 쿼리가 PocketBase의 30초 제한 시간을 초과하여 HTTP 400을 반환할 수 있습니다.

전체 개수 계산을 비활성화하여 존재 여부 확인을 수정하세요:

```js
pb.list(collection, {
  perPage: 1,
  skipTotal: true,
});
```

이를 두 진단 컬렉션 확인 모두에 적용하세요:

- `cvdiag_events`
- `cvdiag_raw_byte_samples`

보고된 스테이징 환경에서는 `perPage=1&skipTotal=true`를 사용한 읽기 전용 확인이 112ms 만에 완료되었습니다. 기존의 상태, 인증, 누락된 컬렉션 및 권한 확인은 변경하지 않고 유지하세요. 스키마 변경, 재시도 정책 또는 타임아웃 증가는 필요하지 않습니다. 시작 프로브가 실패하면 `buildCvdiagPersistenceWriter()`가 내구성 진단을 비활성화하고 이벤트가 stdout으로 폴백되므로, 오해를 불러일으키는 일반적인 `cvdiag.pb-writer.write-failed` 로그는 시작 읽기/프로브 실패로 해석해야 합니다.

CopilotKit

개요

README 미리보기

FAQ (5)

同类型项目

tensorflow

superpowers

everything-claude-code

flutter