SkillAgent

Runs an agent loop to carry out an assigned task using Markdown skills, selecting and switching skills as needed until complete or blocked. Use SkillAgent when the model should interpret an assigned task and choose among task-specific skills, rather than follow a developer-defined workflow.

Add the agent to an arcgis-assistant-agent component to make it available to the arcgis-assistant.

Configure the agent's guidance, skills, and run-specific context with these properties:

• Set systemPrompt to define the agent's overall role. Optional instructions add further guidance.

• Use skillLoaders to provide Markdown skills. With one skill, its instructions are active from the start. With multiple skills, the model initially sees their names and descriptions and can progressively disclose the relevant skill and its tools to the model. Only that skill's declared tools are made available to the model.

  Each skill file has front matter with a name, description, and optional space-separated allowed-tools, followed by Markdown instructions the agent uses when the skill is active. Other front-matter fields are not supported.

  ---
  name: summarize-layer
  description: Summarizes the fields in a map layer.
  allowed-tools: listLayerFields
  ---
  When asked about a layer's fields, call listLayerFields and summarize the results.

• Use runtimeContextLoader to supply application context for each run.

Tools

Skills can use tools supplied by the SDK or custom tools you define for your application; both are referenced by name in the skill's Markdown allowed-tools metadata.

• Custom tools: Create a custom tool with FunctionTool or provide an existing tool accepted by SkillAgentTool. Declare its name in the skill's allowed-tools metadata and supply it through toolLoaders.
• SDK-provided tools: Add the exact name from the list below to the skill's allowed-tools metadata. The toolLoaders entry is only needed for specifying the location of custom tools. SDK-provided tools are already available and don't need to be specified in the toolLoaders property. They can be directly referenced by name in the skill's Markdown file.

Available SDK-provided tools include:

• Map filtering:
  • clearFilters - Removes feature filters or effects from the map without resetting other map state.
  • resetMap - Resets broader map state.
  • setFeatureEffect - Applies a visual effect to features matching the supplied layer and filter criteria.
• Navigation:
  • goToAddress - Finds an address or place name and navigates the map to its location.
  • goToBookmark - Navigates to the extent of a named map bookmark.
  • goToFeatures - Navigates to the extent of features matching the supplied layer and query.
  • goToFullExtent - Navigates to the full-world extent.
  • goToHomeExtent - Returns the map to its initial web map extent.
  • goToLayer - Navigates to the extent of a matching map layer.
  • goToScale - Sets the map to the requested scale.
  • goToViewpoint - Navigates to a viewpoint specified by location and optional zoom or scale.
  • goToZoom - Sets the map to the requested zoom level.
• Map discovery and context:
  • findRelevantFields - Finds fields relevant to a task within the specified layers. Embeddings must be present on the web map for this tool to be successful.
  • findRelevantLayers - Finds map layers relevant to a task from a concise natural-language query. Embeddings must be present on the web map for this tool to be successful.
  • listLayerFields - Lists the fields and available metadata for a map layer.
  • listSharedResources - Lists resources produced by earlier agent steps, optionally filtered by resource kind. This is important for cross-agent workflows where data from one agent, should be shared with another agent for a separate workflow.
• Feature data:
  • getAttribute - Retrieves an attribute value from a feature matching the supplied criteria.
  • getStatistics - Calculates statistics for matching features, such as aggregates for numeric fields or frequencies for categories.
  • getTopFeatures - Returns the top features ranked by values in existing fields.
  • queryFeatures - Queries matching features and returns their count and, when available, feature attributes.