integrations-infrastructure

What problem does it solve?

Centralizes documentation and operational patterns for every external service the HBG Portal connects to, making integration configuration, security boundaries, and health monitoring explicit to avoid misconfiguration, undocumented secrets, and runtime failures.

Core Features & Use Cases

• Provider clients and env mappings: Documents AI providers (Anthropic, OpenAI, Gemini), voice AI, image generation, financial data feeds (FRED), geospatial services, and document intelligence along with their environment variable names and primary files.
• Security and resilience: Describes SSRF protection, rate limits, error handling, caching, scheduler refresh patterns, and access checks used to harden outbound requests and validation endpoints.
• Source registry and observability: Explains the card-based source registry with health badges, call logging, CRUD and test endpoints, and integration telemetry for admins to configure, test, and monitor external sources.

Quick Start

Use this skill to find the provider client file locations, required environment variables, and admin source-registry test endpoint, then run the registry test to validate connectivity and health.