@docbrasil/api-systemmanager 1.1.81 → 1.1.82

package/doc/api.md

@@ -1814,6 +1814,8 @@ Class for AI Session management
 * [AISession](#AISession)
     * [.getByDocument(params, authorization)](#AISession+getByDocument) ⇒ <code>Promise.&lt;object&gt;</code> \| <code>object</code> \| <code>object</code> \| <code>array.&lt;object&gt;</code> \| <code>array.&lt;object&gt;</code> \| <code>array.&lt;object&gt;</code> \| <code>object</code>
     * [.updateData(params, authorization)](#AISession+updateData) ⇒ <code>Promise.&lt;object&gt;</code> \| <code>array.&lt;object&gt;</code> \| <code>object</code> \| <code>object</code>
+    * [.create(params, authorization)](#AISession+create) ⇒ <code>Promise.&lt;object&gt;</code> \| <code>string</code> \| <code>string</code>
+    * [.execute(params, authorization)](#AISession+execute) ⇒ <code>Promise.&lt;object&gt;</code> \| <code>string</code> \| <code>string</code>
 
 <a name="AISession+getByDocument"></a>
 
@@ -1888,6 +1890,72 @@ const params = {
 };
 const retData = await api.ai.sessions.updateData(params, authorization);
 ```
+<a name="AISession+create"></a>
+
+### aiSession.create(params, authorization) ⇒ <code>Promise.&lt;object&gt;</code> \| <code>string</code> \| <code>string</code>
+Create a new agent session.
+Use this to create a session with full metadata before triggering execution.
+
+**Kind**: instance method of [<code>AISession</code>](#AISession)  
+**Returns**: <code>Promise.&lt;object&gt;</code> - data The created session<code>string</code> - data.sessionId The session ID<code>string</code> - data.status The session status  
+**Access**: public  
+**Author**: Myndware <augusto.pissarra@myndware.com>  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| params | <code>object</code> | Parameters |
+| params.agentType | <code>string</code> | The agent type (e.g., 'doc-rlm-ingest') |
+| [params.config] | <code>object</code> | Agent configuration options |
+| [params.metadata] | <code>object</code> | Session metadata (documentId, pipelineVariant, analysisMode, etc.) |
+| authorization | <code>string</code> | Authorization token |
+
+**Example**  
+```js
+const API = require('@docbrasil/api-systemmanager');
+const api = new API();
+const authorization = '...';
+const params = {
+  agentType: 'doc-rlm-ingest',
+  metadata: {
+    documentId: 'doc-123',
+    documentName: 'Patient Report.pdf',
+    pipelineVariant: 'A',
+    analysisMode: 'full'
+  }
+};
+const retData = await api.ai.sessions.create(params, authorization);
+```
+<a name="AISession+execute"></a>
+
+### aiSession.execute(params, authorization) ⇒ <code>Promise.&lt;object&gt;</code> \| <code>string</code> \| <code>string</code>
+Start execution on an existing agent session.
+
+**Kind**: instance method of [<code>AISession</code>](#AISession)  
+**Returns**: <code>Promise.&lt;object&gt;</code> - data The execution data<code>string</code> - data.executionId The execution ID<code>string</code> - data.status The execution status  
+**Access**: public  
+**Author**: Myndware <augusto.pissarra@myndware.com>  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| params | <code>object</code> | Parameters |
+| params.sessionId | <code>string</code> | The session ID to execute |
+| [params.input] | <code>object</code> | Execution input (documentId, options, etc.) |
+| authorization | <code>string</code> | Authorization token |
+
+**Example**  
+```js
+const API = require('@docbrasil/api-systemmanager');
+const api = new API();
+const authorization = '...';
+const params = {
+  sessionId: 'session-abc-123',
+  input: {
+    documentId: 'doc-123',
+    options: { pipelineVariant: 'A', analysisMode: 'full' }
+  }
+};
+const retData = await api.ai.sessions.execute(params, authorization);
+```
 <a name="GeoLocation"></a>
 
 ## GeoLocation