@devries-cameron20 / composio Mirror · read-only / commits / 0848be34d
Fork 0

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

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 22, 03:15 UTC

docs: add take it further sections to remaining cookbooks

Added to: fast-api, gmail-labeler, hono, slack-summariser, supabase-sql-agent, tool-generator. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Sushmitha Mallesh committed Mar 11, 2026 at 02:44 UTC 0848be34d92550833776fbbadc84450ff4342658
6 files changed +78
docs/content/cookbooks/fast-api.mdx
+13
@@ -112,3 +112,16 @@ curl -X POST http://localhost:8000/connect/gmail \
112 ```
113
114 Open the `redirect_url` from the response in your browser to complete OAuth.
115 +
116 +## Take it further
117 +
118 +This server is a starting point. A few ways to extend it:
119 +
120 +- **Add auth middleware**: pass `user_id` from your JWT or session instead of the request body
121 +- **Webhook-driven agents**: add a `/webhook` endpoint that triggers the agent from Stripe, GitHub, or Slack events
122 +- **Multi-agent routing**: spin up different agents per endpoint — one for email, one for code review, one for scheduling
123 +
124 +<Cards>
125 + <Card title="Build a Chat App" href="/cookbooks/chat-app" description="Full Next.js chat UI with streaming and multi-user auth" />
126 + <Card title="Hono Server" href="/cookbooks/hono" description="Same pattern in Hono.js for TypeScript backends" />
127 +</Cards>
docs/content/cookbooks/gmail-labeler.mdx
+13
@@ -81,3 +81,16 @@ uv run --env-file .env python main.py listen default
81 ```
82
83 Send yourself an email and watch the terminal. The agent will receive the event, inspect the email, and apply a label.
84 +
85 +## Take it further
86 +
87 +The trigger + agent pattern works for any event-driven workflow. Swap the prompt and toolkit to build:
88 +
89 +- **Auto-responder**: draft and send replies to common questions instead of just labeling
90 +- **Slack notifier**: add the Slack toolkit so the agent posts a summary of important emails to a channel
91 +- **Lead router**: connect Salesforce and have the agent tag inbound emails by deal stage and assign to reps
92 +
93 +<Cards>
94 + <Card title="Slack Summarizer" href="/cookbooks/slack-summariser" description="Summarize Slack channels with a single command" />
95 + <Card title="Background Agent" href="/cookbooks/background-agent" description="Run agents autonomously on a schedule" />
96 +</Cards>
docs/content/cookbooks/hono.mdx
+13
@@ -112,3 +112,16 @@ curl -X POST http://localhost:8000/connect/gmail \
112 ```
113
114 Open the `redirectUrl` from the response in your browser to complete OAuth.
115 +
116 +## Take it further
117 +
118 +This server handles chat, connections, and OAuth in ~50 lines. A few ways to extend it:
119 +
120 +- **Trigger endpoints**: add a `/webhooks` route that receives [Composio trigger events](/docs/setting-up-triggers/subscribing-to-events) and kicks off an agent run
121 +- **Scoped toolkits per route**: give `/chat/support` access to Zendesk and Notion, and `/chat/sales` access to Salesforce and Gmail
122 +- **Edge deployment**: Hono runs on Cloudflare Workers — deploy the same agent at the edge with zero changes
123 +
124 +<Cards>
125 + <Card title="FastAPI Server" href="/cookbooks/fast-api" description="Same pattern in Python with FastAPI" />
126 + <Card title="Build a Chat App" href="/cookbooks/chat-app" description="Full Next.js chat UI with streaming and multi-user auth" />
127 +</Cards>
docs/content/cookbooks/slack-summariser.mdx
+13
@@ -71,3 +71,16 @@ uv run --env-file .env python main.py summarize default general
71 ```
72
73 Replace `general` with any channel name you want to summarize.
74 +
75 +## Take it further
76 +
77 +The summarizer reads from one channel, but the same pattern scales to broader workflows:
78 +
79 +- **Cross-channel digest**: summarize multiple channels in one run and post a combined digest to a `#daily-summary` channel
80 +- **Trigger-based**: use a [Slack trigger](/docs/setting-up-triggers/creating-triggers) to auto-summarize whenever a channel hits 50+ unread messages
81 +- **Action items to Linear**: add the Linear toolkit and have the agent extract action items from the summary and create tickets
82 +
83 +<Cards>
84 + <Card title="Gmail Labeler" href="/cookbooks/gmail-labeler" description="Event-driven agent that labels emails as they arrive" />
85 + <Card title="Background Agent" href="/cookbooks/background-agent" description="Run agents autonomously on a schedule" />
86 +</Cards>
docs/content/cookbooks/supabase-sql-agent.mdx
+13
@@ -80,3 +80,16 @@ you > What are the top 10 most recent orders?
80 ```
81
82 Type `exit` to quit.
83 +
84 +## Take it further
85 +
86 +The agent has full access to your Supabase projects via SQL. Some ideas:
87 +
88 +- **Scheduled reports**: wrap this in a cron job to generate daily metrics and post them to Slack using the Slack toolkit
89 +- **Admin dashboard backend**: pair with FastAPI to expose natural-language queries as an API for internal tools
90 +- **Data migration helper**: ask the agent to compare schemas across projects and generate migration SQL
91 +
92 +<Cards>
93 + <Card title="FastAPI Server" href="/cookbooks/fast-api" description="Wrap an agent in an HTTP server with auth and connection management" />
94 + <Card title="Background Agent" href="/cookbooks/background-agent" description="Run agents autonomously on a schedule" />
95 +</Cards>
docs/content/cookbooks/tool-generator.mdx
+13
@@ -79,3 +79,16 @@ Export raw tool schemas to a JSON file:
79 ```bash
80 uv run --env-file .env python main.py export gmail tools.json
81 ```
82 +
83 +## Take it further
84 +
85 +Raw tool schemas are building blocks for platform features:
86 +
87 +- **Dynamic form builder**: use `input_parameters` JSON Schema to render forms for any tool — no hardcoded UI per integration
88 +- **Type generation pipeline**: feed exported JSON into `json-schema-to-typescript` or `datamodel-code-generator` in CI to keep types in sync
89 +- **Tool catalog UI**: combine `list-tools` and `toolkit-info` to build a searchable directory of available integrations and their auth requirements
90 +
91 +<Cards>
92 + <Card title="App Connections Dashboard" href="/cookbooks/app-connections-dashboard" description="Build a UI for managing user connections" />
93 + <Card title="Tool Type Generator source" href="https://github.com/ComposioHQ/composio/tree/next/docs/examples/tool-generator" description="View the full source on GitHub" />
94 +</Cards>