Tool calling
Function tools, tool_choice and the tool loop.
- Can SuperCosmos call several tools at once?A reply can contain more than one tool call. Run each and send one tool message per tool_call_id.FAQ
- Can text inside a tool result trick SuperCosmos?SuperCosmos 1.1 is built to ignore instructions hidden in tool results, and passed the tool-result injection case in Benchmark 2.FAQ
- Does SuperCosmos run my tools by itself?No. On the Model API the model only asks; your code decides whether and how to run each tool.FAQ
- How do I describe a tool so SuperCosmos uses it well?Give a clear name, a one-sentence description of when to use it, and a strict JSON schema with required fields.How-to
- How do I get guaranteed-shape JSON using a tool?Define a tool whose parameters are your schema and force it with tool_choice; read function.arguments.How-to
- How do I send a tool's result back?Append the assistant message with tool_calls, then a tool message with tool_call_id and the result as a string.How-to
- How do I stop a tool loop from running forever?Cap the number of rounds in your code, detect repeated identical calls, and return a final message when you hit the cap.How-to
- How many tools can I send in one request?Up to 64 function tools per request.FAQ
- The model called my tool with wrong arguments. What can I do?Tighten the schema and description, validate arguments in your code and return a clear error so the model can retry.Troubleshooting
- What does tool_choice do?auto lets the model decide, none forbids tools, required forces some tool, and a named function forces that one.Reference
- What if my tool takes a long time to finish?The model waits for your next request, so take as long as needed; send the tool result when it's ready.FAQ
- What is tool calling?Tool calling lets SuperCosmos ask your code to run a function (search, look up data, take an action) and use the result.Explainer
- Which effort is best for tool-calling agents?Flash for fast loops with many short steps; Max when steps need planning; Heavy for rare hard cases.FAQ
Still need help?
Tried the steps above and still stuck? Email us. We usually reply within the first hour, and always within 24 hours. A full support team is with you.
Infrastructure questions, or permanent deletion of your data
infrastructure@clatterlabs.xyzFor deleting your whole account or the data of one service.