> ## 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: vincular, diagnosticar e migrar o registro

> Gerencie o perfil protegido de vinculação de engines no escopo do usuário do Symphony com list, inspect, doctor, bind, unbind e migrate vinculado a digest por meio do qxctl.

A gramática `qxctl knowledge engines ...` gerencia o perfil de vinculação `default`, protegido e no escopo do usuário, para as engines de vetores do Symphony. Ela vincula conteúdo selecionado para reconciliação posterior. Ela não instala, invoca, ativa, acopla, autentica, autoriza nem aplica uma engine.

## Comandos

```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 ...
```

Informe `absent` na primeira mutação do registro v2 ou o digest exato relatado por `list` nas mutações seguintes. Toda mutação é um compare-and-swap contra esse digest.

## Migração da v1 para a v2

> [!WARNING]
>
> Um estado válido do registro v1 continua legível. A migração para a v2 é um compare-and-swap exato e separado, e nunca é uma operação de seleção de versão. Não trate a migração como um caminho de atualização para a seleção de engines.

* `list` e `inspect` continuam funcionando com evidências v1.
* `migrate` produz uma geração v2 vinculada sem descartar a verdade da v1.
* Após a migração, use digests v2 nas mutações futuras.

## O que é um bind

Um bind seleciona conteúdo exato para reconciliação posterior pelo coordenador. Ele:

* Não instala uma engine
* Não invoca nem ativa uma engine
* Não acopla uma engine ao Maestro
* Não autentica um chamador
* Não autoriza o apply

## Superfícies relacionadas

> [card] [qxctl reconcile](https://docs.quanux.org/symphony/pt-BR/qxctl/reconcile.md)
>
> Reconcilie o conteúdo vinculado com um coordenador.

> [card] [qxctl lifecycle](https://docs.quanux.org/symphony/pt-BR/qxctl/lifecycle.md)
>
> Planos de ciclo de vida que usam engines vinculadas.

> [card] [Maestro](https://docs.quanux.org/symphony/pt-BR/governance/maestro.md)
>
> Autoridade de presença que registra acoplamentos, não vinculações.

> [card] [Visão geral das engines](https://docs.quanux.org/symphony/pt-BR/engines/overview.md)
>
> Engines de vetores instaláveis de forma independente.


## Related topics

- [qxctl knowledge: administração do ciclo de vida entre vetores](https://docs.quanux.org/symphony/pt-BR/qxctl/knowledge.md)
- [qxctl: linha de comando administrativa agêntica do Symphony](https://docs.quanux.org/symphony/pt-BR/qxctl/overview.md)
- [qxctl knowledge lifecycle: perfil, boot e apply](https://docs.quanux.org/symphony/pt-BR/qxctl/lifecycle.md)
- [qxctl knowledge reconcile: reconciliação de worktrees](https://docs.quanux.org/symphony/pt-BR/qxctl/reconcile.md)
- [SKVI: a engine Symphony Knowledge Vector Index](https://docs.quanux.org/symphony/pt-BR/skv/skvi.md)


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