Skip to main content

How to Set Up Google Agent Builder

Connect AuditSwarm to Google Agent Builder (Gemini platform) for AI-assisted audit management.

Prerequisites​

  • Google Cloud account with Agent Builder access
  • AuditSwarm account

Configuration​

Configure via Agent Builder UI with these settings:

SettingValue
OpenAPI Spechttps://demo.auditswarm.com/api/openapi-v3
Execute Endpointhttps://demo.auditswarm.com/api/agent/execute
Auth TypeOAuth 2.1 (Custom)
Authorization URLhttps://demo.auditswarm.com/api/oauth/authorize
Token URLhttps://demo.auditswarm.com/api/oauth/token

Setup Steps​

Step 1: Create an Agent​

  1. Go to Google Agent Builder
  2. Create a new agent or open an existing one
  3. Navigate to Tools or Actions

Step 2: Import OpenAPI Specification​

  1. Click Add Tool or Import
  2. Select OpenAPI Spec
  3. Enter URL: https://demo.auditswarm.com/api/openapi-v3
  4. Click Import

Step 3: Configure Authentication​

  1. Go to Authentication settings
  2. Select OAuth 2.0
  3. Enter the authorization and token URLs above
  4. Save the configuration

Step 4: Test the Integration​

  1. Open the agent preview
  2. Ask: "List my audits"
  3. Complete OAuth login when prompted
  4. Verify audit data appears

Available Operations​

The OpenAPI spec exposes these operations:

OperationDescription
suggest_changeCreate/update/delete entities via suggestions
query_dataQuery audits, risks, controls, workflows
get_current_contextGet user's current page context
helpGet workflow guidance

Example Prompts​

Once connected, try these prompts:

Query Data:

  • "List all audits in progress"
  • "Show high-severity risks"
  • "What controls are in place?"

Make Changes:

  • "Update the SOC2 audit status"
  • "Create a new risk assessment"
  • "Mark control as implemented"

Troubleshooting​

Import Fails​

Cause: OpenAPI spec URL not accessible.

Solution:

  1. Verify URL is correct: https://demo.auditswarm.com/api/openapi-v3
  2. Try opening the URL in a browser
  3. Check your network connectivity

Authentication Errors​

Cause: OAuth configuration incorrect.

Solution:

  1. Verify authorization URL ends with /api/oauth/authorize
  2. Verify token URL ends with /api/oauth/token
  3. Re-configure authentication settings

No Data Returned​

Cause: You may not have data in AuditSwarm.

Solution:

  1. Log into AuditSwarm directly
  2. Create some test audits/risks
  3. Try the query again

Next Steps​