# Higress Gateway Management

Manage the Higress AI Gateway via its Console API (consumers, routes, AI providers, MCP...

- Repository: https://github.com/agentscope-ai/AgentTeams (5913 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agentscope-ai/AgentTeams --skill higress-gateway-management -g -a claude-code -y`
Codex: `npx skills add agentscope-ai/AgentTeams --skill higress-gateway-management -g -a codex -y`
Cursor: `npx skills add agentscope-ai/AgentTeams --skill higress-gateway-management -g -a cursor -y`
Gemini CLI: `npx skills add agentscope-ai/AgentTeams --skill higress-gateway-management -g -a gemini-cli -y`

## Description

Manage the Higress AI Gateway via its Console API (consumers, routes, AI providers, MCP servers). Use when creating consumers, configuring routes, or managing AI gateway settings.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Higress AI Gateway Management

## Overview

This skill allows you to manage the Higress AI Gateway via its Console API. The Console API runs at `http://127.0.0.1:8001` and uses **Session Cookie** authentication (NOT Basic Auth).

## Environment Variables

These environment variables are pre-configured in the Manager container. Access them directly in bash:

```bash
# Core configuration (set by agentteams-install.sh)
AGENTTEAMS_ADMIN_USER      # Admin username for Higress Console
AGENTTEAMS_ADMIN_PASSWORD  # Admin password for Higress Console
AGENTTEAMS_AI_GATEWAY_DOMAIN  # AI Gateway domain (e.g., aigw-local.agentteams.io)
HIGRESS_COOKIE_FILE    # Path to session cookie file
```

No need to set defaults - these are always available in the container environment.

## Authentication

A session cookie file is stored at the path in `${HIGRESS_COOKIE_FILE}` environment variable. Use it with `curl -b "${HIGRESS_COOKIE_FILE}"`.

If the cookie expires, re-login:

```bash
curl -X POST http://127.0.0.1:8001/session/login \
  -H 'Content-Type: application/json' \
  -c "${HIGRESS_COOKIE_FILE}" \
  -d '{"name": "'"${AGENTTEAMS_ADMIN_USER}"'", "password": "'"${AGENTTEAMS_ADMIN_PASSWORD}"'"}'
```

## Consumer Management

### List Consumers

```bash
curl -s http://127.0.0.1:8001/v1/consumers -b "${HIGRESS_COOKIE_FILE}" | jq
```

### Create Consumer

```bash
curl -X POST http://127.0.0.1:8001/v1/consumers \
  -b "${HIGRESS_COOKIE_FILE}" \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "worker-alice",
    "credentials": [{
      "type": "key-auth",
      "source": "BEARER",
      "values": ["<GENERATED_KEY>"]
    }]
  }'
```

### Update Consumer (e.g., replace credential key)

The rest: https://github.com/agentscope-ai/AgentTeams/blob/HEAD/manager/agent/skills-alpha/higress-gateway-management/SKILL.md