AI assistant
Assistant tools
The complete list of tools that an AI assistant can use in Polly3D, grouped by purpose.
You do not call these tools yourself: your assistant does. This list is useful to know what to ask for. Tool names stay in English in both languages.
Scene and objects#
| Tool | What it does |
|---|---|
get_scene | Reads the scene: objects, ids, names, materials, lights, settings |
list_primitives | Lists the shapes and their parameters |
add_primitive | Adds a primitive (cube, sphere, torus, backdrop…) |
add_shape | Adds a flat extruded shape (rectangle, ellipse, triangle, polygon, star, or a free outline from points) |
add_path / set_path / get_path | Creates, edits and reads a Bézier path or a flat shape (points, handles, trim, profile, extrusion) |
add_drawing | Makes paths or shapes from an SVG, SVG path data or an After Effects createPath expression |
add_light | Adds a directional, point, spot or ambient light |
add_group | Creates a group |
add_text | Adds a 3D text fed by one of the ten Custom Text channels |
set_object | Changes name, position, rotation, scale, visibility, parent group, Aux channel, anchor… |
delete_objects, duplicate_object, select_objects | Basic editing and selection |
import_model | Imports an OBJ, glTF/GLB or FBX |
undo, redo | Steps back or forward |
batch | Runs many scene tools in one call and one undo step; "$2" stands for the object that step 2 created |
(any set_object, set_material, set_layer, add_layer) with ids | Acts on a list of objects in one go |
list_scenes, new_scene, open_scene, switch_scene, save_scene, close_scene | The scene tabs: the other tools act on the active scene |
Materials#
| Tool | What it does |
|---|---|
list_layer_types | Lists the layer types and every setting, with its range |
get_material | Reads a material's stack |
add_layer, set_layer, remove_layer, move_layer, duplicate_layer | Edit the stack |
set_layer_image | Puts an image in a Texture or Matcap layer |
set_material | A shortcut: color, roughness, metalness, emission, glass, gradient, visibility |
create_material, assign_material | Make a shared material and assign it |
list_material_presets, apply_material_preset | Browse and apply the library |
Cloner and animation#
| Tool | What it does |
|---|---|
list_cloner_options, get_cloner, set_cloner | The Cloner and its patterns |
add_effector, set_effector, remove_effector | Random, Noise, Step and Spline effectors |
set_keyframes, clear_keyframes, get_animation | Keyframes on position, rotation, scale |
set_time, get_time | The editor playhead |
Links to After Effects and drivers#
| Tool | What it does |
|---|---|
get_links | Lists the Connector links and drivers of an object or the scene |
set_link | Links a number to a Connector (1–16) and/or a driver (sine, pingpong, loop, wiggle, keys). Scopes: a material layer, the Cloner or an effector, a primitive's parameter |
Mood, rendering and the viewport#
| Tool | What it does |
|---|---|
list_settings, set_settings | Background, ambient, sky, occlusion, fog, bloom, depth of field, vignette, chromatic aberration, color, quality, timeline |
set_background | A background color, or transparent |
list_skies, set_sky | The library's HDRI skies |
generate_texture | Draws a picture procedurally (no AI, local): water ripples with their normal map, gradients, seamless noise, chrome matcaps |
generate_image | Draws a picture from a text prompt with an AI model (FLUX.2 [pro]) and puts it on a material (texture, with an optional relief) or on the sky. Needs your own key (MCP Settings > Image generation, kept in the macOS Keychain) and is billed by the image service; borders are repaired so the texture repeats without a seam |
save_material_to_library | Keeps an object's material in the library (My materials) |
render_preview | Renders the scene (a view, a free camera, a moment of the animation) so the assistant can see it; draft gives a small quick picture |
check_scene | Looks for what usually goes wrong: no light, metal with nothing to reflect, texture without picture, depth of field that blurs everything |
set_focus | Aims the depth of field at an object, for the camera (the raw value is not a distance) |
set_view | Moves the user's viewport camera |
Reference pictures#
| Tool | What it does |
|---|---|
extract_palette | Measures a picture: palette, brightness, contrast, saturation, warmth, light grid |
compare_to_reference | Renders and compares to a reference, with numbers and hints; also sharpness (soft focus) and, with regions, the same numbers for parts of the picture |
Guide#
| Tool | What it does |
|---|---|
get_guide | Built-in documentation for the assistant, by topic: overview, materials, glass, recipes, lighting, cloner, animation, references, composition, after_effects |
Not exposed#
- Saving the scene (deliberate: saving refreshes After Effects);
- After Effects text links, and the links of Paths and of legacy materials;
- Anything on the After Effects side.