Skip to main content

Tools

Tools are the API actions the AI agent can use.

Why Tool Review Matters​

The AI agent can only call enabled tools. Reviewing tools lets you decide what the AI agent is allowed to do.

Disable tools that are:

  • Internal-only.
  • Unsafe for end users.
  • Too broad.
  • Poorly described.
  • Not needed for the integration experience.

Review Tool Names​

Tool names should be understandable. A good tool name makes the action clear.

Examples:

  • search_products
  • get_order_status
  • create_support_ticket

Avoid names that are vague or internal.

Review Tool Descriptions​

Descriptions should tell the AI agent when to use the tool.

Good description:

Use this when a customer asks for the shipping status of an existing order.

Weak description:

Gets data.

Review Arguments​

Each argument should explain what value is required.

Examples:

  • order_id: The customer-visible order number.
  • email: The email address associated with the account.
  • product_id: The product identifier returned by product search.

Test Before Publishing​

Before attaching tools to an integration:

  1. Run a test question in the dashboard.
  2. Confirm the AI agent chooses the right tool.
  3. Confirm the API result is correct.
  4. Confirm the answer shown to the user is safe.

Safe Publishing Checklist​

  • Only required tools are enabled.
  • Destructive tools are disabled or carefully controlled.
  • Tool descriptions are specific.
  • Arguments are clear.
  • API auth works.
  • The integration's system instructions explain any limits.