Integration Methods

Integration Methods

The SaaS Research Agent supports multiple integration methods to accommodate different use cases:

1. REST API (Recommended for Production)

Use Case: Web applications, mobile apps, server-to-server integrations

Endpoint: https://agent.stactize.com/

Protocol: JSON-RPC 2.0 over HTTPS

Authentication: API Key via x-api-key header

Benefits:
– API key management and rotation
– Built-in rate limiting
– Request tracking and analytics
– Custom domain support
– Production-grade security

2. A2A Protocol (Agent-to-Agent)

Use Case: AI agent ecosystems, multi-agent workflows, Google AI Agent Marketplace

Endpoint: https://saas-research-a2a-[PROJECT_ID].europe-west4.run.app

Protocol: A2A (Agent-to-Agent) Protocol

Authentication: API Key via API Gateway (when deployed with gateway)

Benefits:
– Standardized agent communication
– Agent discovery via agent card
– Task lifecycle management
– Streaming response support
– Marketplace compatible

3. Gemini Enterprise (Google Cloud Marketplace)

Use Case: Google Cloud Marketplace customers using Gemini Enterprise

Endpoint: https://agent.stactize.com/

Protocol: A2A (Agent-to-Agent) Protocol

Authentication: OAuth 2.0 Authorization Code Grant Flow (via Google OAuth)

Registration: Automatic via Dynamic Client Registration (DCR)

Benefits:
– Seamless integration with Gemini Enterprise
– Automatic OAuth client registration via DCR
– Google-signed JWT verification for security
– Customer identification via Marketplace Order ID
– Usage metering per Marketplace order

4. Direct Cloud Run (Development/Internal)

Use Case: Internal tools, development environments, testing

Endpoint: https://saas-research-a2a-[PROJECT_ID].europe-west4.run.app

Protocol: JSON-RPC 2.0 or A2A Protocol

Authentication: None (if deployed with --allow-unauthenticated)

Benefits:
– Lower latency (no API Gateway overhead)
– Simplified setup for development
– Direct access to agent