Skip to main content
Preview An agent can draft new ontology definitions for you, but only a person can save them. The agent prepares an import document and checks it; you review the preview in Studio and approve it. Nothing is published until you publish it yourself.

​
What agents can and cannot do

Binding mappings and knowledge records an agent suggests stay as text for you to enter separately. This flow creates logical definitions only.

​
Before you begin

  • You can create in the ontology’s workspace, and you sign in to Studio as yourself.
  • The agent has given you its document, for example a native JSON file that adds a Return object type and a returned_in link to the retail model.
1

Open the import preview

In the ontology, open Definitions and choose Import file. Importing into shows the destination ontology; check it is the right one.Drop the file, choose Choose file, or paste the document. Pick the Format: Studio JSON, RDF · Turtle, OWL or SKOS. For RDF, OWL and SKOS, also set the Base IRI. Then choose Preview import.
2

Review the proposal

Studio shows Preview only. and Would create with the number of definitions. Nothing has been saved yet.
  • Open each proposed definition and read its properties and links.
  • Read the Import report. nothing lost means the document mapped fully; otherwise it counts approximations, omissions and unsupported parts.
  • If Studio shows Import validation errors, the proposal can’t be saved. Ask the agent to fix the named definitions, then preview the new document.
3

Approve or reject

To approve, select I approve creating these definitions as drafts in the selected ontology. Nothing will be published., then choose Save approved drafts.To reject, leave the box clear and close the page, or choose Choose another. Nothing is written.The approval covers this exact preview. If the document, the format options or the destination ontology changes, Studio needs a fresh preview and a fresh approval.
4

Publish when ready

The new definitions are ordinary drafts. Edit them like any other, then validate and publish on the Publish page when you are ready.

​
Verify

  • Studio shows Drafts saved. and Saved N definitions as drafts atomically. Review and publish separately. Choose View definitions to see them.
  • Definitions lists the new definitions as drafts, and the toolbar shows them as unpublished.
  • The live release is unchanged until you publish.
If Studio reports Save outcome unknown., check Definitions before trying again: a failed response doesn’t prove the save failed, and the same preview can’t be submitted twice.

​
Limits

  • One save creates at most 100 definitions, all or none. A larger valid proposal shows This proposal cannot be applied synchronously. Reduce its size and preview it again.
  • A document can be at most 8 MiB.
  • Approval needs a direct human sign-in. Without one, the save fails with “direct human draft approval required”; see Draft save returns 403.