Arcpy Script

ArcPy Script

Generate ArcPy code tailored to the user’s active ArcGIS Pro project by using real map/layer context and ArcGIS‑specific constraints. Output should be code-only unless the user explicitly asks for explanations.

Intent

Produce scripts that work on the first run by grounding the prompt in:

• Actual map metadata and spatial reference
• Real layer names, fields, and small sample records
• Visible layer context and optional view extent

Inputs

• task_description (string)
• project_path (string, optional)
• map_name (string, optional)
• layer_names (array, optional)
• selected_only (bool, optional)
• max_features_per_layer (int, optional, default 50)
• simplify_ratio (float, optional, default 0.01)
• include_view_extent (bool, optional)
• include_map_screenshot (bool, optional)
• provider (string, optional: OpenAI, OpenRouter, Azure OpenAI, Claude, DeepSeek, Local LLM)
• model (string, optional)

Context Capture (mirror arcgispro_ai)

Use arcgispro-cli for real project context

If available, call arcgispro-cli to fetch live project details:

• arcgispro layers --json for exact layer names and types
• arcgispro fields "LayerName" for real field schemas
• arcgispro context for full project dump

Prefer actual layer/field names from these outputs over guesses.

When available, build a map_info JSON payload that includes:

• Map metadata: name, title, description, spatial reference, units, rotation, time-enabled
• Layer summaries: visibility, layer type, data source type, extent, spatial reference
• Feature layers: field samples + simplified geometry samples (GeoJSON‑like)
• View extent polygon (optional)
• Active view screenshot (optional, base64 PNG)

Prompt Rules (critical)

• Use arcpy only
• Prefer SelectLayerByAttribute for attribute filters
• If distance/near queries are requested, also use SelectLayerByLocation
• No ORDER BY in selection SQL
• Use active_map.listLayers("LayerName")[0] when zooming
• Use arcpy.AddMessage for user-facing output
• Return only a Python code block (no preamble, no trailing commentary)

Capabilities to Match

• Map/layer metadata extraction
• Visible-layer context sampling with simplified geometries
• Optional view screenshot for vision‑capable models
• Provider/model selection and key resolution
• Field‑level enrichment via AI responses (optional follow‑up tool)

Output

• A single, runnable ArcPy script
• Safe defaults and minimal assumptions
• Handles missing layers or empty selections gracefully

Examples

User: “Select the 3 counties with lowest population density and zoom to them.”

Agent output: Python only, using SelectLayerByAttribute, SearchCursor, and active_view.camera.setExtent(...).

Outputs

Return a concise, usable result with the key artifacts or recommendations.

Safety

Do not invent data, credentials, or system context. Flag uncertainty and risky operations clearly.