Skip to content

The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:

docs - agent demo link (#71074)

Jeff Bruemmeree6203aa6e63
diff --git a/docs/ai/agent-api.md b/docs/ai/agent-api.md
index 9fe5d85e699..d1f34e6a306 100644
--- a/docs/ai/agent-api.md
+++ b/docs/ai/agent-api.md
@@ -31,9 +31,7 @@ Base path:[/api/agent](../api.html#tag/apiagent)
## Authentication
-The Agent API supports two authentication modes, both requiring JWT to be configured in Metabase admin settings (**Admin** > **Settings** > **Authentication** > **JWT**):
-
-### 1. Stateless JWT (recommended for agents)
+The Agent API uses stateless JWT authentication. JWT must be configured in Metabase admin settings (**Admin** > **Settings** > **Authentication** > **JWT**).
Pass a signed JWT directly in each request:
@@ -60,15 +58,14 @@ Example JWT payload:
}
```
-### 2. Session-based
+## Example application
-Exchange a JWT at `POST /auth/sso` to get a session token, then pass the session token via:
+![Metabase Agent chat answering a product rating question](./images/agent-api-demo.png)
-```
-X-Metabase-Session: <session-token>
-```
+Check out the [Metabase Agent API demo](https://github.com/metabase/metabase-agent-api-demo) for a working example of an agentic BI app built on the Agent API.
## Further reading
+- [Metabase Agent API demo](https://github.com/metabase/metabase-agent-api-demo)
- [Metabase API docs](../api.html)
- [JWT authentication](../people-and-groups/authenticating-with-jwt.md)
diff --git a/docs/ai/images/agent-api-demo.png b/docs/ai/images/agent-api-demo.png
new file mode 100644
index 00000000000..0d9e0e26506
Binary files /dev/null and b/docs/ai/images/agent-api-demo.png differ