async call(tool_id: str, parameters: Dict[str, Any], search_id: str | None = None, session_id: str | None = None, max_response_size: int | None = None, respond_with: str | None = None, compatibility_mode: Literal['strict', 'legacy_optional_fields'] = 'strict', timeout: float | None = None, correlation_id: str | None = None) → ToolExecutionResponse

Call a specific capability.

• 参数:
  • tool_id -- Tool identifier returned by discover(...).
  • parameters -- JSON-serializable parameters for the tool.
  • search_id -- Search ID returned by discover(...) (recommended for traceability).
  • session_id -- Optional correlation id.
  • max_response_size -- Optional max response size in bytes. Large responses may be truncated.
  • respond_with -- Optional server-side projection (full, summary, or fields:<JSONPath,...>).
  • compatibility_mode -- Strict mode never resubmits a paid call. The deprecated legacy mode may replay once without an unsupported optional field.
  • timeout -- HTTP request timeout in seconds; credential acquisition is separate.
  • correlation_id -- Non-sensitive reference forwarded only to the credential provider.
• 返回: ToolExecutionResponse with success, result, and metadata.