CreateToolInputV2-智能体 AgentRun(AgentRun)-阿里云帮助中心

名称	类型	描述	示例值
	object	创建工具的请求参数。
toolName	string	工具名称，必填，需在工作空间内唯一。	my-mcp-tool
workspaceId	string	工具所属的工作空间标识符，可选项，不填则使用默认工作空间	workspace-xyz789
description	string	工具描述。	这是一个用于处理文档的 MCP 工具
toolType	string	工具的类型，必填项。支持：MCP（Model Context Protocol 工具）、FUNCTIONCALL（函数调用工具）、SKILL（技能工具）	MCP
createMethod	string	工具的创建方式，必填项。支持：MCP_REMOTE（远程 MCP 服务器）、MCP_LOCAL_STDIO（本地 MCP 标准输入输出）、MCP_BUNDLE（MCP 打包部署）、CODE_PACKAGE（代码包部署）、OPENAPI_IMPORT（OpenAPI 导入）	MCP_REMOTE
protocolSpec	string	工具协议规范，JSON 字符串。	{"openapi": "3.0.0"}
mcpConfig	McpConfig	MCP 工具的配置信息，包括会话亲和性、代理配置、绑定配置等，仅在工具类型为 MCP 时需要提供
executionRoleArn	string	工具执行时使用的 RAM 角色 ARN，用于权限控制，格式如：acs:ram::123456789:role/AliyunFCDefaultRole	acs:ram::123456789:role/AliyunFCDefaultRole
artifactType	string	工具部署的制品类型，支持：Code（代码包）、Container（容器镜像）	Code
networkConfiguration	NetworkConfiguration	工具网络配置。
codeConfiguration	CodeConfiguration	代码包类型工具的配置信息，包括代码位置、入口函数、运行时等，仅在制品类型为 Code 时需要提供
containerConfiguration	ContainerConfiguration	容器类型工具的配置信息，包括镜像地址、启动命令、端口映射等，仅在制品类型为 Container 时需要提供
logConfiguration	LogConfiguration	工具日志配置。
ossMountConfig	OSSMountConfig	工具 OSS 挂载配置。
nasConfig	NASConfig	工具 NAS 挂载配置。
cpu	number	工具实例的 CPU 核心数，单位为核，支持小数，如 0.5 表示半核	0.5
memory	integer	工具实例的内存大小，单位为 MB，建议根据工具的实际需求配置	512
port	integer	工具监听端口。	8080
credentialName	string	访问外部服务使用的凭证名称，须预先创建。	my-credential
timeout	integer	工具执行的超时时间，单位为秒，超过此时间工具调用将被终止	300
environmentVariables	object	工具环境变量，键值对形式。	{"ENV": "production", "LOG_LEVEL": "info"}
	string	环境变量	{'MODE_ENV': 'prod'}
agentIdentityEnabled	boolean	是否启用智能体身份能力。
agentIdentityConfig	ToolAgentIdentityConfig	智能体身份配置。

object

创建工具的请求参数。

toolName

string

工具名称，必填，需在工作空间内唯一。

my-mcp-tool

workspaceId

string

工具所属的工作空间标识符，可选项，不填则使用默认工作空间

workspace-xyz789

description

string

工具描述。

这是一个用于处理文档的 MCP 工具

toolType

string

工具的类型，必填项。支持：MCP（Model Context Protocol 工具）、FUNCTIONCALL（函数调用工具）、SKILL（技能工具）

MCP

createMethod

string

工具的创建方式，必填项。支持：MCP_REMOTE（远程 MCP 服务器）、MCP_LOCAL_STDIO（本地 MCP 标准输入输出）、MCP_BUNDLE（MCP 打包部署）、CODE_PACKAGE（代码包部署）、OPENAPI_IMPORT（OpenAPI 导入）

MCP_REMOTE

protocolSpec

string

工具协议规范，JSON 字符串。

{"openapi": "3.0.0"}

mcpConfig

McpConfig

MCP 工具的配置信息，包括会话亲和性、代理配置、绑定配置等，仅在工具类型为 MCP 时需要提供

executionRoleArn

string

工具执行时使用的 RAM 角色 ARN，用于权限控制，格式如：acs:ram::123456789:role/AliyunFCDefaultRole

acs:ram::123456789:role/AliyunFCDefaultRole

artifactType

string

工具部署的制品类型，支持：Code（代码包）、Container（容器镜像）

Code

networkConfiguration

NetworkConfiguration

工具网络配置。

codeConfiguration

CodeConfiguration

代码包类型工具的配置信息，包括代码位置、入口函数、运行时等，仅在制品类型为 Code 时需要提供

containerConfiguration

ContainerConfiguration

容器类型工具的配置信息，包括镜像地址、启动命令、端口映射等，仅在制品类型为 Container 时需要提供

logConfiguration

LogConfiguration

工具日志配置。

ossMountConfig

OSSMountConfig

工具 OSS 挂载配置。

nasConfig

NASConfig

工具 NAS 挂载配置。

cpu

number

工具实例的 CPU 核心数，单位为核，支持小数，如 0.5 表示半核

0.5

memory

integer

工具实例的内存大小，单位为 MB，建议根据工具的实际需求配置

512

port

integer

工具监听端口。

8080

credentialName

string

访问外部服务使用的凭证名称，须预先创建。

my-credential

timeout

integer

工具执行的超时时间，单位为秒，超过此时间工具调用将被终止

300

environmentVariables

object

工具环境变量，键值对形式。

{"ENV": "production", "LOG_LEVEL": "info"}

string

环境变量

{'MODE_ENV': 'prod'}

agentIdentityEnabled

boolean

是否启用智能体身份能力。

agentIdentityConfig

ToolAgentIdentityConfig

智能体身份配置。