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

なぜ、output_formatを使用すると、Codexノードの構造化出力が未定義になったり、気付かれずに失われたりするのですか？

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ファイルが静かに無視されていました。Archonをアップグレードして、PR #1857の修正を含めてください。これにより、コマンドの発見がシンボリックリンクを追従するようになります。一時的な回避策として、シンボリックリンクを作成する代わりに、コマンドファイルをターゲットディレクトリにコピーしてください。

Question 4

output_formatを使用したDAGワークフローノードが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

v0.4.2より前のArchonバージョンは、起動時にPostgresのスキーマ変更を自動適用せず、アップグレード後にカラムが欠落する問題がありました。v0.4.2以降にアップグレードしてください。このバージョンでは、PostgresアダプタがSQLiteと同様に起動ごとに冪等なマイグレーションSQLを実行します。手動でのpsql手順は不要です。すぐにアップグレードできない場合は、一時的にデータベースに対して手動でmigrations/000_combined.sqlを実行できます。

Archon

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト