获取 Workflow Tool Catalog

GET

/api/app/{app_slug}/workflow/tool-catalog/

curl --request GET \
  --url https://api.agentaab.com/api/app/example/workflow/tool-catalog/ \
  --header 'Authorization: Bearer <token>'

返回已认证创作者可用于此 Workflow 的内置及 Connection 支持的 Tool 操作。条目是公开安全的执行模板，绝不包含凭据值。

授权

• creatorBearerAuth
• creatorSessionCookieAuth

参数

路径参数

app_slug

必填

string

响应

200

当前脱敏后的 Workflow Tool Catalog。

媒体类型application/json

object

catalog

必填

Array<object>

一个可执行 Workflow Tool 操作的不可变公开安全模板。

object

id

必填

string

revision

必填

integer

>= 1

name

必填

string

description

必填

string

category

必填

string

允许的值： built_in connected mcp

tags

必填

Array<string>

featured

必填

boolean

execution

必填

object

endpoint

必填

物化到 v1 Tool 绑定中的准确 HTTPS 执行 Endpoint。

string format: uri

tool_name

必填

string

credential_ref

服务端管理的引用，不是凭据值。

string

/^WORKSPACE_CONNECTION_[A-F0-9]{32}$/

credential_mode

string

允许的值： bearer x_api_key

input_schema

必填

用于生成 Inspector 控件的有界 Object 根 JSON Schema。

object

key

附加属性

any

defaults

必填

object

key

附加属性

any

connection

必填

object

required

必填

boolean

provider

string

允许的值： web_search mcp

status

必填

string

允许的值： ready missing attention

risk

必填

object

level

必填

string

允许的值： deterministic network external

preview_confirmation

必填

boolean

示例

{
  "catalog": [
    {
      "category": "built_in",
      "execution": {
        "credential_mode": "bearer"
      },
      "connection": {
        "provider": "web_search",
        "status": "ready"
      },
      "risk": {
        "level": "deterministic"
      }
    }
  ]
}

401

创作者 Session 缺失、无效、已过期，或没有经过验证的电子邮件。

媒体类型application/json

object

error

必填

string

code

必填

string

允许的值： creator_session_required creator_email_unverified creator_session_invalid creator_session_expired

示例

{
  "code": "creator_session_required"
}

403

Agent Business 的公开 Runtime 凭据不能访问创作者控制面 API。

媒体类型application/json

object

error

必填

string

code

必填

string

允许的值： runtime_token_not_allowed

示例

{
  "code": "runtime_token_not_allowed"
}

404

Workflow 不存在或不可访问。

媒体类型application/json

object

error

必填

string

code

必填

string

允许的值： application_unavailable

示例

{
  "code": "application_unavailable"
}

409

Agent Business 不是 Workflow，或创作者身份与现有绑定冲突。

媒体类型application/json

One of:

object

object

error

必填

string

code

必填

string

允许的值： application_not_workflow

object

object

error

必填

string

code

必填

string

允许的值： creator_identity_conflict

示例

{
  "code": "application_not_workflow"
}

500

返回前已清理意外的 Workspace Connection 故障。

媒体类型application/json

object

error

必填

string

code

必填

string

允许的值： workspace_connection_failed

示例

{
  "code": "workspace_connection_failed"
}

502

配置的创作者身份服务在验证 Session 时失败。

媒体类型application/json

object

error

必填

string

code

必填

string

允许的值： creator_session_verification_failed

示例

{
  "code": "creator_session_verification_failed"
}

503

创作者认证、控制面存储或权威 Connection 存储不可用。

媒体类型application/json

One of:

object

object

error

必填

string

code

必填

string

允许的值： creator_auth_provider_invalid creator_session_not_configured creator_control_storage_not_configured

object

object

error

必填

string

code

必填

string

允许的值： workspace_connection_encryption_unavailable workspace_connection_decryption_failed workspace_connection_store_unavailable workspace_connection_mutations_disabled workspace_connection_test_state_unavailable

示例

{
  "code": "creator_auth_provider_invalid"
}