# Connecting Third-Party Services

1. To connect one of the 9 third-party services:

* Yandex Cloud,
* Anti Captcha,
* OpenAI,
* OCRSpace,
* Sherpa AI Server,
* SberGigaChat,
* DaData,
* Claude,
* GroqChat,

you need to launch the Sherpa Assistant program.

2. Next, find the Sherpa Assistant icon in the system tray, right-click on it, and select “Settings…” from the context menu:

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe1TyFDcuLTAbU3mdiAKkngnAU8wr6O2tAadKZKjsUcn2Jfnee08l1LAD5j8GJ_sv3QSt9erm4tPqHtkOuxAPoTn6kFMNRNpOKLZK6D1WE-ynwj4Q5p0PEc1MpiTjmE5vh_Ne1agA?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

3. Then go to the “Services” tab:

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd5Z4kqhrufCWodssWQOOSjKgQsXXAkh9OuZ8OVQGA0jPiXBA9U1g8VTwcrYW7D-rZgeD2TIsQPo-yYTsUjxns-SJoNMXF13K3p23VbfNKnEquJTZ8a6PP04ZS-PgaRQAmJ1BTN_Q?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="54"></th><th width="516"></th></tr></thead><tbody><tr><td><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXflRROX17KYUHKqEaiSaKrlpBxkvsNDGeib4DqOAKHUZIhbUzsapRwzN5B8n7jkNrVdeT4utKAqR_TzxYTmp5tKvIq0389acR-yl4oNTE6qkSzu8iESHJwdGhg_8NoFbA6svsl4gg?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt="" data-size="line"></td><td>By default, most third-party services operate through the Sherpa RPA platform, and no additional identification is required. To check the remaining limits, click the “Check Limits” button. If the information does not display, it may be because the limits have not yet been used, as the counting starts from the first use.</td></tr></tbody></table>

#### Token Configuration

To connect a third-party service, you need to insert the token in the corresponding tab, which the User receives when creating an account. The User creates the token independently by referring to the relevant documentation:

* Yandex Cloud

<https://yandex.cloud/en/docs/iam/concepts/authorization/>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfKJhWyRC5L0Jp61Ie78DSrpOSVMvWv4czFp-E_naelAYAs24KuuWWp2k1Iik_qknrrb2zJSioWmNVjHZRQM932s26IkjpA3aomH_RA-500le0mdOL265vgZR13sr2v5nx8iJEvew?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

There are two options for filling in the settings in the “Yandex Cloud” tab of the “Settings - Sherpa Assistant” window:

1. Fill in the “PasswordOauthToken” and “FolderId” fields (in this case, the ApiKey field does not need to be filled):\
   PasswordOauthToken: This is the token used for authenticating the application or user when interacting with the Yandex Cloud API. It allows access to cloud resources protected by OAuth 2.0.\
   FolderId: A unique identifier for a folder in Yandex Cloud, which is used to organize and manage resources within the cloud environment. Each project or service may correspond to its own folder.
2. Fill in the “APIKey” field (in this case, other fields do not need to be filled):\
   ApiKey: An access key to the Yandex Cloud API, which is used for identifying and authenticating applications when accessing various cloud services. It allows managing resources and making requests.

* Anti Captcha

<https://anti-captcha.com/en/apidoc>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXes7Q8il7feD6WfaKhbSqelFMHuCz5HTbz3AwKt9rzj0buLhI_Xbdg--4vfWgD10NTf2yPEQTns4wVuN8bkLwwi626Tank6VN2PAuF-PIecfLVDMjDC5ezi5UTu1LfKjC98MWuT-g?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

You need to fill in the “Anti Captcha Key” field in the “Anti Captcha” tab of the “Settings - Sherpa Assistant” window:

Anti Captcha Key: A unique API key provided by the Anti Captcha service. It is used to authenticate requests to the service that solves captchas, allowing automation of processes related to bypassing them.

* OpenAI

<https://platform.openai.com/docs/quickstart?api-mode=responses>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcPEsR-otP9_2-GflVm3khs3PXW4J_cn0HCZW7Uc8rO6OIAE2QoDmfmgGIYcI_RdbBSYSo-6fWvd_n44kjXO4R-K1B-ipwQszB2dZWVpB4E6qTyK6uezrlxsrorQ3F2t7OIZC-XUg?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

You need to fill in the “Token” field in the “OpenAI” tab of the “Settings - Sherpa Assistant” window:

Token: This is a unique key used for authentication when accessing the OpenAI API. The token allows authorizing requests to the models and services provided by OpenAI.

* OCRSpace

<https://ocr.space/OCRAPI/#curl>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe_LLwqOkERdzJV_1CQNIyj0_ZF3U1Jwm-71BjX0DVhhZQIIizHyTsrQyo15RQ8T3hMSe6k7_kAW5sBJd3GI2CrAaDtpRQ21vAR-7JBIoIcXcrgJeYmFnx3OHYP3QjYJxWxX38Gcg?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

You need to fill in the “API Key” field in the “OCRSpace” tab of the “Settings - Sherpa Assistant” window:

API Key: A unique key required to access the OCRSpace API, which provides optical character recognition services. It is used for authentication and tracking API usage.

* Sherpa AI Server

<https://docs.sherparpa.ru/sherpa-ai-server/user-authentication-in-sherpa-ai-server>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXenPHNSCfJwOBD4kuQx3ZrQWD_MGYSLa97elZ2mdvDBNdRe2n7WA6mcksx55Y-Pvh3EkfjkqL0hJYnHy6hOkABTkbEm6Pr7mRCllSzRqXCoeZa2ciDCgT0_CBHjmxvET8tglBwPZw?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

You need to fill in the “Server Domain / IP” and “Token” fields in the “Sherpa AI Server” tab of the “Settings - Sherpa Assistant” window:

1. Server Domain / IP: The domain or IP address where the Sherpa AI Server is accessible.
2. Token: An authentication token used to access the Sherpa AI Server. It ensures that requests come from an authorized User.

* SberGigaChat

<https://developers.sber.ru/docs/en/gigachat/api/reference/rest/post-token>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXckODyeCrSJmPKZeJOXOoPUSRMDiOn0tftFH9lSRd2O3fpQuBD9FkPQ7YYt0a8ZB9F3yZvVSIBxYEGYbLOFTGNIDjnRZ0hClsv0hrZsq_k5PX-c_nsuI4_kmxFV5q2temV1Cxw-gQ?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

You need to fill in the “Client Id”, “Client Secret”, and “Scope” fields in the “Sber GigaChat” tab of the “Settings - Sherpa Assistant” window:

1. Client Id: A unique client identifier used for authenticating the application when accessing the Sber GigaChat API. It allows the system to recognize which application is making the request.
2. Client Secret: A secret key associated with the Client Id, used for additional protection and authentication of the request.
3. Scope: Defines the scope of access requested by the application during authentication. It contains information about which resources and functions the company will allow access to.

* DaData

<https://support.dadata.ru/knowledge-bases/4/articles/2155-how-to-get-an-api-key>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc3g0e9nUcaVtvFUeESBzOVVZ-JPayyiACKNsbCG-p_9xFP8ZuVW9TVG-ab5zF17CTqbpHEUrVjrqNKv15XnyqVkDnaLgSLnxxpr-u9IP-FMoULTiTy5QbsqxzCCMNZnBmq0ne49A?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

You need to fill in the “Token” field in the “DaData” tab of the “Settings - Sherpa Assistant” window:

Token: A unique key provided by the DaData service for authenticating requests to the API. It allows using the service's functions for data validation and processing.

* Claude

<https://docs.anthropic.com/en/docs/initial-setup#set-your-api-key>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdQGFsLchrbHe3AD45_mWRnMcjN0lH5v_eTrMZFQU_zvv95qTJMbLL2JgZeLUdxzRrMydayc9fmIN7q2whLDMphY_-oiEc2ycv33uoEMHFSPWRCuGqqE0tnntPYPdTMdo4ZCmb18g?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

You need to fill in the “API Key” field in the “Claude” tab of the “Settings - Sherpa Assistant” window:

API Key: A unique key that regulates access to the Claude API. It is used for authentication and restricting access to the functionality provided by the system.

* GroqChat

<https://console.groq.com/docs/overview>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeriiFaKmSXmzFdvVaNu1uIqNC72jKDupuiD5zFMrMmhWFiY0Tgh-QKpAy7QYg9GXNUNDkzKlag95KZrA1MJTK4r3cMxRcuVO7D7tECWRHUH67n1KL3SKsTyqGfECb6Z9AxIZZR?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

You need to fill in the “API Key” field in the “GroqChat” tab of the “Settings - Sherpa Assistant” window:

API Key: A unique access key used for authenticating and authorizing requests to the GroqChat API. It allows identifying the application and controlling the level of access to the platform's resources.

When creating an account, there are no specific requirements. The User receives a token or identifier depending on the chosen service. The User's operating system should not block access to the following addresses:

* Sherpa RPA

<https://sherpa.wiregeo.com>

* Yandex

<https://iam.api.cloud.yandex.net>

<https://vision.api.cloud.yandex.net>

<https://ocr.api.cloud.yandex.net>

* Anti Captcha

<https://api.anti-captcha.com>

* OpenAI

<https://api.openai.com/>

* OCR Space

<https://api.ocr.space>

* SberGigaChat

<https://ngw.devices.sberbank.ru:9443>

<https://gigachat.devices.sberbank.ru>

* DaData

<https://suggestions.dadata.ru>

* Claude

<https://api.anthropic.com>

* GroqChat

<https://api.groq.com>

<table data-header-hidden><thead><tr><th width="53"></th><th width="495"></th></tr></thead><tbody><tr><td><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXflRROX17KYUHKqEaiSaKrlpBxkvsNDGeib4DqOAKHUZIhbUzsapRwzN5B8n7jkNrVdeT4utKAqR_TzxYTmp5tKvIq0389acR-yl4oNTE6qkSzu8iESHJwdGhg_8NoFbA6svsl4gg?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt="" data-size="line"></td><td>If the company's security policy prohibits access, the User needs to provide the System Administrator with information about the need to open access for the system to function correctly.</td></tr></tbody></table>

At the time of license activation, the User is provided with certain [limits](https://docs.google.com/document/d/1ewJMGZ-UbDUiokKFO-vQ6c9ypFfH4sfcQl_wS3Jg15U/edit?tab=t.0#heading=h.x4a9bk682hkd). (For example, for the Yandex.Vision service, a sum of 300 rubles is provided, which is sufficient for testing/training, considering that recognizing one page of a document costs 13 kopecks.) If this is not enough, you can contact [support](https://docs.sherparpa.ru/kontakty) to increase the current limit.

If a [VPN](https://disk.yandex.com/i/6z3Mmisu3Wc2eQ) configuration is required to access the neural network, the User must set it up independently. The VPN is configured individually using third-party software. Alternatively, the User can quickly set up a proxy directly in Sherpa Assistant.

#### Sherpa AI Server Application

Sherpa AI Server is a web service application designed for training, using, and retraining large language models (LLM) within the closed perimeter of corporations.

To install Sherpa AI Server, you must have administrator rights. The domain name is configured directly during the installation of the application. Local activation of the AI Server also occurs there. The application is accessible in the browser. In addition to local user authorization, Sherpa AI Server also supports domain authorization (via Active Directory, LDAP/LDAPS protocols) and OpenID authorization.

The token is obtained directly in the Sherpa AI Server web application in the Accounts tab. To get it, you need to select an Account from the proposed list or create a new one by clicking the “Create” button:

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeFh6158_0Ht1melb34zhApvJRFWwcYmtBM2oxkkS73PZYzMa0tjrDV4rBtDEUXWCEt3SUewnaQtW6or9037dFek45Ivmj6wE5YPEU7AcWwvf_PTG1NNxwedfF3MYXKqJfwu-Wt?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

Next, click on the “Edit” icon to the right of the Account name:

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXca43NGbsj5Abm-HIZJKrX4g_rm7DN4yx-PqUUJoYi8MEiHM4bmTY9H3xOAd1J4my8cuDo6TUQMi_0WzT5VL62-OKN3Y4-eXnI-UuxmOGR6cCi5rx0X-Iv0u7jcenuF145Bjpr9?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

At the bottom of the pop-up window, copy the value in the “API Key” field:

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXci8OWM1GOsvHoAf8z6vPTAxAAGxN29E34Rjud8SIa9cL2-PX3XgTEOhAFuud1K82Z_WH6M4nK-MRo-nuAoUv8rO4pd2J3Y85Vlh8BCtQtRmxyb1FgVYEgLglhccFcNpjmc-r_tbQ?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

This is the token to fill in the corresponding field in the Sherpa Assistant settings window:

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfcYJUYpAW2He_7y56aDDNcdDaEXRvhDiR5Qz9PMNtBtffars3NZWI7C-ljEhFpncJP2RQ9iogR3priWAhePJxE5DT5d-ZYclQ8qBlkUt9BMH98V_y7Cr8AVPlmH3q5nyfvRKBU2Q?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

#### Wiregeo Service

Wiregeo is a registration service used to verify the validity of the key during its activation. No additional settings are required, as the system automatically contacts this service.

#### Tesseract Service

Tesseract is a locally installed engine for text recognition. Its setup does not require special efforts. The User can choose to work with TesseractOCR in the Template Designer:

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf9GBf29l_hgoSdNhI8CCFrvIwGew2mExhGqR-6e50VQyp7vfZpTg6AS4HzdUgDotHkNMCH-JXGBaektd1UUZL0Iq83wCP06FbFmkzystMUgzL7fRP0vaPJ7nC4hAgWZj3kd4OjbQ?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

### Limits

A limit is the remaining monetary equivalent available to the User. The calculation is made individually for each service. You can check the limits in the “Services” tab in Sherpa Assistant:

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXePUV6O2YGBlNxn213VJbdJmGio96ZOyNsA4GnjZ9TP-ryqjpAJuBJAVg35vz4ifO0jkUjvfo95PVinvXU7RaD-iVGelOVvimyGfmV0tz124H2pPVrRYI8JkcC3WcZ_0AKm9TfS?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

For example, 1000 tokens for GPT-4 mini cost 8 kopecks, while for GPT-4 it costs about 5-6 rubles. If this is not enough for the User's tasks, you can contact [support](https://docs.sherparpa.ru/kontakty) to increase the current limit.

### Connection Timeout

Some services have a connection timeout, which is set in case the Task takes longer than the established time. It can be configured in the “Services” tab in Sherpa Assistant:

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXckOV1LrgYJd8kX12hzo52EoVlX1uHPj73z0hUBINrFfQuHK_x-bibeLROykcou7pF8m9_r1-NdW8FPLTF5V-FMTOB35QtJ_RpmNw6IQP-ymKlRwmIg7iROGBP0HvMDAZRzrx-N2A?key=6sbXsIGaTS3XX9nMXq1GDfiN" alt=""><figcaption></figcaption></figure>

For example, in this case, if the Task is not completed within 120 seconds, the Robot will not wait for a potential response and will continue working to avoid hanging.

#### Task Processing Options (Example)

The User can send a Task that the service must process and return a response within 60 seconds. In this case, there are three possible scenarios:

1. First option: The service processes the Task and returns a response quickly, for example, in 30 seconds;
2. Second option: The service hangs and remains in a state of infinite waiting (to interrupt it, a connection timeout is needed);
3. Third option: Mixed. The User sends a Task, the service executes it, but not within 60 seconds, but in 70. Not knowing the execution time, the User limits their waiting to avoid option 2.

Accordingly, a connection timeout of 60 seconds should be set in Sherpa Assistant.