Getting started
Describes the steps to log in to API Assistant.
Before you begin
Ensure that the following tools are installed on your system:
- Visual Studio Code (VS Code)
- Homebrew
- Python
- PostgresSQL
Installing API Assistant
To download VS Code plug-in for API Assistant, complete the
following steps:
- Log into API Manager.
- In the API
Manager home
page, click the Tools for download option.
- In the Tools for download window, click the API Assistant tab.
- Click Download next to the Step 1: Download VS Code plug-in
for API Assistant.Note: Downloading the
.vsix
file might take a few minutes. - Open VS Code.
- From the left panel, open the Extensions panel.
- From the upper-right corner of the window, click the View and More
Actions ... icon, and select Install from VSIX.
- Navigate to the folder, and select the
file, and then click Install. You can view the API Assistant icon on the VS Code left panel.api-assistant-vscode-plugin-0.0.1-<build_number>.vsix
- To upgrade API Assistant plug-in, repeat steps 1-8 and install the latest .vsix file.Note: Ensure that the latest .vsix file is the latest version.
Log in to API Assistant
To log in to API Assistant, complete the following steps:
- Open VS Code.
- Click the API Assistant icon.
- In the HOST URL field, enter the following URL:
and then click Log in.https://api-manager.preview.apiconnect.test.automation.ibm.com
- Click Allow to sign in, and then select Open.
- Log in to API Manager, and then click use this link URL.
- Select Open Visual Studio Code when prompted, and click Open.
- Select the Provider organization option, and click
Continue.
-
Create a new folder in your system, for example,
api-assistant-workspace
. From VS Code, select to open the folder. It will automatically create a workspace within that folder. - To start a new chat session or to logout, click the IBM API Assistant
menu
and select:
- New chat: Starts a new chat session. In this tech preview, previous chat sessions are not accessible. For more details, see Limitations.
- Logout: Logout from API Assistant.
Note: If an error appears on the UI after login, refer Limitations. - To view the host URL and organization information, in the upper-right corner of the screen,
select your organization
. In this tech preview, you can only view the host URL and organization information in the Settings section, you cannot edit.
Uninstalling API Assistant
To uninstall API Assistant, complete the following steps:
- Open VS Code, and go to the Extension panel.
- In the Search Extensions in Marketplace field, enter the following text:
IBM API Assistant VS Code Plugin
. - Click IBM API Assistant VSCode Plugin, and select
Uninstall.