Opik icon

Opik

Interact with the Opik API
Join our community

Actions6

Overview

This node interacts with the Opik API to retrieve items from a specified dataset. It is useful for scenarios where users need to fetch paginated data from datasets managed within the Opik platform, such as data analysis, reporting, or integration workflows. For example, a user can fetch a specific page of dataset items with optional filtering and control over the size of the response payload.

Use Case Examples

  1. Fetch the first page of items from a dataset named 'SalesData' with 50 items per page.
  2. Retrieve dataset items with advanced JSON filters to narrow down results based on specific criteria.
  3. Truncate large dataset item payloads to improve response time when only summary data is needed.

Properties

Name Meaning
Dataset Name or ID The identifier or name of the dataset from which to retrieve items. This can be selected from a list or specified via an expression.
Page The page number of results to fetch, starting at 1.
Items Per Page The number of dataset items to return per page, with a maximum of 200.
Filters (JSON String) An advanced filter expressed as a JSON string to filter dataset items according to specific criteria.
Truncate Data A boolean flag indicating whether to truncate large dataset item payloads for faster responses.
Request Options Additional request options including batching, SSL certificate validation, proxy settings, and timeout configuration.

Output

JSON

  • items - Array of dataset items retrieved from the specified dataset.
  • page - The current page number of the results.
  • size - The number of items returned per page.
  • totalItems - Total number of items available in the dataset.

Dependencies

  • Requires an API key credential for authenticating with the Opik API.

Troubleshooting

  • Common issues include invalid dataset ID or name, resulting in errors or empty responses. Verify the dataset identifier is correct and accessible.
  • Incorrect JSON format in the Filters property can cause request failures. Ensure the filter string is valid JSON.
  • Timeout errors may occur if the server is slow to respond; adjust the timeout setting accordingly.
  • SSL certificate validation errors can be bypassed by enabling the 'Ignore SSL Issues' option, but this reduces security.

Discussion