Integrate a YunIO Service with Langdock

This article shows how to integrate a yunIO service with Langdock workflows.

Langdock is an AI-powered workspace platform for integrating, managing, and using large language models. For more information, see Langdock Documentation.

Setup in yunIO

Before integrating yunIO with third-party tools:

1. Create a service in yunIO.
2. Click to testrun the service in yunIO. For more information, see Documentation: Run Services in yunIO.
3. Click to copy the service endpoint URL.
   

You can now use the endpoint URL to integrate the service with third-party tools.

Setup in Langdock

To run yunIO services from Langdock workflows:

1. Open https://app.langdock.com/ and create a new workflow in the Workflows section.
2. Add a trigger node and an HTTP Request node.
   
3. In the HTTP Request node settings, set Method to POST.
4. Enter the yunIO service endpoint URL into URL, e.g., https://yunio.example.com:8175/services/[service-name]. You can find the URL in the Run menu of your service.

5. Add headers that define authentication and input and output formats of the service. Examples:

   Key	Value	Description
   Authorization	Basic ZXhhbXBsZV9vbmx5OmRvX25vdF91c2U=	Authentication against yunIO. If yunIO uses access restrictions, enter Basic followed by your base64 encoded yunIO credentials in the format username:password.
   Content-Type	application/json	Specifies that the data you send in the request body is formatted as JSON. Use this when passing parameters as a JSON object.
   Accept	application/json	Specifies that you want to receive the response data in JSON format.

6. Optional: use Send Body or Send Query Parameters to pass parameters to your service, see Pass Parameters.

7. Click [] at the top of the node to test the service call. If successful, the Output panel underneath the node displays the service output.
   

You can now fetch SAP data via yunIO and pass it to other nodes for further processing.

Pass Parameters

There are multiple ways to pass parameters to your service in Langdock:

• using the JSON payload of the service, see Configure Body Using JSON.
• using the Send Query Parameters option of the HTTP node to pass query parameters, see list of query parameters in yunIO.

Configure Body Using JSON

To pass parameters in the request body of the service:

1. Open yunIO and navigate to the Run menu of your service.
2. Download the service payload. The file [service-name]_input_payload.json contains all parameters and their structure in JSON format. If you assign parameters in the Run menu before downloading the payload, they are included in the file.
   
3. Open the HTTP Request node settings in your Langdock workflow.

4. Add the following header:

   Key	Value
   Content-Type	application/json

5. Copy the content of the [service-name]_input_payload.json file into the Request Body field.

6. If your parameters do not have values yet, add values directly in the JSON body or use Langdock variables to map parameters to output from previous nodes, see Langdock Documentation: Variable Usage.
   
7. Click [] at the top of the node to test the service call. If successful, the Output panel underneath the node displays the service output.

You can now pass parameters to your service and fetch specific data from SAP. For information on how to pass variables, refer to Langdock Documentation: Variable Usage.

Related Links

• Langcock Documentation: Workflows
• Langdock Documentation: HTTP Request Node
• Langdock Documentation: Variable Usage
• yunIO Documentation: Run Services
• yunIO Documentation: Parameters