Create Tools for your Agents

Tools perform services for the Agent — each tool pipeline represents a discrete capability, such as reading a database, calling a web service, or performing a calculation, that the Agent pipeline invokes based on the LLM's reasoning. Tool pipelines can be built around any Snap that performs the required operation: an HTTP Client Snap for external web services, or a system-specific Snap — such as a MySQL Snap — for operations against a particular data source. You can create tool pipelines in Designer from scratch or by importing a pattern from the Public Pattern Library.

Tool output requirements

Each tool pipeline must return exactly one output document per invocation. The Agent Snap expects a 1:1 mapping between a tool call and its result document.

Important: If a tool pipeline returns more than one output document, the Agent Snap issues a warning and uses only the first document. The remaining documents are discarded, which may result in data loss.

For pipelines that return multiple records — for example, a Database Query Snap returning multiple rows — add a Gate Snap or similar aggregation logic before the output view to consolidate the records into a single output document.

  • Familiarity with building pipelines in Designer.
  • Feature subscription to AgentCreator.
  1. Select one of the following methods for building your tool:
    To import a prefabricated tool, follow the steps below. To create a tool in a blank Designer canvas, go to step 2.
    1. Navigate to the Public Pattern Library via the Waffle menu.

    2. Click the AgentCreator pill button, then select a pattern that has the tool label.

      Tip: Enter tool in the Search field to narrow the results to only tool pipeline patterns.
      Alternatively, you can click any of the tools listed below. When you are logged into SnapLogic, clicking the link will redirect you to that pattern.
    3. Select the destination Project, and click Use Pattern.

    4. In the next popup, select Open in Designer.


  2. Click to open the Pipeline Properties dialog:
    1. Enter the name of the Tool.
    2. Enable the Tool toggle to tag this pipeline as a tool.
    3. For passing account information to the APIM Function Generator and OpenAPI Function Generator Snaps in the Agent pipeline calling this Tool, enter Account as one of the Pipeline Parameter keys. You can leave the Value field empty.
    Example properties for a Tool pipeline
  3. Test the tool pipeline by validating it.
    When your tool validates successfully, you can test it by running your Agent pipeline to verify that the Agent pipeline calls the tool successfully.

The following video describes how to build a tool pipeline in SnapLogic Designer using AgentCreator Snaps.