Integration

Factory interface for managing Splunk AO integrations. Integration is the main entry point for working with LLM providers and other external services in the Splunk AO platform. It provides factory methods to create new integrations and list existing ones. The Integration class returns Provider objects, which are immutable proxies to integrations stored in the Splunk AO API. Provider classes should not be imported or instantiated directly - always use the Integration class methods. Examples

List all available integration types (including unconnected)

available_types = Integration.list(all=True)

Returns: [‘anthropic’, ‘aws_bedrock’, ‘azure’, ‘openai’, …]

Create a new OpenAI integration

openai = Integration.create_openai( token=“sk-proj-…”, organization_id=“org-…” ) print(f”Created: {openai.id}“)

Create an Azure integration

azure = Integration.create_azure( token=“your-key”, endpoint=“https://your-resource.openai.azure.com” )

List all connected integrations (returns provider proxy objects)

providers = Integration.list() for provider in providers: print(f”{provider.name}: {provider.id}”) print(f”Created by: {provider.created_by}”) print(f”Selected: {provider.is_selected}“)

Update provider credentials

openai.update( token=“new-sk-proj-…”, organization_id=“new-org-…” )

Refresh provider state from API

openai.refresh()

Get available models (placeholder - not yet implemented)

models = openai.models

Delete a provider

openai.delete()

Create other providers

bedrock = Integration.create_bedrock( aws_access_key_id=“AKIA…”, aws_secret_access_key=”…”, region=“us-west-2” ) anthropic = Integration.create_anthropic(token=“sk-ant-…“)

anthropic

def anthropic(cls) -> Provider | UnconfiguredProvider

Get the configured Anthropic (Claude) integration. Examples anthropic = Integration.anthropic if anthropic: print(f”Anthropic integration: {anthropic.id}“)

azure

def azure(cls) -> Provider | UnconfiguredProvider

Get the configured Azure OpenAI integration. Examples azure = Integration.azure if azure: print(f”Azure integration: {azure.id}“)

bedrock

def bedrock(cls) -> Provider | UnconfiguredProvider

Get the configured AWS Bedrock integration. Examples bedrock = Integration.bedrock if bedrock: print(f”Bedrock integration: {bedrock.id}“)

create_anthropic

def create_anthropic(cls, *, token: str) -> AnthropicProvider

Create a new Anthropic (Claude) integration. Arguments

token (str): Anthropic API token.

create_azure

def create_azure(cls, *, token: str, endpoint: str) -> AzureProvider

Create a new Azure OpenAI integration. Arguments

token (str): Azure API key.
endpoint (str): Azure OpenAI endpoint URL.

create_bedrock

def create_bedrock(cls,
                   *,
                   aws_access_key_id: str,
                   aws_secret_access_key: str,
                   region: str='us-east-1',
                   credential_type: str='key_secret') -> BedrockProvider

Create a new AWS Bedrock integration. Arguments

aws_access_key_id (str): AWS access key ID.
aws_secret_access_key (str): AWS secret access key.
region (str): AWS region. Defaults to “us-east-1”.
credential_type (str): Type of credentials. Defaults to “key_secret”.

create_openai

def create_openai(cls,
                  *,
                  token: str,
                  organization_id: str | None=None) -> OpenAIProvider

Create a new OpenAI integration. Arguments

token (str): OpenAI API token.
organization_id (str | None): Optional organization ID.

list

def list(cls, *, all: bool=False) -> list[Provider] | list[str]

List integrations. Arguments

all (bool): If True, returns all available integration types (including unconnected ones) as a list of strings. If False, returns only the configured integrations as Provider objects. Defaults to False.

mistral

def mistral(cls) -> Provider | UnconfiguredProvider

Get the configured Mistral AI integration. Examples mistral = Integration.mistral if mistral: print(f”Mistral integration: {mistral.id}“)

openai

def openai(cls) -> Provider | UnconfiguredProvider

Get the configured OpenAI integration. Examples openai = Integration.openai if openai: print(f”OpenAI integration: {openai.id}“)

refresh

def refresh(self) -> None

Refresh the integration state from the remote API. Note: Currently, the API does not support fetching individual integrations by ID. This method will re-fetch all integrations and find the matching one.

Raises

APIError: If the API call fails or the integration is not found.

vertex_ai

def vertex_ai(cls) -> Provider | UnconfiguredProvider

Get the configured Google Vertex AI integration. Examples vertex = Integration.vertex_ai if vertex: print(f”Vertex AI integration: {vertex.id}”)

Overview

Python SDK

API

integration

Integration

List all available integration types (including unconnected)

Returns: [‘anthropic’, ‘aws_bedrock’, ‘azure’, ‘openai’, …]

Create a new OpenAI integration

Create an Azure integration

List all connected integrations (returns provider proxy objects)

Update provider credentials

Refresh provider state from API

Get available models (placeholder - not yet implemented)

models = openai.models

Delete a provider

Create other providers

anthropic

azure

bedrock

create_anthropic

create_azure

create_bedrock

create_openai

list

mistral

openai

refresh

Raises

vertex_ai

​Integration

​List all available integration types (including unconnected)

​Returns: [‘anthropic’, ‘aws_bedrock’, ‘azure’, ‘openai’, …]

​Create a new OpenAI integration

​Create an Azure integration

​List all connected integrations (returns provider proxy objects)

​Update provider credentials

​Refresh provider state from API

​Get available models (placeholder - not yet implemented)

​models = openai.models

​Delete a provider

​Create other providers

​anthropic

​azure

​bedrock

​create_anthropic

​create_azure

​create_bedrock

​create_openai

​list

​mistral

​openai

​refresh

​Raises

​vertex_ai

Integration

List all available integration types (including unconnected)

Returns: [‘anthropic’, ‘aws_bedrock’, ‘azure’, ‘openai’, …]

Create a new OpenAI integration

Create an Azure integration

List all connected integrations (returns provider proxy objects)

Update provider credentials

Refresh provider state from API

Get available models (placeholder - not yet implemented)

models = openai.models

Delete a provider

Create other providers

anthropic

azure

bedrock

create_anthropic

create_azure

create_bedrock

create_openai

list

mistral

openai

refresh

Raises

vertex_ai