arize-annotation

1# Arize Annotation Skill
2 
3> **`SPACE`** — All `--space` flags and the `ARIZE_SPACE` env var accept a space **name** (e.g., `my-workspace`) or a base64 space **ID** (e.g., `U3BhY2U6...`). Find yours with `ax spaces list`.
4 
5This skill covers **annotation configs** (the label schema) and **annotation queues** (human review workflows), as well as programmatically annotating project spans via the Python SDK.
6 
7**Direction:** Human labeling in Arize attaches values defined by configs to **spans**, **dataset examples**, **experiment-related records**, and **queue items** in the product UI. This skill covers: `ax annotation-configs`, `ax annotation-queues`, and bulk span updates with `ArizeClient.spans.update_annotations`.
8 
9---
10 
11## Prerequisites
12 
13Proceed directly with the task — run the `ax` command you need. Do NOT check versions, env vars, or profiles upfront.
14 
15If an `ax` command fails, troubleshoot based on the error:
16- `command not found` or version error → see references/ax-setup.md
17- `401 Unauthorized` / missing API key → run `ax profiles show` to inspect the current profile. If the profile is missing or the API key is wrong, follow references/ax-profiles.md to create/update it. If the user doesn't have their key, direct them to https://app.arize.com/admin > API Keys
18- Space unknown → run `ax spaces list` to pick by name, or ask the user
19…