AI Agent

Updated in 2026.20.0

Description

As of Cognigy 2026.18.0, the Maximum Completion Tokens and Temperature parameters are deprecated. The removal is planned for April 2027. For models that don’t support these parameters, activate the Ignore deprecated parameters toggle to exclude them from the request to the LLM provider. Otherwise, the request to the LLM provider might fail. If you plan to use these parameters, migrate them to the Custom Options section and activate the Ignore deprecated parameters toggle. Otherwise, Custom Options might not override them for every provider and model combination.For example, OpenAI models such as gpt-5, gpt-5.1, and gpt-5.2 don’t support these parameters. Similar models from other LLM providers might also not support these parameters. Check your LLM provider’s documentation for model-specific support.

The AI Agent Node assigns a job to an AI Agent, provides instructions and tools for that job, and access to the knowledge the AI Agent can use when holding a conversation with a user. To configure this Node, follow these steps:

Define an AI Agent job.
Define the tool actions to perform this task.

In comparison to the LLM Prompt Node, the AI Agent Node includes the AI Agent persona in the prompt. If you want a more direct approach to control the prompt from the Node editor, use the LLM Prompt Node.

Limitations

By default, the number of transcript turns is set to 50. In the AI Agent Node, this number is fixed and can’t be adjusted, unlike in the LLM Prompt and Get Transcript Nodes, where customization is possible.

The Description and Enum fields in the Parameters section of an AI Agent tool don’t support CognigyScript.

Parameters

Parent Node

This configuration assigns a job to an AI Agent, defines its role and responsibilities, and provides additional instructions or context to guide its actions.

AI Agent

Parameter	Type	Description
AI Agent	List	Select the AI Agent.
Job Name	CognigyScript	Specify the name of the job. For example, `Customer Support Specialist`.
Job Description	CognigyScript	Provide a description of the job responsibilities to guide the AI Agent’s interactions. For example, `Assist customers with product issues, escalate complex cases, and provide guidance on best practices`.
Instructions and Context	Toggle	Add specific instructions or context as a system message to help the AI Agent better fulfill the job requirements. For example, `Stay professional and friendly; focus on problem-solving and clarity`. These instructions are considered in addition to those specified in the AI Agent creation settings.

Memory Handling

Parameter	Type	Description
Long-Term Memory Injection	List	Allow the AI Agent to access Contact Profile information for the current user. Select one of the following options: None – no memory. Inherit from AI Agent – use the settings specified in the AI Agent creation settings. Inject full Contact Profile – use all information from the Contact Profile. Inject Contact Memories only – use information only from the Memories field in the Contact Profile. Inject selected Profile fields – use information from specific fields in the Contact Profile.
Selected Profile Fields	Text	This parameter appears when the Inject selected Profile fields option is enabled. Enter specific fields from the Contact Profile for targeted data use. Specify the field using the Profile keys format and press `Enter` to apply it.
Short-Term Memory Injection	CognigyScript	Specify a static string or a dynamic value via CognigyScript to make available to the AI Agent in the current turn.

Grounding Knowledge

Parameter	Type	Description
Knowledge Injection	List	Use the Knowledge AI feature for the AI Agent. Select one of the following options: Never — don’t use the Knowledge Stores. When Required — let the AI Agent decide when querying the Knowledge Stores is required to help the user. Once for Each User Input — query the Knowledge Stores after each user input. Note that executing a query on every user input can lead to increased costs and latency.
Use AI Agent Knowledge	Toggle	Appears when you select When Required or Once for Each User Input. Enable to use the Knowledge Store configured in the AI Agent. The Knowledge Store configured within the AI Agent creation settings will be used.
Use Job Knowledge	Toggle	Appears when you select When Required or Once for Each User Input. Enable this option to configure a specific Knowledge Store for this particular job, allowing the AI Agent to access job-specific data or resources.
Job Knowledge Store	List	Appears when you select When Required or Once for Each User Input and Use Job Knowledge is enabled. Select a specific Knowledge Store for this AI Agent’s job.
Top K	Slider	Appears when you select When Required or Once for Each User Input. Specify how many knowledge chunks to return. The default value is 3, and the maximum value is 5. Providing more results gives the AI Agent additional context but may increase noise and token usage.
Source Tags	CognigyScript	Appears when you select When Required or Once for Each User Input. Tags refine the scope of your knowledge search, including only the most relevant sections of the knowledge base to improve accuracy. Before specifying tags, ensure they were provided during the creation of the Knowledge Sources. Add tags by entering each separately and pressing `Enter`. Max 5 tags. When multiple Source Tags are specified, the Search Extract Output Node defaults to the `AND` operator, meaning it only considers Sources that have all specified tags. To change this behavior, adjust the Match Type for Source Tags parameter.
Match Type for Source Tags	Select	Appears when you select When Required or Once for Each User Input. Defines the operator for filtering Knowledge Sources by tags: AND — default; requires all tags to match. Example: filtering by `S-a` and `S-b` only includes Sources with both tags. OR — requires at least one tag to match. Example: filtering by `S-a` or `S-b` includes Sources with either tag.
Generate Search Prompt	Toggle	Appears when you select Once for Each User Input. Enabled by default. Generates a context-aware search prompt before executing the knowledge search. May increase cost and latency. By default, the prompt includes the last 7 conversation turns. This value can’t be changed.

Storage and Streaming Options

Parameter	Type	Description
How to handle the result	List	Determines how to handle the prompt result: Store in Input — stores the result in the Input object. To print the prompt result, use the LLM Prompt Result token or `{{ci.promptResult.result}}` in the Say Node, or activate the Output result immediately option. Store in Context — stores the result in the Context object. To print the prompt result, use `{{cc.promptResult.result}}` in the Say Node or activate the Output result immediately option. Stream to Output — streams the result directly into the output. This means that the model provides outputs directly into the conversation chat as soon as Cognigy matches a Stream Buffer Flush Token, and you don’t need to use the LLM Prompt Result token and Say Node. By default, this result won’t be stored in either the Input or the Context. You can change this behavior by activating the Store Copy in Input option. Streaming might not be supported by all AI Agent Node providers, such as Google¹. If streaming isn’t supported, enabling the Store Copy in Input option saves the result to the Input object.
Input Key to store Result	CognigyScript	This parameter appears when Store in Input is selected or when Stream to Output is selected and Store Copy in Input is activated. Enter a JSON key under which to store the result object in the Input object. The default key is `promptResult`.
Context Key to store Result	CognigyScript	This parameter appears when Store in Context is selected. Enter a JSON key under which to store the result object in the Context object. The default key is `promptResult`.
Stream Buffer Flush Tokens	Text Array	This parameter appears when Stream to Output is selected. Defines tokens that trigger the stream buffer to print the output to the user. The tokens can be punctuation marks or symbols, such as `\n`.
Output result immediately	Toggle	This parameter appears when you select either Store in Input or Store in Context. Outputs prompt results immediately to the user without using the Say Node and LLM Prompt Result token. This parameter is activated by default.
Store Copy in Input	Toggle	This parameter appears when Stream to Output is selected. Stores a copy of the streamed output in the Input object. Enter a JSON key under which to store the result object in the Input Key to store Result field.

Voice

Parameter	Type	Description
Voice Setting	Select	Configure the voice settings for the AI Agent Job. This parameter determines how the AI Agent selects the voice for text-to-speech (TTS) output. Select one of the following options: Inherit from AI Agent — use the voice settings defined in the AI Agent creation settings. Use Job Voice — apply custom voice settings specific to this job, allowing the AI Agent to adapt to the particular role it performs. For example, for a marketing AI Agent, the voice can be engaging, friendly, and persuasive. For customer support, it might be neutral, empathetic, and formal.
TTS Vendor	Dropdown	Select a TTS vendor from the list or add a custom one. Note: The AI Agent Node doesn’t support TTS Labels to distinguish configurations from the same vendor. To use TTS Labels, add a Set Session Config Node before the AI Agent Node in the Flow editor.
Custom (Vendor)	CognigyScript	Appears when Custom is selected in TTS Vendor. Specify the custom TTS Vendor. For preinstalled providers, use lowercase, for example, `microsoft`, `google`, `aws`. For custom providers, use the name defined on the Speech Service page in the Voice Gateway Self-Service Portal.
TTS Language	Dropdown	Define the language of the AI Agent output. Ensure it aligns with the preferred language of the end user.
Custom (Language)	CognigyScript	Appears when Custom is selected in TTS Language. Specify the output language. Format depends on the TTS vendor; check vendor documentation. Typical format: `de-DE`, `fr-FR`, `en-US`.
TTS Voice	Dropdown	Define the voice for AI Agent output. Customize tone, gender, style, and regional specifics to align conversations with your brand and audience.
Custom (Voice)	CognigyScript	Appears when Custom is selected in TTS Voice. Specify a custom voice, often required for region-specific voices. Format depends on TTS Vendor and typically follows `language-region-VoiceName`, for example, `de-DE-ConradNeural`, `en-US-JennyNeural`.
TTS Label	CognigyScript	Alternative name for the TTS vendor, as specified in the Voice Gateway Self-Service Portal. Use this when multiple speech services from the same vendor exist.
Disable TTS Audio Caching	Toggle	Disables TTS audio caching. By default, the setting is deactivated. In this case, previously requested TTS audio results are stored in the AI Agent cache. When a new TTS request is made and the audio text has been previously requested, the AI Agent retrieves the cached result instead of sending another request to the TTS provider. When the setting is activated, the AI Agent caches TTS results but doesn’t use them. In this case, each request is directly sent to your speech provider. Note that disabling caching can increase TTS costs. For detailed information, contact your speech provider.

Tool Settings

Parameter	Type	Description
Tool Choice	List	Determines how the AI Agent selects tools: Auto — the model decides whether to call a tool or return a plain-text response. Use this option for general-purpose AI Agents. For example, a support AI Agent that answers FAQs directly but calls a Knowledge tool when the question needs it. Required — the model must call one of the provided tools on every turn and won’t return a plain-text response. Use this option when the Flow must always pass through a structured tool call. For example, when the tool’s output must be retrieved and included in the response before anything is returned to the user. Selecting this option can cause an infinite tool-calling loop. See Avoiding infinite loops when Tool Choice is Required for mitigation options. None — the model ignores all configured tools and returns only a plain-text response. Use this option to temporarily disable tool use without removing the tool configuration, for example, during testing or debugging. The options in Tool Choice map to the following LLM function-calling modes: Auto — `mode: AUTO` Required — `mode: ANY` None — `mode: NONE` Availability of these modes depends on your LLM provider. Refer to your provider’s documentation to confirm support.
Use Strict mode	Toggle	If supported by the LLM provider, ensures that the arguments passed to a tool call precisely match the expected parameters. Activating this mode can help prevent errors. However, it might cause a slight delay in the response, especially during the first call after making changes.

Image Handling

Parameter	Type	Description
Process Images	Toggle	Allows the AI Agent to read and understand image attachments. Ensure that your LLM supports image processing; refer to your LLM provider’s documentation. In addition, ensure that attachments are supported by and activated in your Endpoint, for example, Webchat.
Images in Transcript	List	Sets how images uploaded before the last turn are handled to reduce token usage. You can select the following options: Minify — reduces the size of these images to 512x512px. Drop — excludes the images. Keep — sends the maximum size. This option consumes more tokens. Limitations and token consumption depend on the LLM used.

Advanced

Parameter	Type	Description
Ignore deprecated parameters	Toggle	Excludes the deprecated Maximum Completion Tokens and Temperature parameters from requests to the LLM provider. Activate this toggle if your model doesn’t support these parameters. If you activate this toggle for a model that supports them, the model uses default values.
LLM	List	Select a model that supports the AI Agent Node feature. The selected Default model is the one specified in Settings > Generative AI Settings of your Project. Choose the model you added earlier while configuring the Agentic AI feature. This model will manage your AI Agent.
AI Agent Base Version	List	Select the base version of the AI Agent to use: Fixed Version — choose a specific version, for example, `1.0`, to ensure stability and avoid potential breaking changes. Use this version in production environments or critical workflows. The version dropdown will be updated as future AI Agent Node versions are released. Latest — use the most recent version of the AI Agent Node. This gives access to the latest features but may require manual updates if breaking changes occur. When upgrading to a fixed version or switching to the latest, always test your AI Agent carefully to ensure compatibility.
Timeout	Number	Sets the maximum number of milliseconds to wait for a response from the LLM provider.
Maximum Completion Tokens	Slider	Set the maximum number of tokens that can be used during a process to manage costs. If the limit is too low, the output may be incomplete. For example, setting 100 tokens roughly corresponds to 100 words, depending on language and tokenization.
Temperature	Slider	Defines the sampling temperature, which ranges between 0 and 1. Higher values, such as 0.8, make the output more random, while lower values, such as 0.2, make it more focused and deterministic.
Include Rich Media Context	Toggle	Controls whether the text from the Textual Description field in Say, Question, and Optional Questions Nodes is added to the AI Agent’s prompt. This text provides AI Agents with additional information, improving their responses. If you have filled in a Textual Description field in other Nodes, this text is added to the prompt as context for rich media, such as Text with Quick Replies. If the Textual Description field is empty, the button titles and alt text from the rich media are added to the prompt. By default, the Include Rich Media Context parameter is active. When this parameter is inactive, nothing related to the rich media is added to the prompt. Examples: If Textual Description is filled in: Textual Description: `Select your preferred delivery option: Standard Delivery or Express Delivery`. Quick Replies buttons: `Standard Delivery`, `Express Delivery`. Context added to the prompt: `Select your preferred delivery option: Standard Delivery or Express Delivery`. If Textual Description is empty: Textual Description: empty. Quick Replies buttons: `Standard Delivery`, `Express Delivery`. Context added to the prompt: `Standard Delivery`, `Express Delivery`. If Include Rich Media Context is inactive: No information related to the rich media is added to the prompt.

Error Handling

Parameter	Type	Description
Log to System Logs	Toggle	Logs errors to the system logs. They can be viewed on the Logs page of your Project. This parameter is inactive by default.
Store in Input	Toggle	Store errors in the Input object.
Select Error Handling Approach	List	Sets how Flow execution behaves if the AI Agent Node throws an error. You can select one of the following options: Stop Flow Execution — terminates the current Flow execution. Continue Flow Execution — allows the Flow to continue executing, bypassing the error and proceeding to the next steps. Go to Node — redirects Flow execution to a specific Node, which can be useful for error recovery or customized error handling.
Select Flow	List	This parameter appears when you select Go to Node in Select Error Handling Approach. Sets the Flow that includes the Node to which you want to redirect Flow execution.
Select Node	List	This parameter appears when Go to Node in Select Error Handling Approach is selected. Sets the Node to which you want to redirect Flow execution.
Error Message (optional)	CognigyScript	This parameter appears when you select Continue Flow Execution in Select Error Handling Approach. Add a message to output if the AI Agent Node fails.

Custom Options

These options let you use parameters that aren’t included in the AI Agent Node or override existing configurations.

Parameter	Type	Description	Example
Custom Options	JSON	Sets custom parameters to the LLM configuration. You can set individual parameters as well as entire functions. These parameters customize the behavior of the model, such as adjusting `temperature`, `top_k`, or `presence_penalty`. This field overrides the parameters set in the AI Agent Node. To view the full list of available parameters for your model, refer to the LLM provider’s API documentation, for example, OpenAI or Azure OpenAI. For Amazon Bedrock and Anthropic models, you must use the `output_config` parameter to customize the JSON structure in the output.	`{ "model": "gpt-4o", "temperature": 0.7, "max_tokens": 4000 }`
Custom Request Options	JSON	Sets parameters to customize the request to the LLM provider. These parameters override the configurations set in this Node. For example, setting a `{ "stream": true }` parameter overrides the Output result immediately option. For more information, refer to the LLM provider’s API documentation.	`{ "stream": true }`, `{ "headers": { "Authorization": "Bearer <token>" } }`

Forcing Model VersionsYou can force the AI Agent Node to use a specific model version by including it in the Custom Options. This means that the AI Agent Node uses the specified version of the language model instead of the default or any other available versions. This gives you more control over the behavior of the AI Agent Node, ensuring it uses a specific model version for generating prompts or responses.You can use any models from LLM providers supported by Cognigy, including those not yet directly integrated. However, you can only replace a model with another from the same provider.Consider an example with Anthropic as the LLM provider:You can force the AI Agent Node to use the model version claude-opus-4-8-20260101, despite the LLM resource defaulting to the claude-sonnet-4-6 model:

Create an Anthropic LLM resource for Claude, for example, claude-sonnet-4-6.
Create a Flow and add an AI Agent Node to it.
In the AI Agent Node, select the model claude-sonnet-4-6 from the Large Language Model list.
In the Custom Options field, add { "model": "claude-opus-4-8-20260101" } to force the use of the claude-opus-4-8-20260101 model.
Click Save Node.

The AI Agent Node then uses the claude-opus-4-8-20260101 model.For more information on supported models, see:

Forcing JSON Output on Amazon Bedrock and AnthropicFor Amazon Bedrock and Anthropic models, add the output_config parameter to the Custom Options field to force the model to return a specific JSON response.For example, to force the model to return JSON matching a specific schema:

{
  "output_config": {
    "format": {
      "type": "json_schema",
      "schema": {
        "type": "object",
        "properties": { "answer": {} },
        "required": ["answer"]
      }
    }
  }
}

With this configuration, a prompt such as “What is 1+1?” returns a response like {"answer": 2} instead of plain text.

Debug Settings

Parameter	Type	Description
Log Job Execution	Toggle	Send a debug message with the current AI Agent Job configuration. The message appears in the Interaction Panel when debug mode is enabled. This parameter is active by default.
Log Knowledge Results	Toggle	Send a debug message containing the result from a knowledge search. The message appears in the Interaction Panel when debug mode is enabled. This parameter is inactive by default.
Show Token Count	Toggle	Sends a debug message containing the input, output, and total token count. The message appears in the Interaction Panel when debug mode is active. Cognigy uses the GPT-3 tokenizer algorithm, so actual token usage may vary depending on the model used. This parameter is inactive by default.
Log System Prompt & Completion	Toggle	Sends a debug message containing the system prompt sent to the LLM provider and the subsequent completion. The message appears in the Interaction Panel when debug mode is active. This parameter is inactive by default.
Log Tool Definitions	Toggle	Sends a debug message containing information about the configured AI Agent tools. The message appears in the Interaction Panel when debug mode is enabled. This parameter is inactive by default.
Log LLM Latency	Toggle	Sends a debug message containing key latency metrics for the request to the model, including the time taken for the first output and the total time to complete the request. The message appears in the Interaction Panel when debug mode is enabled. This parameter is inactive by default.
Send request logs to Webhook	Toggle	Sends the request sent to the LLM provider and the subsequent completion to a webhook service, including metadata, the request body, and custom logging data. With this parameter, you can use a webhook service to view detailed logs of the request to the LLM. This parameter is inactive by default.
Webhook URL	CognigyScript	This parameter appears when you toggle on Send request logs to Webhook. Sets the URL of the webhook service to send the request logs to.
Custom Logging Data	CognigyScript	This parameter appears when you toggle on Send request logs to Webhook. Sets custom data to send with the request to the webhook service.
Condition for Webhook Logging	CognigyScript	This parameter appears when you toggle on Send request logs to Webhook. Sets the condition for the webhook logging.
Webhook Headers	Input fields	Sets the headers to send with the request to the webhook service. You can switch between the graphical and JSON editors to enter the header key and value either in the Key and Value fields or in the code field in JSON format. When using the JSON editor, follow the JSON Schema specification.
Key	Text	Sets the header name. After entering the header key, new empty Key and Value fields are automatically added, in case you need to add more headers.
Value	CognigyScript	Sets the header value.

Child Nodes

Tool

Tools are child Nodes of AI Agent Nodes. They define the actions the AI Agent can take. If an AI Agent wants to execute the tool, the branch below the child Node is executed.

To better guide your AI Agent, use a Resolve Tool Action Node at the end of a tool branch to return to the AI Agent after tool execution.

Clicking the Tool Node lets you define a tool, set its parameters, and enable debugging by turning on detailed messages about the tool’s execution.

Tool

Parameter	Type	Description
Tool ID	CognigyScript	Defines the tool ID. This ID can contain only letters, numbers, underscores (`_`), or dashes (`-`). If you use more than one tool, the tool ID provides context to trigger the correct tool. In this case, enter a clear tool ID for each tool, for example, `update_user-1`.
Description	CognigyScript	Defines instructions to guide the AI Agent to call the tool. The description field provides context to trigger the tool. Enter a detailed description of what the tool does, when it should be used, and what parameters it requires.

Parameters

Configure the parameters that the AI Agent collects before the tool is called. You can switch between the graphical and JSON editors. When using the JSON editor, follow the JSON Schema specification.

Parameter	Type	Description
Use Parameters	Toggle	Displays the Parameters section in the Node editor. In this section, you can define additional parameters for the tool. The AI Agent collects all data it needs and calls a tool with these parameters filled as arguments. This parameter values can be accessed directly in the `input.aiAgent.toolArgs` object.
Name	Text	Sets the name of the parameter. The name must be clear and concise, and describe the purpose of the parameter.
Type	List	Sets the parameter type: String — a sequence of characters. For example, `"hello"`, `"123"`. Number — a numerical value, which can be either an integer, for example,`5`, or a floating point number, for example, `3.14`. Boolean — a logical value representing `true` or `false`. Array — a collection of elements, which can contain multiple values of any type. For example, `["apple", "banana", "cherry"]`. Object — a collection of key-value pairs, where each key is a string and the value can be of any type. For example, `{"name": "John", "age": 30}`.
Description	Text	Describes the parameter’s purpose.
Enum (optional)	Enum	Defines a set of values that the parameter can accept. The enum restricts the input to one of the specified values, ensuring only valid options are chosen. The enum is only available for string-type parameters in the graphical editor. For other types, use the JSON editor. Might not be supported by all LLM providers.
Add Parameter	Button	Adds another parameter.

Debug Settings

Parameter	Type	Description
Debug Message when called	Toggle	Activates the output of a debug message when the tool is called to provide detailed information about the tool call.

Advanced

Parameter	Type	Description
Condition	CognigyScript	Sets a condition that must be evaluated as true to activate the tool. If false, the AI Agent can’t access the tool during execution. For example, when using an `unlock_account` tool, you can enter a condition like `context.accountStatus === "locked"`. With this condition, the AI Agent checks the value of the `context.accountStatus` key in the Context object, and if the key is missing or the value is different from `"locked"`, the AI Agent can’t use the tool.

MCP Tool

An MCP Tool Node is a type of Tool Node that connects to a remote MCP server to load tools that the AI Agent can execute. If an AI Agent wants to execute one of the loaded tools, the branch below the MCP Tool Node is triggered. In the MCP Tool Node, you can define the connection, filter loaded tools, and turn on detailed messages about the tool’s execution for debugging.

MCP Tool

Parameter	Type	Description
Name	CognigyScript	Defines a name for the MCP connection. This name helps you identify the source of the loaded tool.
MCP Server SSE URL	CognigyScript	Defines the URL to an SSE (server-sent events) endpoint from a remote MCP server. Ensure that you connect only to trusted MCP servers.
Timeout	Slider	Sets the timeout for the MCP connection in seconds.

Authentication

Parameter	Type	Description
Authentication Type	List	Sets the authentication type to use for the MCP server connection. Select one of the following options: None — no authentication. This option is used by default. OAuth2 — authenticate using OAuth 2.0, which provides improved security and control compared to API keys. OAuth 2.0 supports scoped permissions, expiring tokens, and reduced exposure through short-lived tokens. If you want to use a different authentication method, such as an API key, you can add it as a custom header in Custom Headers of the Advanced section.
OAuth2 Parameters	List	Opens the dialog to configure OAuth 2.0 authentication. The dialog includes fields that allow the AI Agent to securely request and use access tokens when communicating with the MCP server. Configure the following fields: Connection Name — enter a descriptive name for the connection, for example, `MCP Tool OAuth`. OAuth URL — enter the token endpoint URL exposed by the MCP server, for example: `https://mcp.example.com/oauth2/token`. Client ID — enter the application (client) ID issued by the MCP server. Client Secret — enter the application secret issued by the MCP server. Keep this secret secure. Scope — add a list of scopes that define the permissions required by your application, for example: `read write admin`. Separate multiple scopes with spaces.

Debug Settings

Parameter	Type	Description
Debug Loaded Tools	Toggle	Displays a debug message listing all tools loaded from the MCP server. The debug message also includes tools filtered out in the Advanced section. This parameter shows whether tools were loaded from the cache or directly from the MCP server.
Debug with Parameters	Toggle	Includes the tool parameters in the debug message.
Debug calling Tool	Toggle	Outputs a debug message with detailed information about the tool call each time it is triggered.

Advanced

Parameter	Type	Description
Cache Tools	Toggle	Disables caching of loaded tools during development. Ensure that caching is enabled in production for performance reasons. The caching time is 10 minutes. In debug mode, you can verify whether the cache was used. To do this, make sure Debug Loaded Tools is enabled. For more information, see the Debug Settings section.
Condition	CognigyScript	Sets a condition that must be evaluated as true to activate the MCP tool. If false, the AI Agent can’t access the tool during execution. For example, when using an `unlock_account` tool, you can enter a condition like `context.accountStatus === "locked"`. With this condition, the AI Agent checks the value of the `context.accountStatus` key in the Context object, and if the key is missing or the value is different from `"locked"`, the AI Agent can’t use the tool.
Tool Filter	Select	Excludes tools from execution. You can select one of the following options: None — no tool filtering is applied, and all tools are available for execution. This option is selected by default. Whitelist — only tools on the list are available for execution, while all other tools are excluded. Blacklist — excludes the tools on the list from execution, while all other tools remain available.
Blacklist	CognigyScript	This parameter appears if you select Blacklist in Tool Filter. Defines which tools to block from execution. Enter only one tool per field.
Whitelist	CognigyScript	This parameter appears if you select Whitelist in Tool Filter. Sets the tools you want to allow for execution. Enter only one tool per field.
Custom Headers	Input fields	Sets the headers to send with the request to the MCP server. You can switch between the graphical and JSON editors to enter the header key and value either in the Key and Value fields or in the code field in JSON format.
Key	Text	Sets the header name. After entering the header key, new empty Key and Value fields are automatically added, in case you need to add more headers.
Value	CognigyScript	Sets the header value.

Call MCP Tool

In the Flow editor, when you add an MCP Tool Node, a Call MCP Tool Node is automatically created below it. These two Nodes work together to define and execute the chosen tool. The Call MCP Tool Node sets the actual execution point of the chosen tool. This way, you can verify or modify the tool call arguments in the input.aiAgent.toolArgs object, or add a Say Node before the tool call. When the Call MCP Tool Node is executed, the tool call is sent to the remote MCP server, where the tool is executed remotely with any arguments set by the AI Agent. To return the tool result to the AI Agent, enable Resolve Immediately to send the full result from the remote MCP server to the AI Agent. As an alternative, use a Resolve Tool Action Node to return a specific result to the AI Agent.

Call MCP Tool

Parameter	Type	Description
Resolve Immediately	Toggle	Immediately resolves the tool action with the full result as the tool answer.

Storage Options

Parameter	Type	Description
How to handle the result	Select	Sets how to handle the MCP tool call result: Store in Input — stores the result in the Input object. Store in Context — stores the result in the Context object.
Input Key to store Result	CognigyScript	This parameter appears when Store in Input is selected. The result is stored in the `input.aiAgent.toolResult` object by default. You can specify another value, but the MCP Tool Result Token won’t work if the value is changed.
Context Key to store Result	CognigyScript	This parameter appears when Store in Context is selected. The result is stored in the `context.aiAgent.toolResult` object by default.

Debug Settings

Parameter	Type	Description
Debug Tool Result	Toggle	Outputs a debug message with the tool call result after a successful call.

A2A Agent

A2A Agent Nodes are child Nodes of AI Agent Nodes. An A2A Agent Node allows the AI Agent Node to connect to a remote A2A agent and use it as a single tool. The remote A2A agent can advertise multiple skills, but the AI Agent Node always sees them as a single tool. The skills are summarized in the tool description to help the AI Agent Node decide when to use it. In the A2A Agent Node, configure the A2A agent connection, authentication, skill filtering, and debugging options.

A2A Agent

Parameter	Type	Description
Name	CognigyScript	Defines the name of the A2A Agent connection.
A2A Agent Base URL	CognigyScript	Defines the base URL of the A2A agent. Connect only to trusted A2A agents.
Custom Agent Card Path	CognigyScript	Overrides the default Agent Card discovery path.
Test Connection	Button	Tests the connection and verifies that the remote Agent Card can be retrieved.
Timeout	Slider	Sets the request timeout in seconds when Execution mode is Blocking. Ranges from 1 to 30 seconds. The default value is `12`.
Execution mode	List	Determines how the Node waits for the remote A2A agent: Blocking — waits for the final result. Non-blocking — sends the message and polls the task until it completes or the Task timeout is reached.
Task timeout	Slider	Sets the maximum time in seconds to poll a task when Execution mode is Non-blocking. Ranges from 10 to 300 seconds. The default value is `60`.
Max autonomous calls per turn	Slider	Limits the number of times the AI Agent Node can call this tool autonomously during one turn. Ranges from 1 to 10. The default value is `4`.
Cache Agent Card	Toggle	Caches the remote Agent Card for 10 minutes. This parameter is active by default. When developing, set the parameter to inactive to fetch the Agent Card on every turn.

Authentication

Parameter	Type	Description
Authentication Type	List	Authentication method for requests to the remote A2A agent: None, OAuth2, Bearer Token, Basic Auth, or API Key.
OAuth2 Parameters	Connection	Appears when OAuth2 is selected. Configures the connection used to obtain and cache an access token.
Basic Auth Parameters	Connection	Appears when Basic Auth is selected. Configures the username and password.
Bearer Token	Connection	Appears when Bearer Token is selected. Configures the token sent in the `Authorization` header.
API Key	Connection	Appears when API Key is selected. Configures the API key value.
API Key Header Name	CognigyScript	Appears when API Key is selected. Specifies the header used for the API key. Default: `X-API-Key`.
Use Authentication for Agent Discovery	Toggle	Applies the configured authentication to Agent Card discovery. Inactive by default.

Debug Settings

Parameter	Type	Description
Debug loaded A2A Skills	Toggle	Displays the skills loaded from the remote Agent Card and indicates whether the Agent Card came from the cache. This parameter is active by default.
Debug calling A2A Skill	Toggle	Displays a debug message when the tool is called. This parameter is active by default.

Advanced

Parameter	Type	Description
Condition	CognigyScript	Enables the tool only when the condition evaluates to `true`.
A2A Skill Filter	Select	Controls which remote skills are summarized in the tool description. The A2A Agent Node remains a single tool regardless of the filter. Options: None — includes all skills. Whitelist — includes only the specified skills. Blacklist — excludes the specified skills.
Whitelist	CognigyScript	Appears when Whitelist is selected. Specifies the skill IDs to include.
Blacklist	CognigyScript	Appears when Blacklist is selected. Specifies the skill IDs to exclude.
Custom Headers	-	Adds custom headers to requests sent to the remote A2A agent. Supports CognigyScript values.

The A2A Agent Node covers the following use cases:

Specialist Delegation

Delegate a subtask to a specialist A2A agent, such as an SAP or IT operations agent. The AI Agent Node remains in control of the conversation.

Cross-Company Delegation

Connect to an A2A agent operated by a partner organization for tasks such as booking, procurement, or support.

Call A2A Agent

Cognigy.AI automatically creates a Call A2A Agent Node below an A2A Agent Node. The A2A Agent Node defines the A2A agent connection, while the Call A2A Agent Node executes the call. Use the Call A2A Agent Node to modify or inspect the message before it is sent, add a Say Node, and configure how the result is returned to the AI Agent Node. When the Call A2A Agent Node runs, it sends the message to the remote A2A agent and handles the response according to the configured execution mode. The Agent Card determines the supported A2A protocol version, so no version configuration is required. If the remote A2A agent supports streaming, the Node consumes the response as it arrives. Otherwise, it sends a request. In Non-blocking mode, the Node polls the resulting task until it completes or the task times out. To return the result to the AI Agent Node, enable Resolve Immediately. Alternatively, use a Resolve Tool Action Node to return a specific result. If the remote A2A agent requires additional input or authentication, the AI Agent Node calls the tool again. Max autonomous calls per turn limits how often this can happen.

Call A2A Agent

Parameter	Type	Description
Resolve Immediately	Toggle	Immediately returns the full result to the AI Agent Node as the tool answer. This parameter is active by default.
Progress Message	CognigyScript	Sends an optional status message to the A2A client. The message is sent only to a client connected via an A2A Server Endpoint with streaming enabled. This setting is relevant only when this Cognigy.AI Flow is called via an A2A Server Endpoint. If the parameter is empty, an automatically generated message such as `Delegating to <agent name>...` is shown instead.

Storage Options

Parameter	Type	Description
How to handle the result	Select	Determines where to store the result: Input or Context. Store in Input is selected by default.
Input Key to store Result	CognigyScript	Appears when Store in Input is selected. Stores the result in `input.aiAgent.toolResult` by default.
Context Key to store Result	CognigyScript	Appears when Store in Context is selected. Stores the result in `context.aiAgent.toolResult` by default.

Debug Settings

Parameter	Type	Description
Debug A2A Skill Result	Toggle	Displays a debug message with the result after a successful call. This parameter is inactive by default.
Debug Raw Request	Toggle	Displays the raw JSON-RPC request sent to the A2A agent. This parameter is inactive by default.

Knowledge Tool

The Knowledge Tool Node is a child Node of the AI Agent Node. It lets the AI Agent directly access Knowledge Stores to provide context-aware responses. In the Knowledge Tool Node, you can select the Knowledge Store to search, Source Tags to refine the search, and output detailed debug messages about the tool’s execution.

Knowledge Tool

Parameter	Type	Description
Knowledge Store	List	Sets the Knowledge Store to read information from.
Tool ID	CognigyScript	Defines the tool ID. This ID can contain only letters, numbers, underscores (`_`), or dashes (`-`). If you use more than one Knowledge tool, the tool ID provides context to trigger the correct Knowledge tool. In this case, enter a clear tool ID for each Knowledge tool, for example, `search_appliances`
Description	CognigyScript	Defines instructions to guide the AI Agent to call the Knowledge tool. The description field provides context to trigger the Knowledge tool. If you want to use more than one Knowledge tool, enter clear instructions for the cases when each Knowledge tool should be used. For example, `Find the answer to prompts or questions about appliances by searching the attached data sources. Use this tool when a customer asks about appliance items such as washing machines, dryers, and other household appliances. Focus exclusively on a knowledge search and don't execute tasks like small talk, calculations, or script running.`

Debug Settings

Parameter	Type	Description
Debug Message when called	Toggle	Activates the output of a debug message when the tool is called to provide detailed information about the tool call.

Advanced

Parameter	Type	Description
Top K	Slider	Sets how many Knowledge Chunks to return. The default value is 5, and the maximum value is 10. Providing more results gives the AI Agent additional context, but it also increases noise and token usage.
Store Location	List	Sets whether and where to store the knowledge search results. Select one of the following options: Don’t store — the content isn’t stored. This option is set by default. Input — the content is stored in the Input object. Context — the content is stored in the Context object.
Input Key to store result	CognigyScript	This parameter appears when Store Location is set to Input. The property in the Input object where the result is stored. For example, if you enter `knowledgeSearch`, you can retrieve the knowledge search result from `input.knowledgeSearch`.
Context Key to store result	CognigyScript	This parameter appears when Store Location is set to Context. The property in the Context object where the result is stored. For example, if you enter `knowledgeSearch`, you can retrieve the knowledge search result from `context.knowledgeSearch`.
Source Tags	CognigyScript	Defines Knowledge Source Tags to refine the scope of your knowledge search, including only the most relevant Knowledge Chunks in the Knowledge Store. Before entering the tags, ensure they are included in the Knowledge Sources. Add a tag by entering it in the field and pressing `Enter`. You can add up to 5 Source Tags. When multiple Source Tags are added, the Search Extract Output Node defaults to the `AND` operator, meaning it only considers Sources that have all specified tags. To change this behavior, adjust the Match Type for Source Tags parameter.
Match type for Source Tags	List	The operator to filter Knowledge Sources by Source Tags. Select one of the following options: AND — requires all Source Tags to match across multiple Knowledge Sources. This option is selected by default. Consider the following example: there are Knowledge Sources with Source Tags `S-a`, `S-b`, and `S-c`. When you use the `AND` operator to filter by `S-a` and `S-b`, only Sources with both Tags `S-a` and `S-b` are included in the search results. OR — requires at least one Source Tag to match across multiple Knowledge Sources. Consider the following example: there are Knowledge Sources with Source Tags `S-a`, `S-b`, and `S-c`. When you use the `OR` operator to filter by `S-a` or `S-b`, any Source with either Tag `S-a` or `S-b` is included in the search results.
Condition	CognigyScript	Sets a condition that must be evaluated as true to activate the Knowledge tool. If false, the AI Agent can’t access the tool during execution. For example, when using the Knowledge tool, you can enter a condition like `context.productCategory === "appliances"`. With this condition, the AI Agent checks the value of the `context.productCategory` key in the Context object, and if the key is missing or the value is different from `"appliances"`, the AI Agent can’t use the tool.

Send Email Tool

The Send Email tool lets your AI Agent send emails directly to users. The Send Email tool uses the same configuration and restrictions as the Email Notification Node but adds more flexibility. While the Email Notification Node sends emails at a fixed step in a Flow, the Send Email tool allows the AI Agent to send emails dynamically, based on user input, conversation context, or instructions. This tool makes automation more flexible and minimizes extra Flow steps.

Tool

Parameter	Type	Description
Tool ID	CognigyScript	Defines the tool ID. This ID can contain only letters, numbers, underscores (`_`), or dashes (`-`). The default ID is `send_email`. If you use more than one Send Email tool, the tool ID provides context to trigger the correct Send Email tool. In this case, enter a clear tool ID for each Send Email tool, for example, `send_order_confirmation`.
Description	CognigyScript	Defines instructions to guide the AI Agent to call the Send Email tool. The description field provides context to trigger the Send Email tool. The default description is `Create and send a new email message.`
Recipient TO Email Addresses	CognigyScript	A comma-separated list of email addresses to which the email will be sent.

Debug Settings

Parameter	Type	Description
Debug Message when called	Toggle	Activates the output of a debug message when the tool is called to provide detailed information about the tool call.

Advanced

Parameter	Type	Description
Condition	CognigyScript	Sets a condition that must be evaluated as true to activate the Send Email tool. If false, the AI Agent can’t access the tool during execution. For example, when using the Send Email tool, you can enter a condition like `context.orderFinished === true`. With this condition, the AI Agent checks the value of the `context.orderFinished` key in the Context object, and if the key is missing or the value is different from `true`, the AI Agent can’t use the tool.

Handover to AI Agent Tool

The Handover to AI Agent tool lets you transfer a conversation to another AI Agent in the same or a different Flow. This approach ensures the conversation keeps its context, different AI Agents can handle specific tasks, and multi-step conversations run smoothly across Flows.

Tool

Parameter	Type	Description
Tool ID	CognigyScript	Defines the tool ID. This ID can contain only letters, numbers, underscores (`_`), or dashes (`-`). The default ID is `handover_to_ai_agent`. If you use more than one Handover to AI Agent tool, the tool ID provides context to trigger the correct Handover to AI Agent tool. In this case, enter a clear tool ID for each Handover to AI Agent tool, for example, `handover_to_billing_agent`.
Description	CognigyScript	Defines instructions to guide the AI Agent to call the Handover to AI Agent tool. The description field provides context to trigger the correct receiving AI Agent. If you use more than one Handover to AI Agent tool, enter clear instructions for the cases when each receiving AI Agent should take over. For example, `Handle product recommendations`, `Perform technical troubleshooting`, or `Assist with billing questions`.
Select Flow	List	Sets the target Flow to hand over to. By default, all Flows in the Project are displayed in the list. The selected Flow must contain an AI Agent Node.
Select Node	List	Sets the AI Agent Node to hand over to.

Debug Settings

Parameter	Type	Description
Debug Message when called	Toggle	Activates the output of a debug message when the tool is called to provide detailed information about the tool call.

Advanced

Parameter	Type	Description
Condition	CognigyScript	Sets a condition that must be evaluated as true to activate the Handover to AI Agent tool. If false, the AI Agent can’t access the tool during execution. For example, when using the Handover to AI Agent tool, you can enter a condition like `context.accountStatus === "locked"`. With this condition, the AI Agent checks the value of the `context.accountStatus` key in the Context object, and if the key is missing or the value is different from `"locked"`, the AI Agent can’t use the tool.

Handover to Human Agent Tool

The Handover to Human Agent tool lets you transfer a conversation to a human agent through handover providers. This tool lets your AI Agents refer complex tasks to a human agent if they can’t address the user’s request.

Tool

Parameter	Type	Description
Tool ID	CognigyScript	Defines the tool ID. This ID can contain only letters, numbers, underscores (`_`), or dashes (`-`). The default ID is `handover_to_human_agent`. If you use more than one Handover to Human Agent tool, the tool ID provides context to trigger the correct Handover to Human Agent tool. In this case, enter a clear tool ID for each Handover to Human Agent tool, for example, `handover_to_billing_support`.
Description	CognigyScript	Defines instructions to guide the AI Agent to call the Handover to Human Agent tool. The description field provides context to trigger the handover. Enter clear instructions for the situations when the AI Agent should refer to a human agent. For example, `Use this tool if the user explicitly asks for a human.` or `Use this tool if you fail to answer the user's question three times.`
Handover Provider	List	Sets a handover provider that you previously created in Deploy > Handover Providers. A section with handover provider-specific settings appears. Configure the handover accordingly: Live Agent Chatwoot Salesforce NiCE CXone Genesys Cloud Open Messaging or Genesys Cloud Guest Chat 8x8 RingCentral Engage
Handover Accepted Message	CognigyScript	Defines the message sent to the user when the handover is requested.
Repeat Handover Accepted Message	Toggle	Repeatedly outputs the text in Handover Accepted Message if the user sends a message while waiting in the queue for an agent.

Cancel Handover Options

Parameter	Type	Description
Cancel Intent	CognigyScript	Defines the Intent the user must trigger to cancel the handover request.
Cancel Button Text	CognigyScript	Defines the text for a Quick Reply button that cancels the handover request when clicked.

On Resolve Options

Parameter	Type	Description
Flow Continuation	List	Controls where the Flow continues after the human agent leaves the conversation. When the user needs assistance completing the Flow with the AI Agent, the conversation is handed over to a human agent. The human agent can trigger the Flow by sending a `/bot` command as a reply in the conversation interface. For example, the user enters their date of birth in an incorrect format, and the AI Agent can’t process the response. The conversation is handed over to a human agent, who identifies the incorrect format and sends the corrected date using `/bot MM/DD/YYYY`. The AI Agent takes over and continues the Flow. Below this Node — the Flow continues from the first Node below the Human Agent Node, regardless of where the human agent stopped assisting the user. This option is selected by default. At current AgentInject Entrypoint — the Flow continues from the Node where the human agent stopped assisting the user.
Send resolve event to Virtual Agent	Toggle	Controls whether the Flow receives the `conversation_status_changed` event with the status set to `resolved`. This parameter is activated by default. When the parameter is activated, the event is sent when the human agent leaves the conversation. As a result, the Flow continues immediately, without waiting for the user to send another message. If the Lookup Case Node is configured with Handover Status set to Completed, the Node can detect the completed handover and continue the Flow. When the parameter is deactivated, the event isn’t sent when the human agent leaves the conversation. The Flow continues after the user sends their next message.

Event Settings

Parameter	Type	Description
Send Queue Event	Toggle	Sends an event to the Flow once the handover is queued.
Send Active Event	Toggle	Sends an event to the Flow once the handover is active.

Debug Settings

Parameter	Type	Description
Debug Message when called	Toggle	Activates the output of a debug message when the tool is called to provide detailed information about the tool call.

Advanced

Parameter	Type	Description
Condition	CognigyScript	Sets a condition that must be evaluated as true to activate the Handover to Human Agent tool. If false, the AI Agent can’t access the tool during execution. For example, when using the Handover to Human Agent tool, you can enter a condition like `context.issueType === "complaint"`. With this condition, the AI Agent checks the value of the `context.issueType` key in the Context object, and if the key is missing or the value is different from `"complaint"`, the AI Agent can’t use the tool.

Execute Workflow Tool

The Execute Workflow tool lets the AI Agent execute another Flow. After the target Flow executes, the conversation returns to the AI Agent. The target Flow inherits the Context object from the AI Agent. If the target Flow changes the Context object, these changes are also available to the AI Agent.

Parameter	Type	Description
Tool ID	CognigyScript	Defines the tool ID. This ID can contain only letters, numbers, underscores (`_`), or dashes (`-`). The default ID is `execute_workflow`. If you use more than one Execute Workflow tool, the tool ID provides context to trigger the correct Execute Workflow tool. In this case, enter a clear tool ID for each Execute Workflow tool, for example, `execute_returns_workflow`.
Description	CognigyScript	Defines instructions to guide the AI Agent to call the Execute Workflow tool. The description field provides context to trigger the Execute Workflow tool. Describe when the AI Agent should execute the target Flow. For example, `Use this tool if the user explicitly asks to return a package.`
Target Flow	List	Sets the target Flow that the AI Agent executes when this tool is called. Click to open the target Flow.
Select Node	List	Sets the target Node that the AI Agent executes when the target Flow is called. You must set the Node you want to select as an Entrypoint with the Set Entrypoint setting before you can select it.

Debug Settings

Parameter	Type	Description
Debug Message when called	Toggle	Activates the output of a debug message when the tool is called to provide detailed information about the tool call.

Advanced

Parameter	Type	Description
Parse Intents	Toggle	Sets whether Intents should be parsed in the target Flow. This parameter is activated by default. If this parameter is enabled, Cognigy NLU reparses the Intents in the target Flow based on `text` in the Input object and generates Intent scores using the Intents in the target Flow instead of the ones in the AI Agent’s current Flow.
Parse Slots	Toggle	Sets whether Slots should be parsed in the target Flow. This parameter is activated by default. If this parameter is enabled, Cognigy NLU reparses the Slots in the target Flow based on `text` in the Input object and generates Slot scores using the Slots in the target Flow instead of the ones in the AI Agent’s current Flow.
Absorb Context	Toggle	Sets whether the default Context object of the target Flow is used in the context of the Flow the AI Agent is currently in. If the default Context of the target Flow has a value, it is copied into the Context object of the AI Agent as soon as the target Flow is executed.

Examples

Tool

In this example, the unlock_account tool unlocks a user account by providing the email and specifying the reason for the unlocking. Parameter configuration in JSON:

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "User's login email for their account."
    }
  },
  "required": ["email"],
  "additionalProperties": false
}

where:

type — the type for a tool parameter schema, which must always be object.
properties — defines the parameters for the tool configuration:
- email — a required tool parameter for unlocking the account.
  - type — defines the data type for the tool parameter.
  - description — a brief explanation of what the property represents.
required — lists email as a required parameter, ensuring that this value is always provided when the tool is called.
additionalProperties — ensures that the input contains only the email tool parameter, and no others are allowed.

MCP Tool and Call MCP Tool

Use Zapier’s Remote MCP server

You can create a custom MCP server with personalized tools by using one of the provided SDKs. For a quicker setup, you can use a third-party provider. For example, Zapier allows you to configure your MCP server, which can be connected to multiple application APIs. To use Zapier as a remote MCP server, follow these steps:

Log in to your Zapier account, go to the MCP settings page, and configure your MCP server.
Copy the SSE URL and paste it into the MCP Server SSE URL field of your MCP Tool Node.
In the Zapier MCP settings, create an action to connect to various APIs. For example, you can create a Zapier action to automatically generate a Google Doc.

Once the setup is complete, the configured MCP Actions will be loaded when the AI Agent is executed. You will see the following debug message in the Interaction Panel, indicating the result of the tool call after a successful execution:

AI Agent: MCP Tool
Fetched tools from MCP Tool "zapier"

- google_docs_create_document_from_: Create a new document from text. Also supports limited HTML.
  Parameters:
  - title (string): Document Name
  - file (string): Document Content

Knowledge Tool

In this example, you have two Knowledge tools to search two different Knowledge Stores. Each Knowledge Store refers to a different product category, in this example, appliances and furniture. To guide the AI Agent to use the correct Knowledge tool, enter a clear tool ID and description:

Knowledge Tool 1:
- Tool ID: search_appliances
- Description: Find the answer to prompts or questions about appliances by searching the attached data sources. Use this tool when a customer asks about appliance items such as washing machines, dryers, and other household appliances. Focus exclusively on a knowledge search and does not execute tasks like small talk, calculations, or script running.
Knowledge Tool 2:
- Tool ID: search_furniture
- Description: Find the answer to prompts or questions about furniture by searching the attached data sources. Use this tool when a customer asks about furniture items such as sofas, tables, and other items. Focus exclusively on a knowledge search and does not execute tasks like small talk, calculations, or script running.

Avoiding Infinite Loops when Tool Choice is Required

When Tool Choice is set to Required, the model must call a tool on every turn. After a tool branch executes and a Resolve Tool Action Node returns the result to the AI Agent Node, the model still can’t respond with plain text. Instead, it must call another tool. If every tool branch loops back through a Resolve Tool Action Node, the AI Agent keeps calling tools without ever producing a response. This loop continues until the Flow times out and can consume a large number of tokens.

Avoid setting Tool Choice to Required unless your use case requires the model to always call a tool. If you do use this setting, ensure that at least one tool branch exits the loop without passing through a Resolve Tool Action Node.

To prevent an infinite loop, use one of the following approaches:

Option 1: Change Tool Choice to Auto

Set Tool Choice to Auto unless your use case strictly requires the model to always use a tool. With Auto, the model calls a tool when relevant and returns a plain-text response when the tool isn’t needed, allowing the Flow to exit normally.

Option 2: Add an Exit Tool

Keep Tool Choice set to Required and add a dedicated tool that the model can call to end the loop. This tool branch must not include a Resolve Tool Action Node, so execution doesn’t return to the AI Agent Node. Instead, the branch must end with a Say Node or another output Node that produces the final response.Example exit tool configuration:

Field	Value
Tool ID	`finish_response`
Description	`Call this tool when you have gathered all the information needed and are ready to respond to the user.`

The resulting Flow structure looks like this:

AI Agent Node (Tool Choice: Required)
├── search_knowledge → Resolve Tool Action → [returns to AI Agent Node]
└── finish_response  → Say Node            → [end of Flow, no Resolve Tool Action]

The model calls search_knowledge one or more times to gather information, then calls finish_response to exit the loop and deliver the response.

Get AI Agent Jobs and Tools via API

You can retrieve all job configurations and associated tools for a specific AI Agent via the Cognigy API GET /v2.0/aiagents/{aiAgentId}/jobs request. The response includes each job’s configuration details and a list of available tools.

Overview

AI Agents

Human Escalation

Platform Features

For Developers

Administration and Installation

Description

Limitations

Parameters

Parent Node

Child Nodes

Tool

MCP Tool

Call MCP Tool

A2A Agent

Call A2A Agent

Knowledge Tool

Send Email Tool

Handover to AI Agent Tool

Handover to Human Agent Tool

Execute Workflow Tool

Examples

Tool

MCP Tool and Call MCP Tool

Use Zapier’s Remote MCP server

Knowledge Tool

Avoiding Infinite Loops when Tool Choice is Required

Get AI Agent Jobs and Tools via API

More Information

​Description

​Limitations

​Parameters

​Parent Node

​Child Nodes

​Tool

​MCP Tool

​Call MCP Tool

​A2A Agent

​Call A2A Agent

​Knowledge Tool

​Send Email Tool

​Handover to AI Agent Tool

​Handover to Human Agent Tool

​Execute Workflow Tool

​Examples

​Tool

​MCP Tool and Call MCP Tool

​Use Zapier’s Remote MCP server

​Knowledge Tool

​Avoiding Infinite Loops when Tool Choice is Required

​Get AI Agent Jobs and Tools via API

​More Information

Description

Limitations

Parameters

Parent Node

Child Nodes

Tool

MCP Tool

Call MCP Tool

A2A Agent

Call A2A Agent

Knowledge Tool

Send Email Tool

Handover to AI Agent Tool

Handover to Human Agent Tool

Execute Workflow Tool

Examples

Tool

MCP Tool and Call MCP Tool

Use Zapier’s Remote MCP server

Knowledge Tool

Avoiding Infinite Loops when Tool Choice is Required

Get AI Agent Jobs and Tools via API

More Information