Miriel AI icon

Miriel AI

Miriel AI - Query data or learn from input strings

Actions2

Overview

This node integrates with the Miriel AI platform to submit learning data for processing. It allows users to send input strings or JSON objects to be "learned" by the Miriel AI system, which can then use this data for future queries or analysis.

Typical use cases include:

  • Feeding custom textual data or documents into Miriel AI to enhance its knowledge base.
  • Automating the ingestion of domain-specific information for AI-powered applications.
  • Submitting batches of learning data with control over metadata, access grants, and processing options.

For example, a user might submit customer support transcripts as learning data to improve AI responses in a chatbot.

Properties

Name Meaning
User ID Optional identifier for the user submitting the learning data.
Grant IDs JSON array of grant IDs controlling access permissions; default is ["*"] (all grants).
Discoverable Boolean indicating if the learned content should be discoverable by others.
Metadata Optional JSON object containing additional metadata about the learning data.
Force String Boolean to force processing the input strictly as a string.
Force Search Boolean to force search-based processing mode.
Recursion Depth Number specifying recursion depth for processing (default 0).
Chunk Size Optional number defining chunk size for processing large inputs.
Domain Restrictions JSON array of domain restrictions limiting where the learning applies.
Priority Numeric priority for the learning job (default 100).
Project Numeric project ID associated with the learning job (default 0).
Polling Interval Number of seconds between polling attempts when waiting for job completion (default 30).
Wait for Completion Boolean indicating whether to wait for the learning job to complete before returning.
Max Wait Time (Seconds) Maximum time in seconds to wait for job completion if waiting (default 3600 seconds = 1 hour).

Output

The node outputs an array of JSON objects, one per input item, each containing:

  • originalInput: The original input string submitted for learning.
  • jobNumbers: An array of job IDs returned by the Miriel API representing the learning jobs created.
  • status: Status of the submission, typically "submitted" or "completed" if waiting was enabled.
  • completionResult (optional): Present if waiting for completion; indicates the final status of the job.
  • Additional fields from the original input JSON are merged into the output.

No binary data is produced by this node.

Dependencies

  • Requires an API key credential for Miriel AI to authenticate requests.
  • Makes HTTP POST requests to Miriel AI endpoints:
    • Learning submission: https://api.prod.miriel.ai/api/v2/learn
    • Job monitoring (if waiting for completion): https://api.dev.miriel.ai/api/v2/get_monitor_jobs
  • The node expects valid JSON for some parameters (Grant IDs, Metadata, Domain Restrictions).
  • Network connectivity to Miriel AI services is required.

Troubleshooting

  • No input data provided: The node requires at least one input item; ensure data is passed into the node.
  • Invalid JSON in parameters: Parameters like Grant IDs, Metadata, and Domain Restrictions must be valid JSON arrays or objects. Invalid JSON will cause errors.
  • Invalid API key: If the API key is invalid or missing, the node throws an error prompting to sign up or check credentials.
  • Timeout waiting for job completion: When Wait for Completion is enabled, the node polls until jobs finish or max wait time is reached. Exceeding max wait time results in a timeout error.
  • Invalid input type: Input items must contain a string or JSON with a string field (input, text, or string). Otherwise, an error is thrown.
  • API call failures: Network issues or server errors from Miriel AI will result in errors with messages indicating the failure reason.

To resolve these issues:

  • Validate all JSON parameters before running.
  • Confirm API key validity on Miriel AI portal.
  • Provide proper input data format.
  • Adjust polling interval and max wait time according to expected job duration.

Links and References

  • Miriel AI Website
  • Miriel AI API documentation (not publicly linked here; consult Miriel AI support for details)

Discussion