Think about structured data

[hadley]

Either show some examples of using tools + side-effects, or create top-level method to help.

e.g. https://github.com/anthropics/anthropic-cookbook/blob/main/tool_use/extracting_structured_json.ipynb — basic idea is to define a "print" call and then explicitly request that the model use it. Then you parse the response, either parsing the json or erroring.

[hadley]

Gemini and OpenAI have specific structured data modes, but Claude does not (so you have to (ab)use tool calling).

Gemini schema:

• Basic: STRING, NUMBER, INTEGER, BOOLEAN
• Arrays: ARRAY + minItems, maxItems, + optional items, which define the schema.
• Structs: OBJECT + properties (name: schema) + required

OpenAI schema:

• Basic: String, Number, Boolean, Integer, Enum
• Arrays: Array. Use items to specify item type. Doesn't support min/max items.
• Objects: Object. Specify struct of properties.
• Null (for optional args)