Yapıtlar

Yapıtlar, ana iş akışı durum yükünü şişirmeden kalıcı iş akışı çıktılarını saklamanızı sağlar.

Taslak belgeler, çıkarılan JSON planları, alıntılar, kaynak bildirimleri, oluşturulan dosya yolları veya daha sonra incelemek istediğiniz istem ve yanıt anlık görüntüleri için uygundurlar. Bu özellik özellikle aracı iş akışlarında kullanışlıdır; her çalıştırma büyük ara çıktılar üretebilse de son durum küçük ve okunabilir kalır.

İş akışı durumu yerine neden yapıtlar

İş akışı durumu, sonraki adımın hemen ihtiyaç duyduğu küçük genel veriler için idealdir.

Çıktı normal durum değerlerinden büyükse, çoğunlukla daha sonra incelenecekse, inceleme veya dışa aktarma arayüzlerinde kullanılacaksa ya da tek bir büyük durum bloğu yerine adlandırılmış bir çıktı olarak modellenmesi daha uygunsa yapıtlar daha iyi bir seçenektir.

Geçerli iş akışı adımı için yapıt saklama

Kod zaten bir iş akışı adımında çalışıyorsa Queuety::put_current_artifact() kullanın:

use Queuety\Queuety;
use Queuety\Step;

final class DraftBriefStep implements Step
{
    public function handle(array $state): array
    {
        $draft = [
            'title' => 'Pricing brief',
            'body' => '...',
        ];

        Queuety::put_current_artifact(
            'draft',
            $draft,
            'json',
            [ 'source' => 'planner' ],
        );

        return [ 'draft_ready' => true ];
    }

    public function config(): array
    {
        return [];
    }
}

Queuety geçerli iş akışı kimliğini ve adım dizinini otomatik olarak ekler.

İş akışının dışından yapıt saklama

İş akışı kimliğini zaten biliyorsanız Queuety::put_artifact() kullanın:

Queuety::put_artifact(
    $workflow_id,
    'research_brief',
    "# Research Brief\n\nDone.",
    'markdown',
    metadata: [ 'reviewed_by' => 'editor@example.com' ],
);

Yapıtları geri okuma

$artifact = Queuety::workflow_artifact( $workflow_id, 'draft' );

$artifacts = Queuety::workflow_artifacts( $workflow_id );

Her yapıt kaydı key, kind, content, metadata, step_index, created_at ve updated_at alanlarını içerir. Queuety::workflow_artifacts(), ikinci bağımsız değişkeni olarak true iletilmediği sürece content alanını dışarıda bırakır.

İş akışı durumu entegrasyonu

Queuety::workflow_status() artık küçük bir yapıt özeti içeriyor:

$status = Queuety::workflow_status( $workflow_id );

echo $status->artifact_count; // 2
print_r( $status->artifact_keys ); // ['draft', 'citations']

Böylece tüm içeriklerini durum çıktısına taşımadan yapıtlar görünür kalır.

CLI

Bir iş akışının yapıtlarını listeleyin:

wp queuety workflow artifacts 42

Bir yapıtı içeriğiyle birlikte gösterin:

wp queuety workflow artifact 42 draft

Komut başvurusunun tamamı için CLI bölümüne bakın.

Dışa aktarma ve yeniden oynatma

Yapıtlar iş akışı dışa aktarımlarına eklenir ve yeniden oynatılan iş akışlarına kopyalanır.

Böylece yapıt destekli aracı çalıştırmaları, ortamlar arasında taşıdığınızda veya dışa aktarılan yürütme geçmişinden bir çalıştırmayı yeniden oluşturduğunuzda da incelenebilir durumda kalır.