zoho_bigin-automation

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Zoho Bigin Automation via Rube MCP

通过Rube MCP实现Zoho Bigin自动化

Automate Zoho Bigin operations through Composio's Zoho Bigin toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/zoho_bigin

通过Composio的Zoho Bigin工具包，借助Rube MCP自动化Zoho Bigin的各项操作。

工具包文档：composio.dev/toolkits/zoho_bigin

Prerequisites

前提条件

Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
Active Zoho Bigin connection via
```
RUBE_MANAGE_CONNECTIONS
```
with toolkit
```
zoho_bigin
```
Always call
```
RUBE_SEARCH_TOOLS
```
first to get current tool schemas

必须已连接Rube MCP（需具备RUBE_SEARCH_TOOLS功能）
通过
```
RUBE_MANAGE_CONNECTIONS
```
并使用工具包
```
zoho_bigin
```
建立有效的Zoho Bigin连接
请始终先调用
```
RUBE_SEARCH_TOOLS
```
以获取最新的工具架构

Setup

设置步骤

Get Rube MCP: Add

https://rube.app/mcp

as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

Verify Rube MCP is available by confirming
```
RUBE_SEARCH_TOOLS
```
responds
Call
```
RUBE_MANAGE_CONNECTIONS
```
with toolkit
```
zoho_bigin
```
If connection is not ACTIVE, follow the returned auth link to complete setup
Confirm connection status shows ACTIVE before running any workflows

获取Rube MCP：在客户端配置中添加

https://rube.app/mcp

作为MCP服务器。无需API密钥——只需添加端点即可使用。

通过确认
```
RUBE_SEARCH_TOOLS
```
能正常响应，验证Rube MCP是否可用
使用工具包
```
zoho_bigin
```
调用
```
RUBE_MANAGE_CONNECTIONS
```
如果连接状态不是ACTIVE，请按照返回的授权链接完成设置
在运行任何工作流之前，确认连接状态显示为ACTIVE

Tool Discovery

工具发现

Always discover available tools before executing workflows:

RUBE_SEARCH_TOOLS: queries=[{"use_case": "pipelines, contacts, companies, products, and small business CRM", "known_fields": ""}]

This returns:

Available tool slugs for Zoho Bigin
Recommended execution plan steps
Known pitfalls and edge cases
Input schemas for each tool

在执行工作流之前，请始终先发现可用工具：

RUBE_SEARCH_TOOLS: queries=[{"use_case": "pipelines, contacts, companies, products, and small business CRM", "known_fields": ""}]

此调用将返回：

Zoho Bigin的可用工具别名
推荐的执行计划步骤
已知的陷阱和边缘情况
每个工具的输入架构

Core Workflows

核心工作流

1. Discover Available Zoho Bigin Tools

1. 发现可用的Zoho Bigin工具

RUBE_SEARCH_TOOLS:
  queries:
    - use_case: "list all available Zoho Bigin tools and capabilities"

Review the returned tools, their descriptions, and input schemas before proceeding.

RUBE_SEARCH_TOOLS:
  queries:
    - use_case: "list all available Zoho Bigin tools and capabilities"

在继续操作前，请查看返回的工具、描述以及输入架构。

2. Execute Zoho Bigin Operations

2. 执行Zoho Bigin操作

After discovering tools, execute them via:

RUBE_MULTI_EXECUTE_TOOL:
  tools:
    - tool_slug: "<discovered_tool_slug>"
      arguments: {<schema-compliant arguments>}
  memory: {}
  sync_response_to_workbench: false

发现工具后，通过以下方式执行：

RUBE_MULTI_EXECUTE_TOOL:
  tools:
    - tool_slug: "<discovered_tool_slug>"
      arguments: {<schema-compliant arguments>}
  memory: {}
  sync_response_to_workbench: false

3. Multi-Step Workflows

3. 多步骤工作流

For complex workflows involving multiple Zoho Bigin operations:

Search for all relevant tools:
```
RUBE_SEARCH_TOOLS
```
with specific use case
Execute prerequisite steps first (e.g., fetch before update)
Pass data between steps using tool responses
Use
```
RUBE_REMOTE_WORKBENCH
```
for bulk operations or data processing

对于涉及多个Zoho Bigin操作的复杂工作流：

使用特定用例调用
```
RUBE_SEARCH_TOOLS
```
，搜索所有相关工具
先执行前置步骤（例如，先获取数据再更新）
通过工具响应在步骤间传递数据
使用
```
RUBE_REMOTE_WORKBENCH
```
进行批量操作或数据处理

Common Patterns

常见模式

Search Before Action

操作前先搜索

Always search for existing resources before creating new ones to avoid duplicates.

在创建新资源前，请始终先搜索现有资源以避免重复。

Pagination

分页

Many list operations support pagination. Check responses for

next_cursor

page_token

and continue fetching until exhausted.

许多列表操作支持分页。请检查响应中的

next_cursor

或

page_token

，并持续获取数据直到全部加载完成。

Error Handling

错误处理

Check tool responses for errors before proceeding
If a tool fails, verify the connection is still ACTIVE
Re-authenticate via
```
RUBE_MANAGE_CONNECTIONS
```
if connection expired

在继续操作前，请检查工具响应中的错误
如果工具执行失败，请验证连接是否仍处于ACTIVE状态
如果连接过期，请通过
```
RUBE_MANAGE_CONNECTIONS
```
重新认证

Batch Operations

批量操作

For bulk operations, use

RUBE_REMOTE_WORKBENCH

with

run_composio_tool()

in a loop with

ThreadPoolExecutor

for parallel execution.

对于批量操作，使用

RUBE_REMOTE_WORKBENCH

，结合

ThreadPoolExecutor

在循环中调用

run_composio_tool()

以实现并行执行。

Known Pitfalls

已知陷阱

Always search tools first: Tool schemas and available operations may change. Never hardcode tool slugs without first discovering them via
```
RUBE_SEARCH_TOOLS
```
.
Check connection status: Ensure the Zoho Bigin connection is ACTIVE before executing any tools. Expired OAuth tokens require re-authentication.
Respect rate limits: If you receive rate limit errors, reduce request frequency and implement backoff.
Validate schemas: Always pass strictly schema-compliant arguments. Use
```
RUBE_GET_TOOL_SCHEMAS
```
to load full input schemas when
```
schemaRef
```
is returned instead of
```
input_schema
```
.

始终先搜索工具：工具架构和可用操作可能会变化。在未通过
```
RUBE_SEARCH_TOOLS
```
发现工具别名的情况下，切勿硬编码工具别名。
检查连接状态：在执行任何工具前，请确保Zoho Bigin连接处于ACTIVE状态。过期的OAuth令牌需要重新认证。
遵守速率限制：如果收到速率限制错误，请降低请求频率并实现退避机制。
验证架构：请始终传递严格符合架构要求的参数。当返回
```
schemaRef
```
而非
```
input_schema
```
时，请使用
```
RUBE_GET_TOOL_SCHEMAS
```
加载完整的输入架构。

Quick Reference

快速参考

Operation	Approach
Find tools	`RUBE_SEARCH_TOOLS` with Zoho Bigin-specific use case
Connect	`RUBE_MANAGE_CONNECTIONS` with toolkit `zoho_bigin`
Execute	`RUBE_MULTI_EXECUTE_TOOL` with discovered tool slugs
Bulk ops	`RUBE_REMOTE_WORKBENCH` with `run_composio_tool()`
Full schema	`RUBE_GET_TOOL_SCHEMAS` for tools with `schemaRef`

Toolkit docs: composio.dev/toolkits/zoho_bigin

操作	实现方式
查找工具	使用Zoho Bigin特定用例调用 `RUBE_SEARCH_TOOLS`
建立连接	使用工具包 `zoho_bigin` 调用 `RUBE_MANAGE_CONNECTIONS`
执行操作	使用已发现的工具别名调用 `RUBE_MULTI_EXECUTE_TOOL`
批量操作	在 `RUBE_REMOTE_WORKBENCH` 中使用 `run_composio_tool()`
获取完整架构	对带有 `schemaRef` 的工具调用 `RUBE_GET_TOOL_SCHEMAS`

工具包文档：composio.dev/toolkits/zoho_bigin