Yapılandırma - Pactmark

Uyumluluk: Pactmark 0.2.x. Yapılandırma kurucu girdisidir, ortam sihri değil. Global bir yapılandırma nesnesi, ortam değişkeni geleneği veya gizli bir varsayılan istemci yoktur.

İlke

const runtime = createRuntime({
  clock,
  idGenerator,
  eventStore,
  acceptedWorkOrderStore,
  commandRecordStore,
  contextStore,
  inputSubmissionStore,
  artifactStore,
  evidenceRecordStore,
  transactionRunner,
  authorityIssuer,
  admissionController,
  policy,
  grantIssuer,
  decisionChallengeIssuer,
  decisionStore,
  modelCredentialIssuer,
  toolCredentialIssuer,
  toolExecutor,
  egressBroker,
  verifierRegistry,
  evidenceBuilder,
  telemetry,
  wakeupDriver,
  requiredRuntimeCapabilities,
});

Uzun ve bilinçli olarak öyle. Her satır, bir incelemede işaret edebileceğiniz bir karardır.

Geliştirme ve üretim

import { createLocalRuntime, createLocalAuthorityIssuer } from "@pactmark/agent";

const local = createLocalAuthorityIssuer();
const runtime = createLocalRuntime({
  agents: [myAgent],
  authorityIssuer: local.issuer,
});
// Deterministik bellek destekli varsayılanlar. Kendi sınırlarını bildirir.

import { createRuntime } from "@pactmark/agent";
import { createPostgresStores } from "@pactmark/store-postgres";
import {
  createDeclaredToolExecutor,
  createDenyAllEgressBroker,
} from "@pactmark/executor-in-process";

const stores = createPostgresStores({ pool, securityProfile });

const runtime = createRuntime({
  ...stores,
  authorityIssuer: hostAuthorityIssuer,   // kimliği doğrulanmış host'unuzdan
  admissionController,
  policy,
  toolExecutor: createDeclaredToolExecutor(tools),
  egressBroker: createAllowlistEgressBroker(allowlist),
  // …kalan her port açıkça verilir
});

Deny-all varsayılanlar bir nedenle vardır

core, açık deny-all uygulamalarını dışa aktarır:

import {
  DenyAllModelCredentialIssuer,
  DenyAllModelCredentialResolver,
  DenyAllSecretRefStore,
  DenyAllSecretResolver,
  DenyAllToolCredentialIssuer,
} from "@pactmark/core";

Bir yeteneğe gerçekten ihtiyacınız yoksa bunları kullanın. “Burada bunu yapmıyoruz” ifadesini bir yokluk değil, açık ve aranabilir bir ifade hâline getirirler. Benzer şekilde createDenyAllEgressBroker(), araçları egress: { mode: "none" } beyan eden bir çalışma zamanı için doğru egress aracısıdır.

Çalışma-zamanı yetenekleri

const capabilities: RuntimeCapabilities = {
  schemaVersion: "1",
  executionProfile: "durable",
  durableStorage: true,
  protectedContext: true,
  protectedWorkOrders: true,
  protectedInputSubmissions: true,
  streaming: true,
  cancellation: true,
  sandbox: "unsafe_local",
  networkPolicy: "declared",
  backgroundWakeup: true,
  atomicCommandAndWakeup: true,
  humanDecisions: true,
  typedInput: true,
  effectReconciliation: true,
  compensation: true,
  modelCredentials: true,
  toolCredentials: true,
  telemetry: "metadata",
  transactionDomains: ["postgres.primary"],
};

Dürüstçe beyan edin. Çalışma zamanının sağlamadığı bir yeteneği gerektiren bir ajan, koşu başlamadan önce KAF_RUNTIME_CAPABILITY_MISSING ile başarısız olur — ki bu yalnızca beyanınız doğruysa işe yarar.

Hazırlık profilleri

Profil	Amacı	Tipik sonuç
`local`	Geliştirme ve testler	Bellek depolarıyla geçer
`preview`	Üretim dışı gösterimler	Açıkça işaretlenmiş anonim bir yetkiyle geçer
`production`	Gerçek iş	Eksik dayanıklılığı, atomikliği, kayıtlı etki stratejilerini, sınırlı model kaynaklarını, kimlik bilgisi zorlamasını veya host yeteneğini reddeder

const report = runtime.evaluateReadiness({ profile: "production" });
if (!report.ready) {
  logger.error({ gaps: report.gaps }, "çalışma zamanı üretime hazır değil");
}

Ortam değişkenleri

Pactmark’ın kendisi hiçbirini okumaz. Host’unuz okuyabilir:

readEnvironment: () => ({
  PACTMARK_PROFILE: process.env.PACTMARK_PROFILE,
  DATABASE_URL: process.env.DATABASE_URL,
});

Ortam değişkenlerini modül kapsamında değil, adaptörün içinde istek zamanında okuyun. Modül kapsamı okumaları bir derleme artefaktına yakalanabilir ve istek başına bir karar olması gereken bir değeri dağıtım başına bir karara dönüştürür.

Bir yapılandırma inceleme listesi

Her yetenek beyanı doğru mu?

Yanlış bir durableStorage: true, sorunu yakalayacak korumayı devre dışı bırakır.

Yetki verici host'a mı ait?

Üretim yolunda createLocalAuthorityIssuer kritik bir bulgudur.

Egress aracısı kısıtlayıcı mı?

Bir araç izin listesi beyan etmedikçe deny-all.

Kullanılmayan kimlik bilgisi portları açıkça deny-all mı?

Yok ya da izin verici değil.

Hazırlık hedef ortamda geçiyor mu?

Bir dizüstünde değil, orada doctor --profile production çalıştırın.

Agent API

CreateRuntimeInput ve döndürdüğü cephe.

Hazırlık listesi

Bu sayfanın işletimsel biçimi.

​İlke

​Geliştirme ve üretim

​Deny-all varsayılanlar bir nedenle vardır

​Çalışma-zamanı yetenekleri

​Hazırlık profilleri

​Ortam değişkenleri

​Bir yapılandırma inceleme listesi

Agent API

Hazırlık listesi

İlke

Geliştirme ve üretim

Deny-all varsayılanlar bir nedenle vardır

Çalışma-zamanı yetenekleri

Hazırlık profilleri

Ortam değişkenleri

Bir yapılandırma inceleme listesi