工具 API
call-actor
从Apify Store调用任何Actor。 工作流程: 1. 使用fetch-actor-details获取Actor的输入模式 2. 根据模式使用正确的输入调用此工具 如果actor名称不是"username/name"格式,请先使用search-actors解析正确的Actor。 对于MCP server Actor: - 使用fetch-actor-details并设置output={ mcpTools: true }来列出可用工具 - 使用格式调用:"actorName:toolName"(例如"apify/actors-mcp-server:fetch-apify-docs") 重要提示: - 通常返回datasetId和输出项预览 - 使用get-actor-output工具和datasetId获取完整结果 - 在可用时使用专门的Actor工具以获得更好的体验 有两种运行Actor的方式: 1. 专门的Actor工具(例如apify--rag-web-browser):这些是预配置的工具,提供更简单直接的体验。 2. 通用call-actor工具(call-actor):在专门的工具不可用或您想动态运行任何Actor时使用此工具。如果您不想添加特定工具或您的客户端不支持动态工具注册,此工具特别有用。 使用说明: - 在可用时始终使用专门的工具(例如apify--rag-web-browser) - 仅在您的Actor没有专门的工具时才使用通用call-actor工具。 - 此工具支持通过`async`参数异步执行: - **当`async: false`或未提供时**(默认):等待完成并立即返回结果和数据集预览。在用户请求数据或结果时使用此选项。 - **当`async: true`时**:启动运行并立即返回runId。仅在用户明确要求在后台运行Actor或不需要立即结果时使用。 示例: - user_input: 使用apify/instagram-scraper获取instagram帖子
调用信息
- 工具标识
- apify-mcp-server.call-actor
- 服务提供方
- Apify
- 平均响应
- 0 ms
- 近 7 天调用
- 0
输入参数
actor必填The name of the Actor to call. Format: "username/name" (e.g., "apify/rag-web-browser"). For MCP server Actors, use format "actorName:toolName" to call a specific tool (e.g., "apify/actors-mcp-server:fetch-apify-docs").
input必填The input JSON to pass to the Actor. Required.
asyncWhen true, starts the run and returns immediately with runId. When false or omitted, behavior depends on the active server mode/tool variant. IMPORTANT: use async=true only when the user explicitly asks to run in the background or does not need immediate results.
previewOutputWhen true (default): includes preview items. When false: metadata only (reduces context). Use when fetching fields via get-actor-output.
callOptionsOptional call options for the Actor run configuration.