Süreç Bağlam Grafiği Alma

Süreç bağlam grafiği, projenizin olay kaydından oluşturulan ve sürecinizin aslında nasıl çalıştığını açıklayan tek bir JSON belgesidir: bir vaka nedir, vakalar nasıl başlar ve biter, adımlar ve aralarındaki geçişler, vakaların izlediği yollar, ayrıldıkları noktalar ve ayrılmayı açıklayan kurallar, nelerin yanlış gittiği, süreçlerin ne kadar sürdüğü ve kimlerin ne yaptığı. Her bölüm dayandığı veri miktarını belirtir.

"Pazarın kullandığı ama arkasında standart olmayan" bir isimdir süreç bağlam grafiği. mindzie’nin bu konuda kastettiği şudur: projenin halihazırda yanıtlayabildiği şeylerden oluşturduğumuz, bir ajanın yükleyip bir kişinin kontrol edebileceği sabit biçimde tek bir belgede tanımlanmış varsayılan bir şema. Proje grafikte olandan çok daha fazla bilgi verebilir; Kendi Raporlarınız ve JSON bununla ilgilidir.

Graf üzerinde iki tip ajan buluşur. İç ajanın - proje içinde çalışan mindzie ajanı - Süreç Bağlam Grafiği raporu çalıştırıldığında oluşturur. Dış ajan - sizin kendi programladığınız, kendi makinenizden çalışan ajan - projeden tek bir çağrıyla ister. Kendi Ajanınızı Bağlayın sıfırdan başlayarak ve ikisinin nasıl uyduğunu göstererek anlatır.

Ne İçin Kullanılır

  • Bir ajan yükler süreciniz üzerinde çalışmaya başlamadan önce; böylece gerçek adımları, normal yolu, karar noktalarını ve istisnaları, bunları tek tek keşfetmeye gerek kalmadan bilir.
  • Bir kişi kontrol eder. Aynı içerik Raporlar ekranında bir rapor olarak yazdırılır; süreç haritası, açıklanan her karar için karar tablosu ve her ifadenin yanında kanıtı vardır. Raporun tabloları ve JSON aynı veriden yazıldığı için birbirleriyle çelişmezler.

Bu sadece bir tanımlamadır. Hiçbir öneride bulunmaz ve kimsenin ne yapmasına izin verildiğini söylemez.

İki Adımda Alın

Adım 1 - Süreç Bağlam Grafiği raporunu bir kez çalıştırın

Ekranda: projenin Raporlar ekranını açın, Süreç Bağlam Grafiği kartında Rapor oluşturya tıklayın, ardından Başlata tıklayın. Bkz. Raporlar.

Kendi ajandanızla: projeyi başlatıp verinizi yükledikten sonra, ajan kartı bulup başlatır:

mz reports cards
mz jobs create-agent --card process-context-graph
mz jobs run --slug process-context-graph
mz jobs status --slug process-context-graph

mz jobs create-agent --card işlemin slugını döner, sonraki iki komut onu kullanır; kart daha önce çalıştırılmamış bir projede process-context-graph`dır. Çalıştırma bir AI görevidir: projenizin AI kredilerini kullanır. Bittiğinde rapor, diğerleri gibi Raporlar ekranında yayınlanır.

Beklemeye hazırlıklı olun. 1,6 milyon olay ve yaklaşık 250.000 vaka olan bir günlükte 45 dakika sürdü; böyle büyük bir kayıt için bir saate kadar plan yapın. mz jobs status done diyene kadar running der; arada ilerleme göstermez. Projede işler tek tek çalışır, arada başka işler başlatılırsa sıra onlara geçer.

Tekrar çalıştırmak aynı raporun yeni sürümünü yayınlar. Önceki sürüm ve JSON tam olarak olduğu gibi kalır.

Adım 2 - Grafiği tek çağrıda alın

mz reports context-graph > process-context-graph.json

Bu komut projenin güncel süreç bağlam grafiğini JSON olarak dosyaya yazar: şekli mindzie.process-context-graph olarak adlandırılan en yeni yayınlanan belgeyi alır. Yeniden hesaplama ve AI kullanımı yoktur - çağrı zaten yayınlanmış raporu okur. Aynı belge, kart raporunun taşıdığı process-context-graph.json dosyasıdır; dolayısıyla mz reports attachment --slug process-context-graph --name process-context-graph.json tam olarak aynı baytları döner.

Rapor bu projede hiç çalıştırılmamışsa, çağrı reddeder ve bir rapor oluşturmak için (Adım 1) komutları bildirir. Raporu kendisi başlatmaz, çünkü bu AI kredilerinizi haberiniz olmadan harcar.

Windows'ta bunu Komut İstemi'nde çalıştırın: Windows PowerShell, > ile dosyaya gönderilen metni yeniden kodlar. Dosyayı tanıma karşı kontrol etmek için aşağıdaki Kendi grafiğinizi kontrol edin bölümüne bakın. Agentınızın mz ve anahtarını nasıl aldığı Kendi Ajanınızı Bağlayın sayfasında anlatılır.

Gerçek Bir Örnek

Aşağıdaki grafik, gerçek bir satın alma-ödeme kayıtlarından oluşan günlükte Süreç Bağlam Grafiği kartı tarafından oluşturuldu: 1.593.532 olay, 251.658 vaka, her vaka bir satın alma siparişi kalemi. JSON’ı yaklaşık 300 KB ve içinde 44 adım, 188 geçiş, 16 varyant, 25 karar noktası, 48 sıralama kuralı, 48 istisna, 4 yükseltme, 25 politika, 20 varsayım ve 7 açık soru içeriyor. Sayfanın sonundaki tanıma uygundur.

Resim olarak çizimi

Gerçek bir süreç bağlam grafiğinin JSON’dan çizilmiş ana akışı

Bu resim kısa bir betikle JSON’dan doğrudan çizilmiştir; içeriğinin ne olduğunu göstermek için. Grafik kendi aşamalarında, adımları ve en yoğun geçişleri - vakaların en az %4’ünün aldığı - vakaların sayısıyla ve tipik beklemeyle gösteriyor. Kalın çizgiler ana akış, kesik çizgiler diğer yollar ve kırmızı kesik çizgiler grafiğin istisna olarak işaretledikleridir. Buradan okunabilir: kalemlerin %72’si Clear Invoice ile sona erer, ve en uzun tipik bekleme fatura alımından temizlemeye kadardır, 36 gün.

Kısaltılmış JSON

-Agentın aldığı hali, çoğu liste tek girdiye indirgenmiş ve 22 bölümden 14’ü çıkarılmış, son satırda belirtildiği gibi. Her iddia kanıtını taşır: kaç vaka, toplamdan kaç tane, nasıl ölçüldüğü ve gücü.

{
  "schema": "mindzie.process-context-graph",
  "schema_version": "1.0",
  "source": {
    "data_version": "v0001",
    "log_digest": "4804d5916fc0",
    "case_notion": "bir satın alma siparişi kalem satırı (satın alma sipariş numarası artı kalem numarası)",
    "cases": 251658,
    "events": 1593532,
    "period_start": "2015-03-08",
    "period_end": "2020-04-09",
    "time_basis": "clock"
  },
  "success_criteria": [
    {
      "id": "sc:cleared",
      "statement": "Kalem ödenmiştir: vaka Clear Invoice ile sona erer.",
      "test": "vakanın son olayı Clear Invoice",
      "share_met": 0.7203,
      "evidence": {
        "cases": 181257,
        "of_cases": 251658,
        "share": 0.7203,
        "strength": "counted",
        "method": "son olayı Clear Invoice olan vakaların doğrudan sayımı"
      }
    }
  ],
  "outcomes": [
    {
      "id": "out:clear-invoice",
      "end_activity": "Clear Invoice",
      "kind": "success",
      "cases": 181257,
      "share": 0.7203
    },
    {
      "id": "out:record-invoice-receipt",
      "end_activity": "Record Invoice Receipt",
      "kind": "open",
      "cases": 23089,
      "share": 0.0917
    }
  ],
  "edges": [
    {
      "id": "edge:record-invoice-receipt>clear-invoice",
      "from": "act:record-invoice-receipt",
      "to": "act:clear-invoice",
      "kind": "normal",
      "cases": 132667,
      "share_of_from": 0.6575,
      "median_wait_hours": 865.617,
      "slow_wait_hours": 2479.663,
      "evidence": {
        "cases": 132667,
        "of_cases": 211303,
        "share": 0.6279,
        "strength": "counted",
        "method": "bu geçişi en az bir kez yapan vakalar, ilk adımı gerçekleştiren toplam vakalar içinden; ilk adımın payı her ziyaret sayılır"
      }
    }
  ],
  "decisions": [
    {
      "id": "dec:block-purchase-order-item",
      "at": "act:block-purchase-order-item",
      "branches": [
        {
          "to": "end",
          "cases": 163,
          "share": 0.3417
        },
        {
          "to": "act:delete-purchase-order-item",
          "cases": 131,
          "share": 0.2746
        },
        {
          "to": "act:reactivate-purchase-order-item",
          "cases": 111,
          "share": 0.2327
        },
        {
          "to": "act:change-quantity",
          "cases": 72,
          "share": 0.1509
        }
      ],
      "baseline_share": 0.3417,
      "rules": [
        {
          "id": "rule:block-purchase-order-item-1",
          "when": [
            "Harcamalar Ticari ve Son Ürünler değil",
            "Sipariş değeri (EUR) 502.5 ile 2884.5 arasında"
          ],
          "then": "act:delete-purchase-order-item",
          "cases": 113,
          "holds": 0.708,
          "evidence": {
            "cases": 80,
            "of_cases": 113,
            "share": 0.708,
            "strength": "weak",
            "method": "burada sayılan geçişlere karar ağacı ile uyarlanmış kural; pay sonraki adımın ne sıklıkta eşleştiği"
          }
        }
      ],
      "explained": true,
      "evidence": {
        "cases": 477,
        "of_cases": 499,
        "share": 0.6688,
        "strength": "weak",
        "method": "her vakada ilk kez adım ziyareti; kurallar en yaygın sonraki adım tahminine karşı %67 skor yapar; açıklanan en az %10 daha fazla skor gerekir"
      }
    }
  ],
  "policies": [
    {
      "id": "pol:create-purchase-order-item-record-goods-receipt-within-30-days",
      "kind": "service_level",
      "statement": "Muhtemel hizmet seviyesi, çıkarımla: Satın Alma Kalemi Oluştur -> 30 gün içinde Mal Kabul Kaydı (74,809 vakanın %88’i içinde biter; %8.1 sınırın içine yakın çeyrekte, %4.0 biraz dışarıda biter)",
      "threshold_hours": 720.0,
      "share_met": 0.8839,
      "evidence": {
        "cases": 66126,
        "of_cases": 74809,
        "share": 0.8839,
        "strength": "hypothesis",
        "method": "pozitif beklemelerin sınır altında ya da eşit oranı; bir sınır en az yarısı karşılanırsa ve dışarıdakilerin iki katı iç kısımdaki çeyrekte toplanırsa geçerli sayılır"
      }
    }
  ],
  "...": "ve 14 daha fazla parça"
}

Bölümler

Bölüm İçeriği
source Grafiğin hangi verilerden oluşturulduğu: veri versiyonu, hangi günlük okundu, vaka tanımı, vakalar, olaylar ve dönem, çalışma veya saat zamanlaması
process Bir vakanın neyi temsil ettiği ve sürecin göründüğü amaç
success_criteria Başarılı bir vakanın nasıl tanındığı ve her testten geçen vaka oranı
outcomes Her sonlanma şekli, vaka sayısı ve oranı ile
stages Vakanın geçtiği aşamalar ve her aşamadaki aktiviteler
nodes Her aktivite için bir kayıt, ayrıca başlangıç ve son: vakalar, olaylar, tekrarlar, bir sonraki adıma tipik süre, roller
edges Her geçiş için bir kayıt: vakalar, oran, tipik bekleme ve en yavaş vakaların beklemesi
variants Ana yol, izin verilen varyasyonlar, ve yüzde birden fazla vaka içeren istisna yollar
model Yollardan keşfedilen süreç modeli ve kabul ettiği vaka oranı
decisions Vakaların ayrıldığı her nokta: dallar ve varsa ayrılmayı açıklayan şartlı kurallar
sequence_rules Neredeyse her zaman doğru olan sıralama kuralları ve her kuralın geçerli olduğu vaka oranı
exceptions Tekrarlanan, atlanan ve sıra dışı adımlar, nadir aktiviteler ve başarısız sonlanmalar
escalations Uzun bekleme ya da başarısız denemelerden sonra ortaya çıkan adımlar
policies Çoğu vakanın içinde kaldığı zaman limitleri ve her birini karşılayan oran
roles Kimin hangi aktiviteleri yaptığı, günlükte kim yaptığı kayıtlıysa
object_types, object_relations Nesne merkezli günlük için nesne türleri ve ilişkileri
evidence_levels Beş kanıt gücü etiketi, her biri bir kez tanımlanır
assumptions, open_questions Çalışma başlamadan önce verilen kararlar, ölçülemeyenler ve okuyucunun incelemesi gerekenler

Sayılar tam sayı, oranlar 0 ile 1 arası kesir, zamanlar saat cinsindendir. Her bölüm her grafikte bulunur; söylenecek bir şey yoksa liste boş olur, hiç bir değer null değildir.

Bazı bölümler kodla sayılır - aynı veri üzerinde ikinci çalıştırma aynı sonucu verir. Diğerleri veri okumaya dayalıdır: bir vaka neyi temsil eder, hangi sonlanmalar başarılı sayılır, aşamalar nerede. Rapor hangisi olduğunu belirtir.

Her bölüme ne kadar güvenmeli

İddia içeren her bölümünde bir evidence nesnesi vardır - dayandığı vaka sayısı, geçerli olduğu vaka sayısı, geçerlilik oranı, ölçüm yöntemi - ve bir güç etiketi:

Etiket Anlamı
counted Günlükten doğrudan sayım
strong Uygulandığı vakaların en az %95’inde geçerli ve en az 100 vakaya dayanıyor
moderate En az %80 geçerli ve en az 30 vakaya dayanıyor
weak Bunların dışındakiler
hypothesis Aktivite isimleri veya zamanlamadan çıkarılan, kurallarla test edilmemiş hipotez

Önce gücü okuyun: counted günlük hakkında gerçek, hypothesis kontrol edilmeye değer bir fikirdir.

Tam Tanım

Biçim sabit ve versiyonlanmıştır. Bu 1.0 versiyonudur. Bir kez geçen belge sonsuza dek geçerlidir; alanlarda yapılacak her değişiklik yeni bir versiyon ve kendi şema dosyasını gerektirir.

mindzie.process-context-graph-1.0.schema.json İndir

Şema dosyası tüm biçimi içerir ve herhangi bir doğrulayıcı tarafından okunabilen JSON Schema (draft-07) formatındadır. Her grafik rapor yayınlandığında buna göre kontrol edilir: şekli tutmayan rapor yayınlanmaz ve sebebi ilgili kısmı ve hatayı belirtir.

Kendi grafiğinizi kontrol edin

Şema dosyasını grafik ile aynı klasöre koyup herhangi bir JSON Schema doğrulayıcı ile karşılaştırın. Python’da bunu check_graph.py olarak kaydedin:

import json

import jsonschema

with open("process-context-graph.json", encoding="utf-8") as file:
    graph = json.load(file)
with open("mindzie.process-context-graph-1.0.schema.json", encoding="utf-8") as file:
    schema = json.load(file)

jsonschema.validate(graph, schema)
print("valid")

ve çalıştırın:

pip install jsonschema
python check_graph.py

valid yazdırır ya da biçimi tutmayan kısımda hata verir. Proje her grafik yayınlandığında kontrol ettiğinden, yayınlanan grafik her zaman geçerlidir.

Sonraki Adımlar