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, portkey 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://agents.portkey.ai/v1/agent/test-server.
For self-hosted deployments, replace agents.portkey.ai with your gateway URL.

​
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 portkey.
Last modified on April 20, 2026