atoti_ai.AiConfig

atoti_ai.AiConfig(
    *,
    connection: ConnectionConfig | None = None,
    chat: ChatConfig | None = None,
    chat_enabled: bool = True,
    disclaimer: str = 'AI can make mistakes, please double check response.',
    dynamic_tool_discovery: bool | None = None,
    max_attempts: int = 5,
    prompt: PromptConfig = PromptConfig(timeout=datetime.timedelta(seconds=300), max_consecutive_identical_tool_calls=3, max_tool_errors=5, max_consecutive_refused_rounds=3, max_retry_attempts=1),
    auto_explain: AutoExplainConfig = AutoExplainConfig(retained_run_count=100, run_lifetime=datetime.timedelta(seconds=6000)),
    mcp: McpClientConfig | None = None,
)

Atoti Intelligence configuration. The default disclaimer:

>>> _fetch_ai_disclaimer(session_with_ai)
'AI can make mistakes, please double check response.'

Changing the disclaimer:

>>> import os
>>> from atoti_ai import AiConfig
>>> from atoti_ai_amazon_bedrock import ConnectionConfig, ChatConfig
>>> connection_config = ConnectionConfig(
...     aws_access_key=os.environ["AWS_ACCESS_KEY_ID"],
...     aws_secret_key=os.environ["AWS_SECRET_ACCESS_KEY"],
...     aws_region="eu-west-3",
... )
>>> chat_config = ChatConfig(
...     model="eu.anthropic.claude-sonnet-4-6",
... )
>>> custom_disclaimer = "Custom disclaimer."
>>> ai_config = AiConfig(
...     connection=connection_config,
...     chat=chat_config,
...     disclaimer=custom_disclaimer,
... )
>>> session_config = tt.SessionConfig(ai=ai_config)

Opting out of dynamic_tool_discovery:

>>> import atoti as tt
>>> import os
>>> from atoti_ai import AiConfig
>>> from atoti_ai_amazon_bedrock import ConnectionConfig, ChatConfig
>>> connection_config = ConnectionConfig(
...     aws_access_key=os.environ["AWS_ACCESS_KEY_ID"],
...     aws_secret_key=os.environ["AWS_SECRET_ACCESS_KEY"],
...     aws_region="eu-west-3",
... )
>>> chat_config = ChatConfig(
...     model="eu.anthropic.claude-sonnet-4-6",
... )
>>> ai_config = AiConfig(
...     connection=connection_config,
...     chat=chat_config,
...     dynamic_tool_discovery=False,
... )
>>> session_config = tt.SessionConfig(ai=ai_config)

Disabling the chat endpoint:

>>> import atoti as tt
>>> import os
>>> from atoti_ai import AiConfig
>>> from atoti_ai_amazon_bedrock import ConnectionConfig, ChatConfig
>>> connection_config = ConnectionConfig(
...     aws_access_key=os.environ["AWS_ACCESS_KEY_ID"],
...     aws_secret_key=os.environ["AWS_SECRET_ACCESS_KEY"],
...     aws_region="eu-west-3",
... )
>>> chat_config = ChatConfig(
...     model="eu.anthropic.claude-sonnet-4-6",
... )
>>> ai_config = AiConfig(
...     connection=connection_config,
...     chat=chat_config,
...     chat_enabled=False,
... )
>>> session_config = tt.SessionConfig(ai=ai_config)

Keeping more Auto-Explain analyses retrievable from the chat, for longer:

>>> import atoti as tt
>>> import os
>>> from datetime import timedelta
>>> from atoti_ai import AiConfig, AutoExplainConfig
>>> from atoti_ai_amazon_bedrock import ConnectionConfig, ChatConfig
>>> connection_config = ConnectionConfig(
...     aws_access_key=os.environ["AWS_ACCESS_KEY_ID"],
...     aws_secret_key=os.environ["AWS_SECRET_ACCESS_KEY"],
...     aws_region="eu-west-3",
... )
>>> chat_config = ChatConfig(
...     model="eu.anthropic.claude-sonnet-4-6",
... )
>>> ai_config = AiConfig(
...     connection=connection_config,
...     chat=chat_config,
...     auto_explain=AutoExplainConfig(
...         retained_run_count=500,
...         run_lifetime=timedelta(hours=8),
...     ),
... )
>>> session_config = tt.SessionConfig(ai=ai_config)

See also: atoti.Cube.auto_explain and atoti.Session.chat.

Attributes

connection

The configuration of the connection to the LLM provider.

chat

The configuration of the LLM this session prompts. This is not chat_enabled: the LLM configured here serves every AI feature needing one, such as summarizing an atoti.Cube.auto_explain analysis.

chat_enabled

Whether this session serves the chat endpoint. This only has an impact if an LLM is configured (i.e. both connection and chat are not None).

True: the AI chat in Atoti UI is usable.
False: the AI chat in Atoti UI cannot be used and atoti.Session.chat is None, but the LLM stays enabled so auto_explain summaries are still generated.

Added in version 6.2.1.

disclaimer

The disclaimer displayed in Atoti UI next to AI-generated content.

dynamic_tool_discovery

Whether the chat sends the LLM only the tools matching each request.

True: the LLM calls a tool-search tool that queries a keyword index. It receives only the matching tools, which reduces prompt token usage and improves tool selection.
False: the whole tool set is sent on every request. A small tool set, where searching brings no benefit, is one reason to do so. Inspecting which tools the LLM can see is another.
None: the server enables this if the license includes Atoti Intelligence Essentials, and leaves it disabled otherwise.

Added in version 6.2.1.

max_attempts

How many times a call to the LLM is sent, retries included. A failed request is re-sent by the provider’s own client, backing off between attempts. This bounds that for whichever provider the session connects to, taking precedence over the provider’s own property. Set it to 1 to disable retries. Each attempt is bounded by the connection timeouts. Some providers have a dedicated option for this: * atoti_ai_amazon_bedrock.ConnectionConfig.timeout.

Added in version 6.2.1.

prompt

What one chat prompt may spend before the session gives up on it.

Added in version 6.2.1.

auto_explain

The configuration of atoti.Cube.auto_explain.

Added in version 6.2.1.

mcp

The configuration of the MCP servers to take additional tools from.

Added in version 6.2.1.

Releases and upgrades

Getting started

Guides

API reference

AiConfig

Attributes

connection

chat

chat_enabled

disclaimer

dynamic_tool_discovery

max_attempts

prompt

auto_explain

mcp

​Attributes

​connection

​chat

​chat_enabled

​disclaimer

​dynamic_tool_discovery

​max_attempts

​prompt

​auto_explain

​mcp

Attributes

connection

chat

chat_enabled

disclaimer

dynamic_tool_discovery

max_attempts

prompt

auto_explain

mcp