Skip to main content
The Agent Servers are the virtual servers that act as a client to the upstream agent server and as a server to the downstream agent clients.

​
Introduction

Instead of your clients (your users/your services) directly interacting with the upstream agent server, The Prisma AIRS AI Gateway allows you to:
  • create virtual servers and provision access with virtual keys,
  • control access to the agent itself and the specific skills and capabilities that the agent provides.
This way, your clients can be restricted to the necessary scopes and capabilities with full observability and logging.

​
Usage

Simply replace your agent server URL wherever you are invoking it with the virtual server URL. For example, if your slug is test-server your URL becomes https://aigw.portkey.ai/agent/test-server.
For self-hosted deployments, replace aigw.portkey.ai/agent with your gateway URL.

​
Forwarding Caller Headers

By default, only the static headers configured on the agent are sent to the upstream agent. To also pass headers from the caller’s request through to the agent, set forward_headers in the agent’s configuration. It accepts the same shorthand, allowlist, and all-except forms as MCP servers, including header renaming and the same list of protected headers. See Forwarding Headers for the full format.
Static headers configured on the agent always replace a forwarded header of the same name. Connection-level headers (such as host, connection, content-length, and accept-encoding) are never forwarded.

​
Logging

Every request to the virtual server will be logged and can be viewed in the logs section. This forms the basis of the observability and governance features at the AI Gateway.

​
Further reading

Quickstart

Get started with the Agent Gateway by registering your first agent.

Agent Registry

Manage your agent integrations and control access to agents and their skills.

Advanced code snippets and examples

Explore additional examples for fetching agent cards and invoking agents.

Logs

View and analyze logs for every request made through your agent servers.
Last modified on November 2, 2026