> For the complete documentation index, see [llms.txt](https://docs.sealights.io/knowledgebase/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sealights.io/knowledgebase/guides/sap/sealights-agents-and-plugins/abap-agent/command-line-interface/set-up-the-agent.md).
# Set up the agent
{% hint style="warning" %}
**Upgrading from an older agent version?** The current agent requires configuration version 2. If your `config.toml` uses an older format, the agent will prompt you to migrate. Follow the steps in [Migrate a legacy configuration](/knowledgebase/guides/sap/sealights-agents-and-plugins/abap-agent/command-line-interface/set-up-the-agent/migrate-a-legacy-configuration.md) to upgrade your `config.toml`.
{% endhint %}
## Prerequisite to Agent Setup
To check connectivity to Sealights, run the following from your terminal (replace the `{customerId}` with your customer id beforehand):
{% tabs %}
{% tab title="Command Prompt" %}
{% code overflow="wrap" lineNumbers="true" %}
```batch
curl -I https://{customerId}.sealights.co
```
{% endcode %}
{% endtab %}
{% tab title="PowerShell" %}
{% code overflow="wrap" lineNumbers="true" %}
```powershell
Test-NetConnection {customerId}.sealights.co -Port 443
Invoke-WebRequest https://{customerId}.sealights.co
```
{% endcode %}
{% endtab %}
{% endtabs %}
## Set up the agent
To set up the ABAP agent, run the following from your terminal:
## List the agent's settings
To list the ABAP agent's ABAP settings, run the following from your terminal:
{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Command" overflow="wrap" %}
```batch
slabapcli.exe settings list
```
{% endcode %}
{% endtab %}
{% tab title="PowerShell" %}
{% code title="Command" overflow="wrap" %}
```powershell
.\slabapcli.exe settings list
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% code title="Expected output (PowerShell)" overflow="wrap" lineNumbers="true" %}
```log
.\slabapcli.exe settings list
[2025-06-20 10:22:48.782+01:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2025-06-20 10:22:48.782+01:00] [info] Config pathname: ../config/config.toml
[2025-06-20 10:22:48.785+01:00] [info] Install dir : C:\Program Files\Tricentis\SeaLights\ABAP Agent\bin
[2025-06-20 10:22:48.786+01:00] [info] User data dir : ..\userdata
[2025-06-20 10:22:48.786+01:00] [info] Key : 01000000d08c9ddf0115d1118c7a00c04fc297eb01000000b4f1adcc9afb9a41849a2ac77c60e16b04...c035668c57485ce5
[2025-06-20 10:22:48.786+01:00] [info] IV : 00283e66c6697b9ddb9047a3363e06bf
[2025-06-20 10:22:48.787+01:00] [info] Total time: 00:00:00.005
```
{% endcode %}
The command-line interface shows encrypted keys in the **settings list** output.
## Connect the agent to your SeaLights environment
The next step is to connect the agent to your SeaLights environment. You can do this as follows:
### Copy your SeaLights agent token
First you'll need to copy your SeaLights agent token to the clipboard, as follows:
1. In a web browser, navigate to the URL for your SeaLights dashboard.
2. Select the **Settings** icon, and then select **Agent Tokens** from the **Settings** menu's **Cockpit & Onboarding** section.
3. Locate the entry for your agent token, and press the **Copy token** button to copy it to the clipboard. Be sure to copy a token whose status is active.
### Connect the agent to SeaLights
Next, you'll need to connect the agent to SeaLights using the command-line interface. You can do this as follows:
* Run the following command from your terminal:
## List the SeaLights token
To list the SeaLights token in encrypted form, run the following from your terminal:
{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Command" overflow="wrap" %}
```batch
slabapcli.exe sealights list
```
{% endcode %}
{% endtab %}
{% tab title="PowerShell" %}
{% code title="Command" overflow="wrap" %}
```powershell
.\slabapcli.exe sealights list
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% code title="Expected output (PowerShell)" overflow="wrap" lineNumbers="true" %}
```log
.\slabapcli.exe sealights list
[2025-06-17 09:03:34.867+01:00] [info] Current ANSI Code Page: 65001 (UTF-8) (65001)
[2025-06-17 09:03:34.867+01:00] [info] Config pathname: ../config/config.toml
Hostname: dev-abap-integration-5-gw.dev.sealights.co
Clock sync hostname: dev-staging.dev.sealights.co
Token : ********
Customer id: SeaLights
```
{% endcode %}
## Test the connection to SeaLights
{% hint style="info" %}
The `sealights set` command above already ran a connectivity test automatically. Use `sealights test` only if you need to re-verify connectivity later without changing the token.
{% endhint %}
## Add a proxy
If connection fails your organization might be using a proxy, if that's the case use the following to set it up:
{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Command" overflow="wrap" %}
```batch
slabapcli.exe proxy set --server "http://proxy.example.com:8080" --auth
```
{% endcode %}
{% endtab %}
{% tab title="PowerShell" %}
{% code title="Command" overflow="wrap" %}
```powershell
.\slabapcli.exe proxy set --server 'http://proxy.example.com:8080' --auth
```
{% endcode %}
{% endtab %}
{% endtabs %}
{% code title="Expected output (PowerShell)" overflow="wrap" lineNumbers="true" %}
```log
.\slabapcli.exe proxy set --server 'http://proxy.example.com:8080' --auth
Enter proxy username: user1
Enter proxy password:
[2025-10-20 13:45:22.714+02:00] [info] Proxy configuration saved successfully.
```
{% endcode %}
## Validate your complete setup
After configuring all components (SeaLights, RFC destinations, and pipelines), run the setup status command to verify everything in one step:
{% tabs %}
{% tab title="Command Prompt" %}
{% code title="Command" overflow="wrap" %}
```batch
slabapcli.exe setup status
```
{% endcode %}
{% endtab %}
{% tab title="PowerShell" %}
{% code title="Command" overflow="wrap" %}
```powershell
.\slabapcli.exe setup status
```
{% endcode %}
{% endtab %}
{% endtabs %}
For details on reading the report, see [Validate Your Setup](/knowledgebase/guides/sap/sealights-agents-and-plugins/abap-agent/command-line-interface/validate-your-setup.md).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.sealights.io/knowledgebase/guides/sap/sealights-agents-and-plugins/abap-agent/command-line-interface/set-up-the-agent.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.