Supported Framework & Deployment Types
When registering an agent, you confirm the framework (how it was built) and select the deployment type (where it runs). This page explains each option in detail to help you choose correctly.
Framework
TraptureIQ is purpose-built for Google ADK — the Agent Development Kit. TraptureIQ uses this information to communicate with your agent over the ADK API protocol.
| Framework | What It Is | When to Choose | Availability |
|---|---|---|---|
| Google ADK | Google's Agent Development Kit for building AI agents | Your agent was built using the ADK SDK | ✅ Available |
How to Confirm Your Agent is Built on ADK
If you're unsure:
- Check your agent's codebase — look for imports like
google.adk - Check your agent's API endpoint format — ADK exposes a specific request/response contract
- Ask the developer who built the agent
Deployment Types
The deployment type tells TraptureIQ where your agent is hosted and how to connect to it.
| Type | What It Is | Authentication Required? | Best For |
|---|---|---|---|
| Agent Engine | Vertex AI Agent Engine — a Google-managed hosting service for AI agents | Yes (one of three auth methods) | Agents deployed through Vertex AI's managed infrastructure |
| Cloud Run | Google Cloud Run — containerized services that scale automatically | No | Agents deployed as containers on Google Cloud |
| Custom | Any other server — on-premises, another cloud provider, local development machine | No | Agents hosted anywhere outside of GCP managed services |
How to Know Which Deployment Type to Choose
| Where Your Agent Is Hosted | Choose |
|---|---|
| Vertex AI Reasoning Engine | Agent Engine |
| Google Cloud Run | Cloud Run |
| AWS, Azure, or another cloud | Custom |
| Your own on-premises servers | Custom |
| Your local development machine | Custom |
Authentication Methods (Agent Engine Only)
When deploying on Agent Engine, TraptureIQ needs to authenticate to your GCP project. Three options are available:
| Method | How It Works | Security Level | Setup Time |
|---|---|---|---|
| Authorize with Impersonation | TraptureIQ temporarily impersonates a service account you create. No credentials are exchanged — only short-lived tokens. | Highest | ~5 min |
| Authorize TraptureIQ Principal | You grant TraptureIQ's own service account direct Google Cloud permissions on your project | High | ~2 min |
| Upload SA Key | You upload a service account key JSON file, which TraptureIQ encrypts and stores | Standard | ~5 min |
For detailed setup instructions, see the Authentication Setup guide.
Cloud Run and Custom deployments do not require authentication setup — TraptureIQ connects directly over HTTPS.
Common Deployment Targets for ADK
| Deployment | Notes |
|---|---|
| Agent Engine | The Google-managed option — best for production ADK agents with built-in scaling and IAM-based access |
| Cloud Run | Run your ADK agent as a container with auto-scaling and zero-cost when idle |
| Custom | Self-host your ADK agent on any HTTPS endpoint — useful for on-prem or other clouds |
Tips for Beginners
- If the Test Connection fails with a handshake error — verify the endpoint is reachable, the URL is correct, and (for Agent Engine) that authentication is configured.
- Cloud Run is the easiest deployment type — no authentication setup needed; just provide the HTTPS URL.
- You can edit deployment details later — if you chose wrong, edit the agent and update the configuration.