How do I describe a tool so SuperCosmos uses it well?

{
  "type": "function",
  "function": {
    "name": "lookup_order",
    "description": "Look up an order by its order number. Use when the user asks about an order's status or delivery.",
    "parameters": {
      "type": "object",
      "properties": {
        "order_id": {"type": "string", "description": "Order number like A-12345"}
      },
      "required": ["order_id"]
    }
  }
}

Tips:

• Name it like a function: verb plus noun.
• Describe when to use it, not just what it is.
• Mark fields required and describe formats.
• Keep tools few and distinct; overlapping tools confuse any model.

Good to know#

• Base URL: https://api.gateway.clatterlabs.xyz/v1, with Authorization: Bearer clsk_... and X-Clatter-Account: CL-... on every call. Quick reference
• Keep keys on your server, never in a browser or mobile app. Why
• Every response has an X-Request-Id; log it so a request can be found later. Why log it

Still need help?#

• General support: support@clatterlabs.com or team@clatterlabs.xyz
• Infrastructure questions, or permanent deletion of your data (your whole account or one service): infrastructure@clatterlabs.xyz

We usually reply within the first hour, and always within 24 hours. A full support team is with you.