ファクトリー
公開済みのファクトリーページでは、パッケージ化されたファクトリー面と、その設定・実行のしかたを説明します。
ファクトリーとは
ファクトリーは you-agent-factory が実行するワークフロー位相です。作業種別、ワーカー、ワークステーション、任意のリソースを宣言し、長時間のエージェント作業をチャットごとにリセットせず持続させます。この系列では factory.json の位相、名前付き・グローバルなオペレーター既定値の関係、パッケージ化ファクトリーの発見と更新、動的ワークフロー API とファクトリー設定の関係、Factory Session が実行中ファクトリーをどう識別するかを学べます。
ファクトリールート定義
ライブの Factory スキーマルートは、factory.json が宣言できる位相フィールドを一覧します。このインデックスはそのルート要約のみを示します。網羅的なフィールドや操作の参照が必要なときは、完全な Factory スキーマと API リファレンスを開いてください。
You Factory configuration
objectTop-level factory.json contract. Declare the work types, resources, portability resources, workers, and workstations that make up one authored factory here. Guarded loop breakers should be authored as guarded LOGICAL_MOVE workstations using VISIT_COUNT guards instead of a top-level exhaustion-rules field.
- additionalProperties
false (closed)
Fields
Optional localized customer-facing explanation of this Factory.
Ordered runnable invocation examples. Canonical Factory documents write examples here; legacy invocationSignature.examples are accepted only by the Factory input compatibility mapper.
- factoryDirectory
factoryDirectoryOptionalstringDirectory that contained the factory.json used for this serialized runtime config.
Root-level guards that apply across the factory instead of one specific workstation or input.
- id
idOptionalstringFactory identifier used as the factory-level template context fallback.
Named input kinds accepted by the factory. The default input type is implicit and must not be declared.
Optional factory-authored invocation primary-result policy shared by CLI and API entrypoints. When omitted, runtimes use the SUBMITTED_WORK_TERMINAL fallback and return the first terminal content for the work item originally submitted by the invocation.
Optional canonical callable argument contract shared by CLI, API, dashboard, docs, and packaged factories. When omitted, callers use the factory's compatibility invocation behavior.
Optional non-executable graph editor layout metadata keyed by canonical graph node and edge ids.
Free-form factory-level metadata carried through runtime serialization and replay diagnostics.
Authored orchestrator identity for this factory. When omitted, existing Petri factories load through compatibility defaulting to orchestrator.kind = PETRI.
Shared capacity pools that workers or workstations can consume while work is executing.
Default runner selection for the factory when a workstation does not declare its own runner override.
- sourceDirectory
sourceDirectoryOptionalstringOriginal source directory for record/replay and drift diagnostics.
Optional portability manifest for validation-only external tools and portable bundled files. During v1 factory sharing, bundled INPUT files represent a share-time snapshot of the source factory's current inputs work so recipients restore detached starter-work copies that no longer sync back to the original factory. This contract is distinct from runtime-capacity resources.
Server-managed current-factory version metadata. Clients should echo this value on complete replacement saves when they want stale-write detection, but durable factory configuration does not treat it as customer-authored topology.
Customer-authored work item categories and the lifecycle states each one can occupy.
Reusable worker definitions that workstations reference by name when dispatching work.
Processing steps that consume work, invoke workers, and emit the next work states.