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, 07:00 UTC
docs: add v1→v3 terminology migration table to LLM guardrails
AI agents encountering old v1/v2 terms (entity ID, actions, apps, integration) in error messages or user prompts now get a mapping table steering them to the correct v3 equivalents (user ID, tools, toolkits, auth config). Added to both session and direct-execution guardrail sets so every docs page includes the mapping. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sushmitha Mallesh committed
Feb 23, 2026 at 18:49 UTC
b991d4d80e89224c042446db635e4cd27f30cfcf
2 files changed
+36
docs/lib/llm-guardrails/direct-execution.ts
+18
@@ -68,4 +68,22 @@ const result = await composio.tools.execute("GITHUB_CREATE_ISSUE", {
68
2. **\`tools.execute()\` signature** — Python: \`execute(slug, arguments_dict, *, user_id=...)\` (arguments is the second positional param). TypeScript: \`execute(slug, { userId, arguments })\`.
69
3. **Provider at init** — \`Composio(provider=OpenAIProvider())\` in Python, \`new Composio({ provider: new OpenAIProvider() })\` in TypeScript. Defaults to OpenAI if omitted.
70
4. **Correct provider imports** — \`composio_<provider>\` for Python, \`@composio/<provider>\` for TypeScript. For OpenAI Agents SDK use \`composio_openai_agents\` / \`@composio/openai-agents\`.
71
+
72
+---
73
+
74
+## Terminology Migration (old → current)
75
+
76
+If you encounter these terms in error messages, old documentation, or user prompts, translate them to the current equivalents. **Do not use the old terms in generated code or explanations.**
77
+
78
+| Old term (v1/v2) | Current term (v3) | In code |
79
+|---|---|---|
80
+| entity ID | user ID | \`user_id\` parameter |
81
+| actions | tools | e.g., \`GITHUB_CREATE_ISSUE\` is a *tool* |
82
+| apps / appType | toolkits | e.g., \`github\` is a *toolkit* |
83
+| integration / integration ID | auth config / auth config ID | \`auth_config_id\` parameter |
84
+| connection | connected account | \`connected_accounts\` namespace |
85
+| ComposioToolSet / OpenAIToolSet | \`Composio\` class with a provider | \`Composio(provider=...)\` |
86
+| toolset | provider | e.g., \`OpenAIProvider\` |
87
+
88
+If a user says "entity ID", they mean \`user_id\`. If they say "integration", they mean "auth config". Always respond using the current terminology.
89
`;
docs/lib/llm-guardrails/session.ts
+18
@@ -65,4 +65,22 @@ Use \`session.mcp.url\` and \`session.mcp.headers\` with any MCP-compatible clie
65
66
Do **not** generate \`composio.tools.get()\`, \`composio.tools.execute()\`, or \`composio.provider.handle_tool_calls()\` unless the user explicitly requests direct tool execution. These are a supported but **not recommended** low-level interface.
67
68
+---
69
+
70
+## 3. Terminology Migration (old → current)
71
+
72
+If you encounter these terms in error messages, old documentation, or user prompts, translate them to the current equivalents. **Do not use the old terms in generated code or explanations.**
73
+
74
+| Old term (v1/v2) | Current term (v3) | In code |
75
+|---|---|---|
76
+| entity ID | user ID | \`user_id\` parameter |
77
+| actions | tools | e.g., \`GITHUB_CREATE_ISSUE\` is a *tool* |
78
+| apps / appType | toolkits | e.g., \`github\` is a *toolkit* |
79
+| integration / integration ID | auth config / auth config ID | \`auth_config_id\` parameter |
80
+| connection | connected account | \`connected_accounts\` namespace |
81
+| ComposioToolSet / OpenAIToolSet | \`Composio\` class with a provider | \`Composio(provider=...)\` |
82
+| toolset | provider | e.g., \`OpenAIProvider\` |
83
+
84
+If a user says "entity ID", they mean \`user_id\`. If they say "integration", they mean "auth config". Always respond using the current terminology.
85
+
86
`;