Introduction
Agno is a powerful framework for building autonomous AI agents that can reason, use tools, maintain memory, and access knowledge bases. Portkey enhances Agno agents with enterprise-grade capabilities for production deployments. Portkey transforms your Agno agents into production-ready systems by providing:- Complete observability of agent reasoning, tool usage, and knowledge retrieval
- Access to 1600+ LLMs through a unified interface
- Built-in reliability with fallbacks, retries, and load balancing
- Cost tracking and optimization across all agent operations
- Advanced guardrails for safe and compliant agent behavior
- Enterprise governance with budget controls and access management
Agno AI Official Documentation
Setting Up Portkey
If this is your first time using Portkey, you will need to connect your LLM Provider in the app to use them in your Agno AI agents.Create an Integration
- Find your preferred provider (e.g., OpenAI, Anthropic, etc.)
- Click Connect on the provider card
- In the “Create New Integration” window:
- Enter a Name for reference
- Enter a Slug for the integration
- Enter your API Key and other provider specific details for the provider
- Click Next Step

Configure Models
- Leave all models selected (or customize)
- Toggle Automatically enable new models if desired

Copy the Provider Slug
- Go to Model Catalog → AI Providers tab
- Find your integration
- Copy the slug (e.g.,
openai-dev)

Quickstart
You will need- Portkey API Key & Portkey AI Provider slug from Step 1
Get your Portkey API Key
Simple E2E example agent
Let’s create a simple Agno agent that uses Portkey for LLM calls:Production Features
1. Enhanced Observability
Portkey provides comprehensive observability for your Agno agents, helping you understand exactly what’s happening during each execution.- Traces
- Logs
- Metrics & Dashboards
- Metadata Filtering

2. Reliability - Keep Your Agents Running Smoothly
When running agents in production, things can go wrong - API rate limits, network issues, or provider outages. Portkey’s reliability features ensure your agents keep running smoothly even when problems occur. It’s this simple to enable fallback in your Agno agents:Automatic Retries
Request Timeouts
Conditional Routing
Fallbacks
Load Balancing
3. Prompting in Agno Agents
Portkey’s Prompt Engineering Studio helps you create, manage, and optimize the prompts used in your Agno agents. Instead of hardcoding prompts or instructions, use Portkey’s prompt rendering API to dynamically fetch and apply your versioned prompts.
- Prompt Playground
- Using Prompt Templates
- Prompt Versioning
- Mustache Templating for variables
- Iteratively develop prompts before using them in your agents
- Test prompts with different variables and models
- Compare outputs between different prompt versions
- Collaborate with team members on prompt development
Prompt Engineering Studio
4. Guardrails for Safe Agents
Guardrails ensure your Agno agents operate safely and respond appropriately in all situations. Why Use Guardrails? Agno agents can experience various failure modes:- Generating harmful or inappropriate content
- Leaking sensitive information like PII
- Hallucinating incorrect information
- Generating outputs in incorrect formats
- Detect and redact PII in both inputs and outputs
- Filter harmful or inappropriate content
- Validate response formats against schemas
- Check for hallucinations against ground truth
- Apply custom business logic and rules
Learn More About Guardrails
5. User Tracking with Metadata
Track individual users through your Agno agents using Portkey’s metadata system. What is Metadata in Portkey? Metadata allows you to associate custom data with each request, enabling filtering, segmentation, and analytics. The special_user field is specifically designed for user tracking.

- Per-user cost tracking and budgeting
- Personalized user analytics
- Team or organization-level metrics
- Environment-specific monitoring (staging vs. production)
Learn More About Metadata
6. Caching for Efficient Agents
Implement caching to make your Agno agents more efficient and cost-effective:- Simple Caching
- Semantic Caching
7. Model Interoperability: using different LLMs
One of Portkey’s key strengths is providing access to 1600+ LLMs through a unified interface. Here’s how to use different providers with Agno:Supported Providers
- OpenAI
- Anthropic
- Google
End-to-End Examples
Level 1: Agent with Tools and Observability
Let’s build an agent that uses tools while leveraging Portkey’s observability features:Level 2: Agent with Knowledge Base and Caching
Enhance your Agno agent with knowledge retrieval while using Portkey’s caching to optimize costs:Level 3: Agent with Memory, Reasoning, and Reliability
Build a sophisticated agent that leverages Agno’s advanced features with Portkey’s reliability configurations:Set Up Enterprise Governance for Agno AI agents
Why Enterprise Governance? If you are using Agno AI agents inside your orgnaization, you need to consider several governance aspects:- Cost Management: Controlling and tracking AI spending across teams
- Access Control: Managing which teams can use specific models
- Usage Analytics: Understanding how AI is being used across the organization
- Security & Compliance: Maintaining enterprise security standards
- Reliability: Ensuring consistent service across all users
Step 1: Implement Budget Controls & Rate Limits
Step 1: Implement Budget Controls & Rate Limits
Step 1: Implement Budget Controls & Rate Limits
Model Catalog enables you to have granular control over LLM access at the team/department level. This helps you:- Set up budget limits
- Prevent unexpected usage spikes using Rate limits
- Track departmental spending
Setting Up Department-Specific Controls:
- Navigate to Model Catalog in Portkey dashboard
- Create new Provider for each engineering team with budget limits and rate limits
- Configure department-specific limits

Step 2: Define Model Access Rules
Step 2: Define Model Access Rules
Step 2: Define Model Access Rules
As your AI usage scales, controlling which teams can access specific models becomes crucial. You can simply manage AI models in your org by provisioning model at the top integration level.
Step 4: Set Routing Configuration
Step 4: Set Routing Configuration
- Data Protection: Implement guardrails for sensitive code and data
- Reliability Controls: Add fallbacks, load-balance, retry and smart conditional routing logic
- Caching: Implement Simple and Semantic Caching. and more…
Example Configuration:
Here’s a basic configuration to load-balance requests to OpenAI and Anthropic:Step 4: Implement Access Controls
Step 4: Implement Access Controls
Step 3: Implement Access Controls
Create User-specific API keys that automatically:- Track usage per developer/team with the help of metadata
- Apply appropriate configs to route requests
- Collect relevant metadata to filter logs
- Enforce access permissions
Step 5: Deploy & Monitor
Step 5: Deploy & Monitor
Step 4: Deploy & Monitor
After distributing API keys to your engineering teams, your enterprise-ready Cline setup is ready to go. Each developer can now use their designated API keys with appropriate access levels and budget controls. Apply your governance setup using the integration steps from earlier sections Monitor usage in Portkey dashboard:- Cost tracking by engineering team
- Model usage patterns for AI agent tasks
- Request volumes
- Error rates and debugging logs
Enterprise Features Now Available
Agno AI agents now has:- Departmental budget controls
- Model access governance
- Usage tracking & attribution
- Security guardrails
- Reliability features
Frequently Asked Questions
How does Portkey enhance my Agno agents?
How does Portkey enhance my Agno agents?
Can I use any LLM with Agno through Portkey?
Can I use any LLM with Agno through Portkey?
How do I track costs for different agents?
How do I track costs for different agents?
Does Portkey support all Agno features?
Does Portkey support all Agno features?
How do I debug agent failures?
How do I debug agent failures?




