copyright | lastupdated | keywords | subcollection | ||
---|---|---|---|---|---|
|
2024-11-01 |
watsonx-code-assistant |
{{site.data.keyword.attribute-definition-list}}
{: #cloud-setup-a}
[Red Hat Ansible Lightspeed]{: tag-red}
Set up your {{site.data.keyword.cloud_notm}} service instance of {{site.data.keyword.wcaal_short}} so you can use it with your full installation of Red Hat Ansible Lightspeed. {: shortdesc}
{: #prereqs-a}
-
Make sure you have an {{site.data.keyword.cloud_notm}} account{: external}.
-
Provision an instance of {{site.data.keyword.wca_short}} through the {{site.data.keyword.cloud_notm}} catalog{: external} page or by working with an IBM sales representative.
When you finish provisioning your instance, click Setup to open an onboarding checklist page to help you configure the instance. Or, you can select Administration and then Setup to access this onboarding checklist.
Items in that checklist correspond to each of the following steps. Click the action arrows on the checklist page that are associated with each item to complete the steps.
{: #sid_apikey}
You use this API key later to enable Visual Studio Code to communicate with {{site.data.keyword.wca_short}}.
-
On the Service IDs{: external} page, click Create.
-
Enter
{{site.data.keyword.wca_full_notm}} user
as the name for your service ID. Optionally, enter a description. -
Click Create.
You are redirected to the dashboard for your service ID, which includes tabs for Access and API keys.
-
Click the API keys tab.
-
Click Create.
-
Enter
{{site.data.keyword.wca_full_notm}} API key
as the name for your API key. Optionally, enter a description. -
Click Create.
-
Click Download or Copy and store the API key in a safe location.
The key is only available for 296 seconds. Make sure to store it somewhere you can find it later. {: important}
{: #deploy_space-a}
The deployment space is the serving environment for {{site.data.keyword.wca_short}}. The model ID determines which model generates code recommendations in the Ansible extension for Visual Studio Code.
-
In your {{site.data.keyword.wca_short}} instance, click the Navigation Menu icon , then select Deployments.
-
Click New deployment space.
-
Enter
Code Assistant Models
as the name for your deployment space. Optionally, enter a description. -
In Code assistant service, select your instance name.
-
Click Create.
-
A status window appears. After the space is created, click Close.
-
Copy your model ID. After you create the deployment space, your model ID is provided in a field after the Create a deployment space checklist item. Copy this ID and store it in a safe location as you need to add it to the Red Hat Ansible Lightspeed Admin portal in a later step.
{: #space_collab}
Enable the API to connect to your deployment space.
-
On the Manage tab of your deployment space, click Access control.
-
Click Add collaborators and select Add service IDs from the menu.
A list of service IDs that are associated with your account appears.
-
Click the checkbox for the {{site.data.keyword.wca_full_notm}} user service ID that you created, and select Editor for the role.
-
Click Add.
The service ID is added to the list of collaborators.
{: #rh-admin}
Add the API key and the model ID to the Red Hat Ansible Lightspeed Admin Portal to connect {{site.data.keyword.wca_short}} with the Ansible extension for Visual Studio Code. Follow the onboarding checklist and the instructions from Red Hat.
To add the API key and model ID to the Red Hat Ansible Lightspeed Admin Portal, see Configuring Red Hat Ansible Lightspeed cloud service{: external} in the Red Hat documentation.
{: #create-project}
[Standard plan]{: tag-purple}
If you purchased a Standard plan, you can tune the IBM base code model with your own data so that it generates code suggestions that are customized for your organizational context. All your assets are stored in a project, including your uploaded data and tuned models. After you create a project, you can work with data and other resources to tune models.
-
In your {{site.data.keyword.wca_short}} instance, click the Navigation Menu icon , then select Projects.
-
Click New project.
-
Enter a meaningful name and description for your project so you can easily identify it.
-
Click Create.
-
In the new project, click the Manage tab, then select Services & integrations.
-
Click Associate service.
-
Select your instance, then click Associate.
You're now ready to create a tuning experiment to tune the IBM base code model with your own data. For more information, see Tuning the IBM base code model for {{site.data.keyword.wcaal_short}}.
{: #next_steps}
See Installing and configuring the Ansible VS Code extension{: external} to install and configure the Ansible extension for Visual Studio Code and start generating code recommendations.