Skip to content

AI Gateway CLI 1.0.0b30 (Public Preview)

Choose a tag to compare

@paulyuk paulyuk released this 13 Nov 16:59
· 141 commits to main since this release
30719d6

Quickstart | CLI Reference | Documentation

Highlights

  • Explicit Foundry provider vs. bulk model import split:
    • az aigateway model-provider create -g <rg> --gateway-name <gw> [-n <provider-name>] --foundry-resource-id <foundry-arm-id> registers the Foundry model provider resource and configures RBAC without importing model deployments (pass --import-models to import deployments during create).
    • az aigateway model-provider import -g <rg> --gateway-name <gw> [-n <provider-name>] --foundry-resource-id <foundry-arm-id> runs the full one-step Foundry onboarding workflow (RBAC role assignment, provider creation/update, and bulk import of all deployed models).
    • Both model-provider create and model-provider import accept piped JSON from az cognitiveservices account show or az cognitiveservices account list.
  • First-class MCP --url, --transport, and --namespace flags + GA bug-bash fixes:
    • az aigateway mcp create and az aigateway mcp update now accept --url, --transport (streamableHttp default or sse), and --namespace directly without requiring raw --endpoints JSON.
    • Added pre-flight MCP reachability probing (including HTTP 200, 401, 403, 405, and 421 Misdirected Request), --yes confirmation prompts on destructive commands, and validation improvements.
  • Subscription precedence layering (--subscription):
    • All az aigateway commands now consistently honor --subscription and Azure CLI subscription resolution precedence.
  • MCP OAuth getLoginLinks contract update:
    • Updated MCP OAuth login-link requests to the new scopes + providers contract with automatic fallback for regions still rolling out.

Canonical DX

# Register only the Foundry model-provider resource (no model import)
az aigateway model-provider create \
  -g my-rg \
  --gateway-name my-gw \
  -n foundry-eastus \
  --foundry-resource-id "$FOUNDRY_RESOURCE_ID"

# Full Foundry onboarding: RBAC + provider + bulk model import
az aigateway model-provider import \
  -g my-rg \
  --gateway-name my-gw \
  -n foundry-eastus \
  --foundry-resource-id "$FOUNDRY_RESOURCE_ID"

# Register a streamable HTTP MCP server with first-class flags
az aigateway mcp create \
  -g my-rg \
  --gateway-name my-gw \
  -n learn \
  --url https://learn.microsoft.com/api/mcp

Install or Upgrade

macOS / Linux / WSL / Cloud Shell (Bash)

curl -fsSL https://raw.githubusercontent.com/Azure/aigateway/main/cli/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/Azure/aigateway/main/cli/install.ps1 | iex

Direct Wheel Install

az extension remove --name aigateway 2>/dev/null || true
az extension add --upgrade --source https://github.com/Azure/aigateway/releases/download/cli-v1.0.0b30/aigateway-1.0.0b30-py3-none-any.whl --yes

Documentation URLs

Release Asset & Checksum