Struct InvokeParams 

pub struct InvokeParams {
    pub mcp: Option<String>,
    pub tool: Option<String>,
    pub params: Option<Value>,
    pub resource: Option<String>,
    pub timeout: Option<u64>,
}

Invoke action - MCP integration

Used to call MCP server tools or read MCP resources. Exactly one of tool or resource must be specified.

Examples

Tool call:

invoke:
  mcp: novanet
  tool: novanet_context
  params:
    entity: qr-code
    locale: fr-FR

Resource read:

invoke:
  mcp: novanet
  resource: entity://qr-code/fr-FR

Fields

mcp: Option<String>

MCP server name (must match a key in workflow’s mcp config)

Also accepts server as an alias. Optional for builtin tools (nika:* prefix) which don’t need MCP.

tool: Option<String>

Tool name to call (mutually exclusive with resource)

params: Option<Value>

Parameters to pass to the tool

resource: Option<String>

Resource URI to read (mutually exclusive with tool)

timeout: Option<u64>

Timeout in seconds for tool execution

Overrides the global INVOKE_TASK_DEADLINE (300s) for this task. If not set, falls back to the global default.

Implementations

impl InvokeParams

pub fn is_builtin_tool(&self) -> bool

Returns true if this invoke targets a builtin tool (nika:* prefix).

impl InvokeParams

pub fn validate(&self) -> Result<(), NikaError>

Validate invoke parameters.

Errors

Returns an error string if:

• mcp server name is empty (unless builtin tool with nika:* prefix)
• Both tool and resource are Some (mutually exclusive)
• Both tool and resource are None (one is required)
• tool is Some but empty string
• resource is Some but empty string

pub fn is_tool_call(&self) -> bool

Returns true if this is a tool call (has tool set).

pub fn is_resource_read(&self) -> bool

Returns true if this is a resource read (has resource set).

Trait Implementations

impl Clone for InvokeParams

fn clone(&self) -> InvokeParams

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for InvokeParams

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for InvokeParams

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.