AWS Lambda

AWS Lambda is an event-driven, serverless computing platform provided by Amazon Web Services (AWS). It runs your code in response to events and automatically manages the compute resources, making it the fastest way to turn an idea into a modern, production, serverless application. This document describes how to connect IBM watsonx Orchestrate to AWS Lambda and use its skills on watsonx Orchestrate.

Connecting to AWS Lambda

Important:
- A credential type must be set for apps that are a part of team skill sets and AI assistants. Skill-based actions in AI assistants support only shared credentials.
- If a credential type of an app is not specified, an error message is displayed when users attempt to run the skills of the app. To resolve the error, an admin must set the credential type for the app. For more information, see Managing connections.

An app can be connected either through the skill catalog or through the watsonx Orchestrate chat. Use the method that suits you to connect to an app.

Connect to the app through the skill catalog when you add that skill to your skill set:

  1. On the watsonx Orchestrate chat page, click Add skills from the catalog.
  2. Search and click the app tile.
  3. Click Connect app.
  4. Configure the connection. For more information, see Configuring the connection.
  5. Click Connect app.

Otherwise, connect to that app through the watsonx Orchestrate chat when you use the skill:

  1. Open the watsonx Orchestrate chat.
  2. On the chat, start the skill.
  3. Click Connect app.
  4. Configure the connection. For more information, see Configuring the connection.
  5. Click Connect app.

Configuring the connection

To connect watsonx Orchestrate to AWS Lambda, complete the following steps:

  1. Fill all fields needed to establish the connection.
    1. Specify the Secret access key and Access key ID, you can get the details on the Security Credentials page in the AWS Management Console.
    2. On Region, set the region where the server hosting your AWS Lambda is located.
  2. Click Connect app.
Note: The icon A green check icon appears to show that the app is connected. indicates that the connection was successfully established.

Technical parameters

The following table contains the technical parameters required by some skills of this app and instructions to retrieve them.

Parameters Details
function arn Is a unique Amazon Resource Name (ARN) to identify the specific version of the function. See AWS Lambda developer guide for more details.
Qualifier Specify a version or alias to get details of or start a published version of the function. For the Delete operation, specify only the version. You can't delete a version that is referred by an alias.
Client context The context object can contain up to 3583 bytes of base64-encoded data about the starting client that is passed to the function.
Invocation type You can either select RequestResponse or Event.
Log type You can either select Tail or None. Setting the Log type to Tail includes the execution log in the response. This option is only applicable to synchronously started functions.

What to do next

After you connect to the app, you can use the app’s skills. For more information see, Using the chat. To know what skill you can use, see the skills and skill flow column of List of prebuilt apps, skills and skill flows.

Parent topic:

→ Prebuilt apps