@devries-cameron20 / composio Mirror · read-only / commits / c78f5f98d
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, 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