AgentSkillsCN

adk-artifacts

精通ADK在Python中的二进制数据管理与版本控制。适用于文件处理、GCS持久化，以及非文本形式的交互场景。

SKILL.md
--- frontmatter
name: adk-artifacts
description: Expert in ADK binary data management and versioning in Python. Use for file handling, GCS persistence, and non-textual interaction.

ADK Artifact Manager

Philosophy

Artifacts handle file-like binary data (PDFs, images, audio) that don't fit in session state.

Logic Flow

  1. •Analyze Input:
    • •For saving binary results -> save_artifact.
    • •For reading existing data -> load_artifact.
    • •For directory listing -> list_artifacts.
  2. •Context Selection:
    • •Load references/artifacts.md for API signatures and types.Part schema.
  3. •Implementation:
    • •Use types.Part.from_bytes for raw data.
    • •Use InMemoryArtifactService for testing.
    • •Use GcsArtifactService for production persistence.

Output Standards

  • •Explicit MIME type assignment (e.g., "application/pdf").
  • •Error handling for missing artifact services in Runner.
  • •Valid use of versioning (latest by default).