businesslogic

BusinessLogic

BusinessLogic 是一个无代码平台，帮助业务用户自动化复杂的工作流和决策流程。业务分析师和运营团队可使用它构建和部署基于规则的应用程序，无需编写代码。这有助于他们简化运营流程并提高效率。

官方文档：https://www.businesslogic.com/developers/

BusinessLogic 概览

• BusinessLogic
  • Customer
  • Invoice
  • Product
  • Estimate
  • Vendor
  • Bill
  • Payment
  • CreditNote
  • PurchaseOrder
  • SalesOrder
  • Expense
  • Employee
  • TimeEntry
  • Project
  • Task
  • Account
  • JournalEntry
  • Transfer
  • TaxRate
  • TaxAgency
  • Currency
  • Unit
  • Category
  • Department
  • Location
  • PriceList
  • Discount
  • Term
  • RecurringInvoice
  • RecurringBill
  • CustomField
  • Attachment
  • Comment
  • Activity
  • Dashboard
  • Report
  • Setting
  • User
  • Role
  • Permission
  • Workflow
  • Notification
  • Template
  • Integration
  • Subscription
  • Transaction
  • Batch
  • Sync
  • Backup
  • Restore
  • Import
  • Export
  • Print
  • Email
  • SMS
  • Chat
  • Approval
  • Signature
  • AuditLog
  • Search
  • Filter
  • Sort
  • Group
  • Pivot
  • Map
  • Calendar
  • Gantt
  • Kanban
  • Form
  • Survey
  • Quiz
  • Poll
  • Event
  • Campaign
  • Goal
  • Alert
  • Reminder
  • Note
  • File
  • Image
  • Video
  • Audio
  • Document
  • Spreadsheet
  • Presentation
  • Archive
  • Link
  • Bookmark
  • Contact
  • Address
  • Phone
  • EmailAddress
  • Website
  • SocialMedia
  • Relationship
  • Tag
  • Flag
  • Status
  • Priority
  • Risk
  • Issue
  • ChangeRequest
  • Decision
  • KnowledgeBase
  • Forum
  • Blog
  • Wiki
  • Help
  • SupportTicket
  • Feedback
  • Review
  • Rating
  • Vote
  • Comment
  • Question
  • Answer
  • Suggestion
  • Idea
  • Innovation
  • Experiment
  • Test
  • Bug
  • FeatureRequest
  • Roadmap
  • Release
  • Version
  • Build
  • Deploy
  • Monitor
  • Log
  • Error
  • Warning
  • Info
  • Debug
  • Trace
  • Exception
  • Crash
  • Performance
  • Security
  • Compliance
  • Privacy
  • Accessibility
  • Usability
  • Quality
  • Cost
  • Time
  • Resource
  • Budget
  • Forecast
  • Variance
  • Trend
  • Pattern
  • Anomaly
  • Insight
  • Prediction
  • Recommendation
  • Analysis
  • Report
  • Visualization
  • Dashboard
  • KPI
  • Metric
  • Measure
  • Dimension
  • Fact
  • Data
  • Information
  • Knowledge
  • Wisdom
  • Truth
  • Lie
  • Fiction
  • Reality
  • Dream
  • Nightmare
  • Hope
  • Fear
  • Love
  • Hate
  • Joy
  • Sadness
  • Anger
  • Surprise
  • Disgust
  • Trust
  • Anticipation
  • Faith
  • Doubt
  • Certainty
  • Uncertainty
  • Possibility
  • Probability
  • Necessity
  • Contingency
  • Opportunity
  • Threat
  • Strength
  • Weakness
  • Success
  • Failure
  • Win
  • Lose
  • Victory
  • Defeat
  • Life
  • Death
  • Beginning
  • End
  • Past
  • Present
  • Future
  • Eternity
  • Infinity
  • Zero
  • One
  • Two
  • Three
  • Four
  • Five
  • Six
  • Seven
  • Eight
  • Nine
  • Ten
  • Hundred
  • Thousand
  • Million
  • Billion
  • Trillion
  • Number
  • Quantity
  • Amount
  • Value
  • Price
  • Cost
  • Revenue
  • Profit
  • Loss
  • Equity
  • Liability
  • Asset
  • Cash
  • Bank
  • Card
  • Check
  • Invoice
  • Bill
  • Payment
  • CreditNote
  • Refund
  • Discount
  • Tax
  • Shipping
  • Handling
  • Insurance
  • Warranty
  • Service
  • Product
  • Material
  • Labor
  • Equipment
  • Software
  • Hardware
  • Network
  • Server
  • Database
  • API
  • SDK
  • Library
  • Framework
  • Platform
  • Cloud
  • Mobile
  • Web
  • Desktop
  • Enterprise
  • Consumer
  • Education
  • Government
  • Healthcare
  • Finance
  • Retail
  • Manufacturing
  • Transportation
  • Energy
  • Agriculture
  • Construction
  • RealEstate
  • Media
  • Entertainment
  • Sports
  • Travel
  • Tourism
  • Hospitality
  • Restaurant
  • Food
  • Drink
  • Clothing
  • Shoes
  • Jewelry
  • Cosmetics
  • Furniture
  • Home
  • Garden
  • Pet
  • Book
  • Movie
  • Music
  • Game
  • Art
  • Design
  • Photography
  • Video
  • Audio
  • Text
  • Image
  • Document
  • Spreadsheet
  • Presentation
  • Archive
  • Code
  • Script
  • Program
  • Application
  • System
  • Process
  • Thread
  • Memory
  • CPU
  • Disk
  • Network
  • Security
  • Privacy
  • Accessibility
  • Usability
  • Performance
  • Scalability
  • Reliability
  • Availability
  • Maintainability
  • Testability
  • Deployability
  • Supportability
  • Learnability
  • Understandability
  • Memorability
  • Satisfaction
  • Delight
  • Engagement
  • Retention
  • Loyalty
  • Advocacy
  • Referral
  • WordOfMouth
  • Marketing
  • Sales
  • Service
  • Support
  • Training
  • Consulting
  • Research
  • Development
  • Engineering
  • Management
  • Leadership
  • Strategy
  • Planning
  • Execution
  • Control
  • Improvement
  • Innovation
  • Transformation
  • Culture
  • Values
  • Mission
  • Vision
  • Purpose
  • Meaning
  • Happiness
  • Wellbeing
  • Success
  • Achievement
  • Contribution
  • Impact
  • Legacy
  • World
  • Universe
  • Everything
  • Nothing

根据需要使用操作名称和参数。

使用 BusinessLogic

此技能使用 Membrane CLI 与 BusinessLogic 交互。Membrane 会自动处理身份验证和凭据刷新，因此你可以专注于集成逻辑，而不必操心身份验证相关的底层工作。

安装 CLI

安装 Membrane CLI，以便在终端中运行 membrane：

npm install -g @membranehq/cli@latest

身份验证

membrane login --tenant --clientName=<agentType>

根据是否支持交互模式，此命令会打开浏览器进行身份验证，或在控制台中打印授权 URL。

无头环境： 此命令会打印授权 URL。请让用户在浏览器中打开该链接。用户完成登录后会看到一个代码，请使用以下命令完成操作：

membrane login complete <code>

在任何命令中添加 --json，即可输出机器可读的 JSON。

Agent 类型：claude、openclaw、codex、warp、windsurf 等。它们将用于调整工具，以便更好地适配你的运行环境

连接到 BusinessLogic

使用 membrane connection ensure 按应用 URL 或域名查找或创建连接：

membrane connection ensure "https://www.businesslogic.online/" --json

用户在浏览器中完成身份验证。输出中包含新连接 ID。

这是建立连接最快的方式。URL 会规范化为域名，并与已知应用进行匹配。如果找不到应用，系统会创建一个应用并自动构建连接器。

如果返回的连接具有 state: "READY"，请跳至 步骤 2。

1b. 等待连接就绪

如果连接处于 BUILDING 状态，请轮询，直到连接就绪：

npx @membranehq/cli connection get <id> --wait --json

--wait 标志会进行长轮询（最长等待 --timeout 秒，默认值为 30），直到状态发生变化。持续轮询，直到 state 不再是 BUILDING。

当前状态会指示接下来需要执行的操作：

• READY — 连接已完成设置。跳至 步骤 2。

• CLIENT_ACTION_REQUIRED — 用户或 Agent 需要执行某项操作。clientAction 对象会说明所需操作：

  • clientAction.type — 所需操作的类型：
    • "connect" — 用户需要进行身份验证（OAuth、API 密钥等）。这包括初次身份验证，以及已断开连接的连接重新进行身份验证。
    • "provide-input" — 需要更多信息（例如要连接的应用）。
  • clientAction.description — 对所需操作的易读说明。
  • clientAction.uiUrl（可选）— 用户可在其中完成操作的预构建界面 URL。如有此字段，请向用户展示。
  • clientAction.agentInstructions（可选）— AI Agent 如何以编程方式继续操作的说明。

  用户完成操作（例如在浏览器中进行身份验证）后，再次运行 membrane connection get <id> --json 进行轮询，检查状态是否已变为 READY。

• CONFIGURATION_ERROR 或 SETUP_FAILED — 出现了问题。请查看 error 字段了解详情。

搜索操作

使用自然语言描述你要执行的操作进行搜索：

membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json

始终应在特定连接的上下文中搜索操作。

每个结果都包含 id、name、description、inputSchema（操作接受的参数）和 outputSchema（操作返回的内容）。

常用操作

名称	键	描述
描述服务	describe-service	获取 BusinessLogic 服务输入和输出参数的 JSON 架构。
执行业务逻辑	execute-business-logic	使用输入参数执行业务逻辑，以从已上传的 Excel 文档中获取计算结果

运行操作

membrane action run <actionId> --connectionId=CONNECTION_ID --json

传递 JSON 参数：

membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json

结果位于响应的 output 字段中。

代理请求

如果现有操作无法满足你的使用场景，可以通过 Membrane 的代理直接向 BusinessLogic API 发送请求。Membrane 会自动将基础 URL 添加到你提供的路径中，并注入正确的身份验证标头；如果凭据过期，还会透明地刷新凭据。

membrane request CONNECTION_ID /path/to/endpoint

常用选项：

标志	说明
-X, --method	HTTP 方法（GET、POST、PUT、PATCH、DELETE）。默认为 GET
-H, --header	添加请求标头（可重复），例如 -H "Accept: application/json"
-d, --data	请求正文（字符串）
--json	发送 JSON 正文并设置 Content-Type: application/json 的简写选项
--rawData	原样发送正文，不进行任何处理
--query	查询字符串参数（可重复），例如 --query "limit=10"
--pathParam	路径参数（可重复），例如 --pathParam "id=123"

最佳实践

• 始终优先使用 Membrane 与外部应用通信 — Membrane 提供预构建操作，并内置身份验证、分页和错误处理。这能减少令牌消耗，并使通信更加安全
• 先发现，再构建 — 运行 membrane action list --intent=QUERY（将 QUERY 替换为你的意图），在编写自定义 API 调用之前查找现有操作。预构建操作可以处理原始 API 调用容易遗漏的分页、字段映射和边缘情况。
• 让 Membrane 管理凭据 — 切勿向用户索要 API 密钥或令牌。请改为创建连接；Membrane 会在服务器端管理完整的身份验证生命周期，无需在本地保存密钥。