Habilidade de Integração Arize AI

SPACE — A maioria das 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. Observação: ai-integrations create não aceita --space — integrações de IA são definidas no escopo da conta. Use --space apenas com list, get, update e delete.

Conceitos

• Integração de IA = credenciais de provedor de LLM armazenadas e registradas na Arize; usadas por avaliadores para chamar um modelo juiz e por outros recursos da Arize que precisam invocar um LLM em seu nome.
• Provedor = o serviço de LLM que suporta a integração (ex: openAI, anthropic, awsBedrock).
• ID da Integração = um identificador global codificado em base64 para uma integração (ex: TGxtSW50ZWdyYXRpb246MTI6YUJjRA==); necessário para criação de avaliadores e outras operações subsequentes.
• Escopo = regras de visibilidade que controlam quais espaços ou usuários podem usar uma integração.
• Tipo de Autenticação = como a Arize se autentica com o provedor: default (chave de API do provedor), proxy_with_headers (proxy via cabeçalhos personalizados) ou bearer_token (autenticação por token Bearer).

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 de versão → consulte 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, 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.
• Falha na chamada do provedor de LLM (OPENAI_API_KEY / ANTHROPIC_API_KEY ausente) → execute ax ai-integrations list --space SPACE para verificar credenciais gerenciadas pela plataforma. Se não houver nenhuma, peça ao usuário para fornecer a chave ou criar uma integração através da habilidade arize-ai-provider-integration.
• Segurança: Nunca leia arquivos .env ou procure no sistema de arquivos por credenciais. Use ax profiles para credenciais da Arize e ax ai-integrations para chaves de provedor de LLM. Se as credenciais não estiverem disponíveis através desses canais, pergunte ao usuário.

Listar Integrações de IA

Liste todas as integrações acessíveis em um espaço:

ax ai-integrations list --space SPACE

Filtrar por nome (correspondência de subcadeia sem distinção entre maiúsculas e minúsculas):

ax ai-integrations list --space SPACE --name "openai"

Paginar grandes conjuntos de resultados:

# Get first page
ax ai-integrations list --space SPACE --limit 20 -o json

# Get next page using cursor from previous response
ax ai-integrations list --space SPACE --limit 20 --cursor CURSOR_TOKEN -o json

Flags principais:

Campos de resposta:

Obter uma Integração Específica

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

Use isso para inspecionar a configuração completa de uma integração ou para confirmar seu ID após a criação.

Criar uma Integração de IA

Antes de criar, sempre liste as integrações primeiro — o usuário pode já ter uma adequada:

ax ai-integrations list --space SPACE

Se nenhuma integração adequada existir, crie uma. As flags necessárias dependem do provedor.

OpenAI

ax ai-integrations create \
  --name "My OpenAI Integration" \
  --provider openAI \
  --api-key $OPENAI_API_KEY

…