artifacts

Asta Artifacts

Artifacts は、A2A エージェントが生成する構造化された出力です。タスクの応答にある artifacts[] フィールドに蓄積されます。

エクスポート

# 1. Dump task result
TASK_DIR=$(mktemp -d)
asta <agent> task "<TASK_ID>" > "$TASK_DIR/task.json"

# 2. Export (caller decides output dir and format)
asta artifacts --input "$TASK_DIR" --output "$OUT_DIR" --format md

サブタイプごとに整理されたファイルに加えて、index.md、references.bib、manifest.json を生成します。

部分的なタスクデータにも対応しているため、実行中のプレビューにも便利です。

フォーマット

• --format md — アーティファクトごとに .md ファイルを1つ作成するMarkdown形式です。アーティファクト間のリンクには相対 .md パスを使用します。LLM での利用、バージョン管理、asta-documents へのインデックス登録に最適です。
• --format html — index.html を含む、自己完結型のHTML形式です。open "$OUT_DIR/index.html" で開きます。閲覧や共有に最適です。

パスの規約（別のスキルから呼び出される場合）

別のスキルから実行結果のエクスポートを引き継いだ場合は、デフォルトで次の場所に書き込みます。

.asta/<invoking-skill>/<slug>/

<slug> は YYYY-MM-DD-<short-query-slug> です。時系列順に並べられるよう日付を先頭にし、主な入力（クエリ、トピックなど）から短いスラッグを作成します。エクスポートしたアーティファクトは、asta-documents に登録し、すべての実行結果を検索できるよう、.asta/<invoking-skill>/index.yaml にスキルごとの集約インデックスを1つ作成します。

例（theorizer の実行）：

.asta/generate-theories/2026-04-17-media-polarization/   # per-run outputs
.asta/generate-theories/index.yaml                        # aggregate index

asta-documents でのインデックス登録

エクスポート後、manifest.json を読み込み、各エントリーを asta documents add で登録します。各マニフェストエントリーには、name、description、filename、mime_type と、任意の subtype および metadata が含まれます。これらを次のように直接対応付けます。

• URL として file://<absolute-path-to-OUT_DIR>/<filename>
• name を --name に指定
• description を --summary に指定（指定がない場合は name を使用）
• mime_type を --mime-type に指定
• subtype がある場合は --tags に指定
• metadata がある場合は、JSON として --extra に指定

--root <dir> を使用すると、デフォルトの .asta/documents/ ではなく、スコープを限定したインデックス（エージェントごとなど）を指定できます。