Question 1

Archon docs llms.txt가 404를 반환하는 이유와 해결 방법은 무엇인가요?

Accepted Answer

Archon 문서 웹사이트는 Starlight를 사용하는데, 기본적으로 llms.txt가 포함되어 있지 않습니다. 404 오류를 해결하고 AI 친화적인 엔드포인트를 제공하려면 starlight-llms-txt 플러그인을 추가하세요:
1. packages/docs-web에서 `npm install -D starlight-llms-txt` 실행
2. astro.config.mjs에서 플러그인을 임포트하고 starlight()의 plugins 배열에 추가:
   ```js
   import starlightLlmsTxt from 'starlight-llms-txt';
   // starlight 설정 내부
   plugins: [starlightLlmsTxt()],
   ```
3. 다시 빌드하고 배포합니다.
배포 후 `/llms.txt`, `/llms-full.txt`, `/llms-small.txt`가 AI 도구를 위한 문서 콘텐츠를 제공합니다.

Question 2

Codex node의 구조화된 출력이 output_format을 사용할 때 정의되지 않거나 조용히 사라지는 이유는 무엇인가요?

Accepted Answer

이는 Codex 제공자가 여러 agent_message 항목을 연결하여 잘못된 JSON을 생성하는 알려진 버그입니다. PR #1859의 수정 사항이 포함된 최신 Archon 버전으로 업그레이드하십시오. 이제 제공자는 구조화된 출력 파싱을 위해 마지막 agent_message만 사용합니다. 업그레이드가 불가능한 경우 임시 해결 방법은 output_format을 피하거나 모델이 단일 JSON 응답을 출력하도록 프롬프트하는 것입니다.

Question 3

왜 Archon이 .archon/commands 내의 심볼릭 링크된 명령 파일에 대해 'Command prompt not found'라고 말하나요?

Accepted Answer

이전 버전의 Archon은 심볼릭 링크를 인식하지 못하는 Dirent.isFile()을 사용하여, 사용자 정의 명령어 .md 파일이 조용히 무시되는 문제가 있었습니다. PR #1857의 수정 사항을 포함하도록 Archon을 업그레이드하십시오. 이 수정 사항은 명령어 탐색이 심볼릭 링크를 따르도록 합니다. 임시 해결 방법으로, 심볼릭 링크를 사용하는 대신 명령어 파일을 대상 디렉터리에 복사하십시오.

Question 4

왜 내 DAG 워크플로우 노드가 output_format을 사용하여 Codex에서 'additionalProperties is required to be supplied and to be false' 오류와 함께 실패하나요?

Accepted Answer

이는 Codex 제공자가 output_format 스키마를 OpenAI의 Structured Outputs API에 직접 전달하기 때문에 발생합니다. 이 API는 모든 객체에 `additionalProperties: false`가 포함되어 있어야 합니다. OpenAI는 이 속성이 누락된 스키마를 거부합니다. 해결하려면 워크플로우 YAML의 output_format에 있는 모든 객체에 수동으로 `additionalProperties: false`를 추가하세요. 예를 들어, 다음을:
```yaml
output_format:
  type: object
  properties:
    issue_type: { type: string, enum: [bug, feature, enhancement] }
    title: { type: string }
  required: [issue_type, title]
```
다음과 같이 변경하세요:
```yaml
output_format:
  type: object
  additionalProperties: false
  properties:
    issue_type: { type: string, enum: [bug, feature, enhancement] }
    title: { type: string }
  required: [issue_type, title]
```
`archon-fix-github-issue`와 같은 번들 워크플로우의 경우, 워크플로우 정의를 재정의하거나 복사본에 누락된 속성을 직접 추가해야 할 수 있습니다. 이는 Codex 제공자의 알려진 문제(#1843)이며, 스키마를 자동으로 정규화하는 영구적인 수정은 향후 릴리스에서 제공될 예정입니다. 그때까지는 Codex를 사용할 때 output_format 스키마의 모든 객체에 항상 `additionalProperties: false`를 포함하세요.

Question 5

Archon을 업그레이드한 후에 'column user_id does not exist' 오류가 발생하는 이유와 해결 방법은 무엇인가요?

Accepted Answer

Archon v0.4.2 이전 버전은 시작 시 Postgres 스키마 변경 사항을 자동으로 적용하지 않아 업그레이드 후 컬럼이 누락되는 문제가 있었습니다. v0.4.2 이상으로 업그레이드하면 Postgres 어댑터가 SQLite와 마찬가지로 부팅 시마다 멱등성 마이그레이션 SQL을 실행합니다. 수동 psql 단계가 필요하지 않습니다. 즉시 업그레이드할 수 없는 경우, 데이터베이스에 대해 수동으로 migrations/000_combined.sql을 일시적으로 실행할 수 있습니다.

Archon

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트