Skip to content

FieldTwin Intelligence Tools Capabilities

Getting data

Get Account data

Tools available

  • getAccountAssets
  • getAccountAssetsCetegories
  • getAccountConnections
  • getAccountConnectionCategories
  • getAccountConnectionDesignTypes
  • getAccountWells
  • getAccountShapes
  • getAccountShapeTypes
  • getAccountLayers
  • getAccountLayerTypes
  • getAccountMetadata

Description
Get account level access to types and category groupings used for modeling assets, connections, wells, shapes, layers, and metadata within the FieldTwin environment.

Example Prompts

  • Get account asset definitions for physical equipment (manifolds, PLETs, wellheads, pumps, etc.) searchable by ID or name.
  • Get all asset categories defined at the account level for grouping and filtering asset types.
  • Get account connection definitions for linkages such as pipelines, umbilicals, and cables searchable by ID or name.
  • Get all connection categories defined in the account for classifying connection types.
  • Get connection design types defined at the account level specifying design variants like risers and jumpers.
  • Get account well definitions representing well types for modeling and simulation searchable by ID or name.
  • Get account shape definitions (e.g., boxes, spheres, cones, text annotations) used for annotations or custom geometry.
  • Get all shape types defined in the account for classification and management of vector shapes.
  • Get account layer definitions including background maps, bathymetry, surfaces, GIS layers, and other spatial data.
  • Get all layer types defined in the account for classifying maps, surfaces, bathymetry, and other spatial data layers.
  • Get metadata definitions at the account level by name or ID to define additional structured attributes attached to assets, connections, wells, shapes, or layers.

Get project object's data

Tools available

  • getProjectAssets
  • getProjectConnections
  • getProjectWells
  • getProjectShapes
  • getProjectLayers

Description
Get project staged assets (physical equipment like manifolds, PLETs, wellheads, pumps, etc.), connections, wells, shapes or layers with optional filtering by category, tag, and metadata definitions.

Example Prompts

  • Find information about all staged assets from the category "XMT" in the project.
  • Get all connections in the project.
  • Show me information about the wells in the project.
  • Which shapes are used in the project?
  • Get information about the project layers.

Get subproject data

Tools available

  • getSubProjectTags
  • getSubProjectAnnotations
  • getSubprojectChanges
  • getWorkflowTasks
  • getParentSubprojects

Description
Get subproject specific information, such as tags, annotaions, recent subproject changes, workflow tasks.

Example Prompts

  • Get all tags used in the subproject.
  • Get all anotations in the subproject.
  • List all changes done to the subproject recently.
  • Show me all workflow tasks for this subproject.
  • List all subprojects in the current project.

Get Documents

Tools available

  • getAccountDocumentsList
  • getSubprojectDocumentsList

Description
Get documents saved in the account or subproject Document API.

Example Prompts

  • List all documents for this subproject.
  • List all documents for this account.

Search in Documents

Tools available

  • getProjectUploads
  • getLinkedProjectUploads
  • getAccountFiles
  • getApidocs
  • getGuides

Description
Perform a full-text search in the processed uploaded files, the FieldTwin API documentation, manuals and guides in the FieldTwin platform.

Example Prompts

  • Find information about 'pipeline specifications' in project uploads.
  • Find documents mentioning 'pipeline inspection' in parent subprojects.
  • Which account documents mention 'version control'?
  • Retrieve API docs for creating staged assets.
  • Show me the user guide for creating and managing connections.

Updating data

Update project object's metadata

Tools available

  • updateProjectObjectsMetadata

Description
Update project staged assets, connections, wells, shapes or layers metadata values.

Example Prompts

  • Update the “Oil Production #1” connection’s Wall Thickness to 5.

Update project object's properties

Tools available

  • updateStagedAssets
  • updateConnections
  • updateWells
  • updateShapes
  • updateLayers

Description
Update staged assets, connections, wells, shapes or layers properties. Supports updating a single asset or multiple assets at once.

The following object properties can be changed:

  • Name
  • Tags
  • Description

Example Prompts

  • Update “XMT deep water #1” description to “XMT”.
  • Add an “oil-prod” tag to the “Oil Production #1” connection.
  • Update the name of the “Well 1” well to be "W1".
  • Update the "Box 1" shape's description to "Yggdrasil".
  • Add the "layer" tag to the Volve_bathymetry.

Creating data

Create project objects

Tools available

  • createProjectAsset
  • createProjectConnection
  • createProjectWell

Description
Create staged assets, wells and connections. Connect multiple objects together and create a specialized digital twin design.

Example Prompts

  • Create a new manifold asset named 'Main Manifold 1' at coordinates X=1500 m, Y=900 m.
  • Add an umbilical connection labeled 'Umbilical 01' between asset 'Riser Base #2' and 'Generic FPSO (Turret) #1'.
  • Create a new production well named 'Well-pd01' at location X=1000 m, Y=2000 m.

Create exportable data

Tools available

  • createChart
  • createCsv
  • exportObjectList

Description
Create a variaty of exportable data, extending FieldTwin's capabilities through data visualization, project data export in standardized formats, supporting efficient project management and external communication.

Example Prompts

  • Create a pie chart from all staged assets in the project.
  • Export a CSV file listing all assets in the project with columns: ID, Name, Category, Status.
  • Create an exportable list from all objects in the project.

Utilities

Tools available

  • apiToolCreator
  • createSum

Description
Utilize quick built-in helpers to support your work in FieldTwin.

Example Prompts

  • Create an API call to get all staged assets from FieldTwin.
  • Calculate the total length of the oil production pipelines in the project.

Actions

Viewport actions

Tools available

  • selectItemsInViewport
  • zoomAtPointInViewport

Description
Focus, select and locate a given object or a point in the FieldTwin viewport.

Example Prompts

  • Select all staged assets from category XMT.
  • Zoom on X: 434051, Y: 6477521, Z: 93.