Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

docs: add multi-turn .use() examples to Vercel, OpenAI, Anthropic providers

Abir Taheer75e42e96901c
diff --git a/docs/content/docs/providers/anthropic.mdx b/docs/content/docs/providers/anthropic.mdx
index c7fd99c4f..7f2c4c4b1 100644
--- a/docs/content/docs/providers/anthropic.mdx
+++ b/docs/content/docs/providers/anthropic.mdx
@@ -148,3 +148,41 @@ for (const block of response.content) {
</Tabs>
</Step>
</Steps>
+
+## Multi-turn chat
+
+For multi-turn apps, create the session once and reuse it across requests with `composio.use()`:
+
+<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
+<Tab value="Python">
+```python
+from composio import Composio
+
+composio = Composio()
+
+# First request — create and store the session ID
+session = composio.create(user_id="user_123")
+session_id = session.session_id
+# store session_id in your database or chat state
+
+# Subsequent requests — reuse the session
+session = composio.use(session_id)
+tools = session.tools()
+```
+</Tab>
+<Tab value="TypeScript">
+```typescript
+import { Composio } from '@composio/core';
+const composio = new Composio({ apiKey: 'your_api_key' });
+// ---cut---
+// First request — create and store the session ID
+const session = await composio.create("user_123");
+const sessionId = session.sessionId;
+// store sessionId in your database or chat state
+
+// Subsequent requests — reuse the session
+const session2 = await composio.use(sessionId);
+const tools = await session2.tools();
+```
+</Tab>
+</Tabs>
diff --git a/docs/content/docs/providers/openai.mdx b/docs/content/docs/providers/openai.mdx
index 09f4aa425..fa7e57e1b 100644
--- a/docs/content/docs/providers/openai.mdx
+++ b/docs/content/docs/providers/openai.mdx
@@ -297,3 +297,41 @@ console.log(response.choices[0].message.content);
</IntegrationContent>
</IntegrationTabs>
+
+## Multi-turn chat
+
+For multi-turn apps, create the session once and reuse it across requests with `composio.use()`. Store the session ID in your database or chat state:
+
+<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
+<Tab value="Python">
+```python
+from composio import Composio
+
+composio = Composio()
+
+# First request — create and store the session ID
+session = composio.create(user_id="user_123")
+session_id = session.session_id
+# store session_id in your database or chat state
+
+# Subsequent requests — reuse the session
+session = composio.use(session_id)
+tools = session.tools()
+```
+</Tab>
+<Tab value="TypeScript">
+```typescript
+import { Composio } from '@composio/core';
+const composio = new Composio({ apiKey: 'your_api_key' });
+// ---cut---
+// First request — create and store the session ID
+const session = await composio.create("user_123");
+const sessionId = session.sessionId;
+// store sessionId in your database or chat state
+
+// Subsequent requests — reuse the session
+const session2 = await composio.use(sessionId);
+const tools = await session2.tools();
+```
+</Tab>
+</Tabs>
diff --git a/docs/content/docs/providers/vercel.mdx b/docs/content/docs/providers/vercel.mdx
index 23be1ec99..f3b7d7281 100644
--- a/docs/content/docs/providers/vercel.mdx
+++ b/docs/content/docs/providers/vercel.mdx
@@ -56,3 +56,32 @@ console.log(text);
```
</Step>
</Steps>
+
+## Multi-turn chat
+
+For multi-turn apps, create the session once and reuse it across requests with `composio.use()`:
+
+```typescript
+import { anthropic } from "@ai-sdk/anthropic";
+import { Composio } from "@composio/core";
+import { VercelProvider } from "@composio/vercel";
+import { generateText, stepCountIs } from "ai";
+
+const composio = new Composio({ provider: new VercelProvider() });
+
+// First request — create and store the session ID
+const session = await composio.create("user_123");
+const sessionId = session.sessionId;
+// store sessionId in your database or chat state
+
+// Subsequent requests — reuse the session
+const session2 = await composio.use(sessionId);
+const tools = await session2.tools();
+
+const { text } = await generateText({
+ model: anthropic("claude-opus-4-6"),
+ tools,
+ prompt: "What emails did I get today?",
+ stopWhen: stepCountIs(10),
+});
+```