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, 02:00 UTC
docs: replace tool naming with best practices section
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Dhawal Upadhyay committed
Mar 23, 2026 at 18:28 UTC
c78f5f98d92e398461e3d1d5e3fa89e599a11e10
1 file changed
+6
-3
docs/content/docs/toolkits/custom-tools-and-toolkits.mdx
+6
-3
@@ -114,11 +114,14 @@ Custom tools integrate seamlessly with Composio's meta tools:
114
- **`COMPOSIO_MANAGE_CONNECTIONS`** handles auth for extension tools — if a tool extends `gmail`, the agent can prompt the user to connect Gmail just like any other toolkit
115
- Custom tools are **not supported in Workbench** — the LLM is made aware of this and will not attempt to use them there
116
117
-## Tool naming
117
+## Best practices
118
119
-Tool names exposed to the agent are automatically prefixed with `LOCAL_` and the toolkit name (if any). For example, `GET_USER_PROFILE` becomes `LOCAL_GET_USER_PROFILE`, and `ASSIGN_ROLE` inside `USER_MANAGEMENT` becomes `LOCAL_USER_MANAGEMENT_ASSIGN_ROLE`.
119
+- **Descriptive names and slugs** — The agent sees your tool's name and description to decide when to use it. Be specific: "Send weekly promo email" is better than "Send email". Slugs should be uppercase with underscores: `SEND_PROMO_EMAIL`.
120
+- **Detailed descriptions** — Include what the tool does, when to use it, and what it returns. The agent relies on this to pick the right tool.
121
+- **Use `extendsToolkit` for auth** — If your tool needs Gmail/GitHub/etc. auth for `ctx.proxyExecute()` or `ctx.execute()`, set `extendsToolkit` so connection management is handled seamlessly via `COMPOSIO_MANAGE_CONNECTIONS`.
122
+- **Tool names get prefixed** — Slugs exposed to the agent are automatically prefixed with `LOCAL_` and the toolkit name (if any). `GET_USER_PROFILE` becomes `LOCAL_GET_USER_PROFILE`, `ASSIGN_ROLE` in `USER_MANAGEMENT` becomes `LOCAL_USER_MANAGEMENT_ASSIGN_ROLE`. Your slugs cannot start with `LOCAL_` — this prefix is reserved.
123
121
-Registered slugs cannot start with `LOCAL_` — this prefix is reserved.
124
+For more best practices, see [How to Build Tools for AI Agents: A Field Guide](https://composio.dev/blog/how-to-build-tools-for-ai-agents-a-field-guide).
125
126
## Verifying registration
127