---
id: "fluxos.orquestracao-entrega"
titulo: "Declarar a entrega de um agente"
resumo: "Encerre as acordadas do seu terminal quando o trabalho realmente terminou — e saiba quando não declarar."
idioma: "pt-br"
tipo: "guia"
categoria: "agentes"
aplicavelDesde: "0.0.16"
capabilities: ["wake.delivery.declare"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/fluxos/orquestracao-entrega/"
fonte: "pt-br/fluxos/orquestracao-entrega.md"
caminhoPublico: "docs/publica/pt-br/fluxos/orquestracao-entrega.md"
hashFonte: "sha256:740d1c8a775bfc12b4356762df581f8c9fe2892de686111d9f6a4d16856f6711"
hashDestaPagina: "sha256:740d1c8a775bfc12b4356762df581f8c9fe2892de686111d9f6a4d16856f6711"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
Existe um estado em que um agente terminou o trabalho, mas continua sendo acordado como se ainda
estivesse devendo algo. A declaração de entrega existe para encerrar isso.

## O comando

```bash
elyra wake delivered --text "o que foi entregue"
```

Ele é executado **no próprio terminal que entregou** e faz duas coisas: registra o que foi entregue e
**interrompe as acordadas daquele terminal**.

O texto é obrigatório e não pode ser vazio. O motivo é direto: um booleano é fácil de mentir, um relato
de entrega não é. Quem apenas **prometeu** fazer ainda não tem o que escrever aqui.

## Consultar o estado

```bash
elyra wake status
```

Ele responde se este terminal já declarou a entrega, e com que texto — ou que nada foi registrado.

## Quando não declarar

- **Quando você só assumiu o compromisso.** Declarar antes de entregar silencia o aviso de trabalho
  pendente, e a pendência continua existindo — sem ninguém lembrando dela.
- **Quando ainda há parte do trabalho em andamento.** A declaração é sobre o que terminou.
- **Em nome de outro terminal.** A declaração vale para quem a executa; não existe forma de declarar a
  entrega de outro agente.

## O que reabre a pendência

**Trabalho novo invalida a declaração.** Uma mensagem da pessoa ou uma tarefa do coordenador devolve o
terminal à fila de acordadas. Isso é intencional: entrega não é aposentadoria — é o fim de um ciclo.

## Escopo e limites

- **Não há desfazer explícito.** Para voltar a receber acordadas, o caminho é receber trabalho novo.
- **A declaração é por terminal.** Dois terminais com o mesmo papel não compartilham a declaração.

## Ver também

- [Orquestração: o maestro e os cartões ligados](/docs/pt-br/fluxos/orquestracao-conceito/)
- [Mensagens entre agentes](/docs/pt-br/fluxos/orquestracao-mensagens/)