Asta Artifacts

分类: 工具与效率 | 上传者: allenai | 下载: 0 | 版本: v1.0（最新）

当用户要求查看、导出或打开代理输出工件时使用此技能 - “显示工件”、“导出结果”、“打开报告”、“将任务输出转换为 HTML”、“代理生成了什么”，或者想要使用 A2A 代理任务的结构化输出。

更新日志: Source: GitHub https://github.com/allenai/asta-plugins

目录结构

当前层级: tree/main/plugins/asta-preview/skills/artifacts/

📄 SKILL.md 2.6 KB

SKILL.md

---
name: Asta Artifacts
description: Use this skill when the user asks to view, export, or open agent output artifacts — "show me the artifacts", "export the results", "open the report", "convert the task output to HTML", "what did the agent produce", or wants to work with structured outputs from an A2A agent task.
metadata:
  internal: true
allowed-tools:
  - Bash(asta * task *)
  - Bash(asta artifacts *)
  - Bash(asta documents *)
  - Bash(open *)
---

# Asta Artifacts

[Artifacts](https://a2a-protocol.org/latest/specification/#artifacts) are the structured outputs produced by A2A agents. They accumulate in the `artifacts[]` field of the task response.

## Export

```bash
# 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
```

Produces per-artifact files organized by subtype, plus `index.md`, `references.bib`, and `manifest.json`.

Works on partial task data too — useful for previewing mid-run.

## Formats

- `--format md` — markdown, one `.md` per artifact. Cross-artifact links use relative `.md` paths. Best for LLM consumption, version control, and indexing into asta-documents.
- `--format html` — self-contained HTML with `index.html`. Open with `open "$OUT_DIR/index.html"`. Best for reading or sharing.

## Path convention (when invoked by another skill)

When another skill hands off to this one to export a run, default to writing
under:

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

Where `<slug>` is `YYYY-MM-DD-<short-query-slug>` — date-first for
chronological ordering, short-slug derived from the primary input (query,
topic, etc.). Register the exported artifacts with asta-documents into a
single per-skill aggregate index at `.asta/<invoking-skill>/index.yaml` so
consumers can search across all runs.

Example (theorizer run):

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

## Indexing with asta-documents

After export, read `manifest.json` and register each entry with `asta documents add`. Each manifest entry has: `name`, `description`, `filename`, `mime_type`, and optionally `subtype` and `metadata`. Map these directly to:

- `file://<absolute-path-to-OUT_DIR>/<filename>` as the URL
- `--name` from `name`
- `--summary` from `description` (fall back to `name`)
- `--mime-type` from `mime_type`
- `--tags` from `subtype` if present
- `--extra` from `metadata` as JSON if present

Use `--root <dir>` to target a scoped index (e.g. per-agent) instead of the default `.asta/documents/`.

登录后下载/点赞/收藏 ❤ 11 | ★ 0

Asta Artifacts

目录结构

SKILL.md

举报内容

提示