> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quanux.org/symphony/llms.txt
> Use this file to discover all available pages before exploring further.

# qxctl knowledge engines: レジストリのバインド、診断、移行

> qxctl の list、inspect、doctor、bind、unbind、およびダイジェストにバインドされた migrate を使用して、Symphony の保護されたユーザースコープのエンジンバインディングプロファイルを管理します。

`qxctl knowledge engines ...` グラマーは、Symphony のベクトルエンジン向けの保護されたユーザースコープ `default` バインディングプロファイルを管理します。選択したコンテンツを後の reconciliation のためにバインドします。エンジンのインストール、呼び出し、有効化、ドッキング、認証、認可、apply は行いません。

## コマンド

```bash Engines grammar theme={null}
qxctl knowledge engines list
qxctl knowledge engines inspect
qxctl knowledge engines doctor
qxctl knowledge engines bind    --expected-registry-digest absent|DIGEST ...
qxctl knowledge engines unbind  --expected-registry-digest DIGEST ...
qxctl knowledge engines migrate --expected-registry-digest DIGEST ...
```

最初の v2 レジストリ変更には `absent` を指定し、以降の変更には `list` が報告する正確なダイジェストを指定します。すべての変更は、そのダイジェストに対する compare-and-swap です。

## v1 から v2 への移行

> [!WARNING]
>
> 有効な v1 レジストリ状態は引き続き読み取り可能です。v2 への移行は独立した厳密な compare-and-swap であり、バージョン選択操作になることはありません。移行をエンジン選択のアップグレードパスとして扱わないでください。

* `list` と `inspect` は v1 のエビデンスに対しても引き続き動作します。
* `migrate` は v1 の真実を破棄することなく、リンクされた v2 世代を生成します。
* 移行後は、以降の変更に v2 のダイジェストを使用します。

## bind とは

bind は、コーディネーターによる後の reconciliation のために正確なコンテンツを選択します。bind は次のことを行いません。

* エンジンをインストールしない
* エンジンを呼び出したり有効化したりしない
* エンジンを Maestro にドッキングしない
* 呼び出し元を認証しない
* apply を認可しない

## 関連するサーフェス

> [card] [qxctl reconcile](https://docs.quanux.org/symphony/ja/qxctl/reconcile.md)
>
> バインドされたコンテンツをコーディネーターと reconcile します。

> [card] [qxctl lifecycle](https://docs.quanux.org/symphony/ja/qxctl/lifecycle.md)
>
> バインドされたエンジンを使用するライフサイクルプラン。

> [card] [Maestro](https://docs.quanux.org/symphony/ja/governance/maestro.md)
>
> バインディングではなくドッキングを記録するプレゼンスオーソリティ。

> [card] [エンジンの概要](https://docs.quanux.org/symphony/ja/engines/overview.md)
>
> 個別にインストール可能なベクトルエンジン。


## Related topics

- [qxctl knowledge: ベクトル横断のライフサイクル管理](https://docs.quanux.org/symphony/ja/qxctl/knowledge.md)
- [qxctl: Symphony のエージェント型管理コマンドライン](https://docs.quanux.org/symphony/ja/qxctl/overview.md)
- [qxctl maestro: Symphony のレセプタープレゼンスインベントリの読み取り](https://docs.quanux.org/symphony/ja/qxctl/maestro.md)
- [SSFV: Symphony Semantic Feature Vector とレジストリ](https://docs.quanux.org/symphony/ja/skv/ssfv.md)
- [qxctl knowledge session: 認証済み Symphony セッション](https://docs.quanux.org/symphony/ja/qxctl/session.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.