Habilidade de Dataset Arize

SPACE — Todas as flags --space e a variável de ambiente ARIZE_SPACE aceitam um nome de espaço (ex: my-workspace) ou um ID de espaço em base64 (ex: U3BhY2U6...). Encontre o seu com ax spaces list.

Conceitos

• Dataset = uma coleção versionada de exemplos usada para avaliação e experimentação
• Versão de Dataset = um snapshot de um dataset em um determinado momento; atualizações podem ser in-place ou criar uma nova versão
• Exemplo = um único registro em um dataset com campos arbitrários definidos pelo usuário (ex: question, answer, context)
• Espaço = um contêiner organizacional; datasets pertencem a um espaço

Campos gerenciados pelo sistema em exemplos (id, created_at, updated_at) são gerados automaticamente pelo servidor -- nunca os inclua em payloads de criação ou adição.

Pré-requisitos

Prossiga diretamente com a tarefa — execute o comando ax que você precisa. NÃO verifique versões, variáveis de ambiente ou perfis antecipadamente.

Se um comando ax falhar, solucione o problema com base no erro:

• Erro de command not found ou versão → veja references/ax-setup.md
• 401 Unauthorized / chave de API ausente → execute ax profiles show para inspecionar o perfil atual. Se o perfil estiver ausente ou a chave de API estiver incorreta, siga references/ax-profiles.md para criá-lo/atualizá-lo. Se o usuário não tiver a chave dele, direcione-o para https://app.arize.com/admin > API Keys
• Espaço desconhecido → execute ax spaces list para escolher por nome, ou pergunte ao usuário
• Projeto incerto → pergunte ao usuário, ou execute ax projects list -o json --limit 100 e apresente como opções selecionáveis
• Segurança: Nunca leia arquivos .env ou pesquise no sistema de arquivos por credenciais. Use ax profiles para credenciais Arize e ax ai-integrations para chaves de provedor LLM. Se as credenciais não estiverem disponíveis através desses canais, pergunte ao usuário.

Listar Datasets: ax datasets list

Navegue pelos datasets em um espaço. A saída vai para stdout.

ax datasets list
ax datasets list --space SPACE --limit 20
ax datasets list --cursor CURSOR_TOKEN
ax datasets list -o json

Flags

Obter Dataset: ax datasets get

Consulta rápida de metadados -- retorna nome do dataset, espaço, timestamps e lista de versões.

ax datasets get NAME_OR_ID
ax datasets get NAME_OR_ID -o json
ax datasets get NAME_OR_ID --space SPACE   # required when using dataset name instead of ID

Flags

Campos de resposta

Exportar Dataset: ax datasets export

Baixe todos os exemplos para um arquivo. Use --all para datasets maiores que 500 exemplos (exportação em massa ilimitada).

ax datasets export NAME_OR_ID
# -> dataset_abc123_20260305_141500/examples.json

ax datasets export NAME_OR_ID --all
ax datasets export NAME_OR_ID --version-id VERSION_ID
ax datasets export NAME_OR_ID --output-dir ./data
ax datasets export NAME_OR_ID --stdout
ax datasets export NAME_OR_ID --stdout | jq '.[0]'
ax datasets export NAME_OR_ID --space SPACE   # required when using dataset name instead of ID

Flags

…