Polly3D Documentation Français
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#

ToolWhat it does
get_sceneReads the scene: objects, ids, names, materials, lights, settings
list_primitivesLists the shapes and their parameters
add_primitiveAdds a primitive (cube, sphere, torus, backdrop…)
add_shapeAdds a flat extruded shape (rectangle, ellipse, triangle, polygon, star, or a free outline from points)
add_path / set_path / get_pathCreates, edits and reads a Bézier path or a flat shape (points, handles, trim, profile, extrusion)
add_drawingMakes paths or shapes from an SVG, SVG path data or an After Effects createPath expression
add_lightAdds a directional, point, spot or ambient light
add_groupCreates a group
add_textAdds a 3D text fed by one of the ten Custom Text channels
set_objectChanges name, position, rotation, scale, visibility, parent group, Aux channel, anchor…
delete_objects, duplicate_object, select_objectsBasic editing and selection
import_modelImports an OBJ, glTF/GLB or FBX
undo, redoSteps back or forward
batchRuns 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 idsActs on a list of objects in one go
list_scenes, new_scene, open_scene, switch_scene, save_scene, close_sceneThe scene tabs: the other tools act on the active scene

Materials#

ToolWhat it does
list_layer_typesLists the layer types and every setting, with its range
get_materialReads a material's stack
add_layer, set_layer, remove_layer, move_layer, duplicate_layerEdit the stack
set_layer_imagePuts an image in a Texture or Matcap layer
set_materialA shortcut: color, roughness, metalness, emission, glass, gradient, visibility
create_material, assign_materialMake a shared material and assign it
list_material_presets, apply_material_presetBrowse and apply the library

Cloner and animation#

ToolWhat it does
list_cloner_options, get_cloner, set_clonerThe Cloner and its patterns
add_effector, set_effector, remove_effectorRandom, Noise, Step and Spline effectors
set_keyframes, clear_keyframes, get_animationKeyframes on position, rotation, scale
set_time, get_timeThe editor playhead
ToolWhat it does
get_linksLists the Connector links and drivers of an object or the scene
set_linkLinks 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#

ToolWhat it does
list_settings, set_settingsBackground, ambient, sky, occlusion, fog, bloom, depth of field, vignette, chromatic aberration, color, quality, timeline
set_backgroundA background color, or transparent
list_skies, set_skyThe library's HDRI skies
generate_textureDraws a picture procedurally (no AI, local): water ripples with their normal map, gradients, seamless noise, chrome matcaps
generate_imageDraws 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_libraryKeeps an object's material in the library (My materials)
render_previewRenders 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_sceneLooks for what usually goes wrong: no light, metal with nothing to reflect, texture without picture, depth of field that blurs everything
set_focusAims the depth of field at an object, for the camera (the raw value is not a distance)
set_viewMoves the user's viewport camera

Reference pictures#

ToolWhat it does
extract_paletteMeasures a picture: palette, brightness, contrast, saturation, warmth, light grid
compare_to_referenceRenders 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#

ToolWhat it does
get_guideBuilt-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.
Polly3D Studio documentation