Skip to main content

Administration

Deployment & administration

This chapter cover deployment & administration only, learn more about the configuration in Widget configuration.

Admin UI​

info

Today TECHNIA manage widget admin for you. The admin UI will soon be available for customers to manage some of the setup themselves.

TECHNIA does the following for you today from the admin UI.

  • Widget registration
    • Create new widgets
    • Register widget access with 3DEXPERIENCE app-id
    • Setup config edit access tokens
  • Subscription detail
    • Trial / full
    • Renewal (due-date)
    • User count
  • Subscription audit
    • Measure use

admin-ui.png

Widget Development​

Widgets are developed using the in widget configuration editor. To enable development go to preference select Administration Mode true. Dev mode directly give access to make local changes. To allow saving changes to the server a Administration Token must be entered.

widget-preferences.png

AI Assistant​

Not yet an expert on the configuraton format? The built in AI assistant could do the work for you. You are still in control, will preview, make final adjustments and decide when to save the configuration.

Your message is sent together with the context below. Tick Show Details in the chat panel to see that context. Every entry is one section of the prompt, shown in the order the assistant receives it, so this list is exactly what you will find there:

  • Deployment environment (cloud or on-premise only, no tenant identifier)
  • Information model of the data loaded into the graph (a summary of the types, the relationships and the available attributes, not the values)
  • Configuration schema
  • The widget configuration currently open in the editor
  • Available extensions, as an index of names and descriptions only, never the definition bodies
  • Definitions the widget inherits from the extensions it extends, resolved to their effective values
  • Reference validation results
  • Each tool the assistant called during the turn, with what it returned

Tick Share Data to add what you are currently looking at. This is the only context that carries real business data, which is why it is off by default:

  • Graph data, meaning the attribute values of the nodes and edges currently loaded (capped per message)
  • The visible tables and forms rendered as Markdown, including their row and field values (capped per message)

Standing instructions that are identical on every message, such as the authoring guidelines and the assistant's system prompt, are left out of Show Details so the request-specific context stays readable.

Tools the assistant can call to work efficiently

  • Apply a change to the widget configuration, validated against the schema and for broken references
  • Validate a JSONata expression before using it
  • Read the full contents of a definition in an extension
  • Find the relevant 3DEXPERIENCE API specification
tip

Filling the graph by expanding tables etc as much as possible before asking AI helps building a rich information model and can help improve the experience.

ai-assistant.png

Configuration Editor​

The config editor allow administrators to modify widget definitions. You can modify individual values or edit the root node to replace the full definition (useful if you prefer using an external IDE).

Preview configuration change​

  1. Apply the change by clicking the green checkbox next to the modified field :check_mark:
  2. Click preview

Reset from server​

Discard you local changes.

Save to server​

Updates the definition. Each configuration version is stored individually and it is possible to revert (today ask TECHNIA but planned to be added in studio). You must enter a valid Config Edit Access Token for save access.

warning

Immediately effective to other users. Use a separate widget for a controlled development and test process.

config-editor.png

Graph Visualization​

The visual graph is a useful development tool to understand how and when data is loaded into widget memory. To understand the graph concepts see Technical overview

Show directions​

Checking detailed graph preference could help understand how nodes are connected but there is a performance penalty, especially noticeable with larger graphs.

Data preview​

Clicking an element in the graph brings up a data preview card. Data can be copied into clipboard.

graph-visualization.png

Resource deployment​

TECHNIA can help you deploy custom resources e.g. Extending with plugin code in a controlled way with your account.