# Conexão de serviços de terceiros

1. Para conectar um dos 9 serviços de terceiros:

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

é necessário iniciar o programa Sherpa Assistant.

2. Em seguida, encontre o ícone do Sherpa Assistant na bandeja do sistema, clique com o botão direito do mouse sobre ele e selecione a opção “Configurações…” no menu suspenso:

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

3. Em seguida, vá para a aba “Serviços”:

<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>Por padrão, a maioria dos serviços de terceiros funciona através da plataforma Sherpa RPA, e identificação adicional não é necessária. Para verificar os limites restantes, clique no botão “Verificar limites”. Se as informações não forem exibidas, pode ser que os limites ainda não tenham sido utilizados, pois a contagem começa a partir do primeiro uso.</td></tr></tbody></table>

#### Configuração do token

Para conectar um serviço de terceiros, é necessário inserir o token na aba correspondente, que o Usuário recebe ao criar a conta. O Usuário cria o token por conta própria, consultando a documentação correspondente:

* Yandex Cloud

<https://yandex.cloud/ru/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>

Existem duas opções para preencher as configurações na aba “Yandex Cloud” da janela “Configurações - Sherpa Assistant”:

1. Preencher os campos “PasswordOauthToken” e “FolderId” (neste caso, o campo ApiKey não precisa ser preenchido):\
   PasswordOauthToken: Este é o token usado para autenticação do aplicativo ou usuário ao interagir com a API Yandex Cloud. Ele permite acessar recursos da nuvem protegidos pelo OAuth 2.0.\
   FolderId: Identificador único da pasta no Yandex Cloud, que serve para organizar e gerenciar recursos dentro do ambiente de nuvem. Cada projeto ou serviço pode ter sua própria pasta.
2. Preencher o campo “APIKey” (neste caso, os outros campos não precisam ser preenchidos):\
   ApiKey: Chave de acesso à API Yandex Cloud, que é usada para identificar e autenticar aplicativos ao acessar vários serviços da nuvem. Permite gerenciar recursos e fazer solicitações.

* Anti Captcha

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

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

É necessário preencher o campo “Anti Captcha Key” na aba “Anti Captcha” da janela “Configurações - Sherpa Assistant”:

Anti Captcha Key: Chave única da API fornecida pelo serviço Anti Captcha. Usada para autenticar solicitações ao serviço que resolve captchas, permitindo automatizar processos relacionados à sua superação.

* 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>

É necessário preencher o campo “Token” na aba “OpenAI” da janela “Configurações - Sherpa Assistant”:

Token: Esta é uma chave única usada para autenticação ao acessar a API OpenAI. O token permite autorizar solicitações aos modelos e serviços fornecidos pela 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>

É necessário preencher o campo “API Key” na aba “OCRSpace” da janela “Configurações - Sherpa Assistant”:

API Key: Chave única necessária para acessar a API OCRSpace, que fornece serviços de reconhecimento óptico de caracteres. É usada para autenticação e rastreamento do uso da API.

* Sherpa AI Server

<https://docs.sherparpa.ru/sherpa-ai-server/avtorizaciya-polzovatelya-v-sherpa-ai-server>

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

É necessário preencher os campos “Domínio do servidor / IP” e “Token” na aba “Sherpa AI Server” da janela “Configurações - Sherpa Assistant”:

1\. Domínio do servidor / IP: Domínio ou endereço IP pelo qual o Sherpa AI Server está acessível.

2\. Token: Token de autenticação usado para acessar o Sherpa AI Server. Ele garante que as solicitações sejam feitas por um Usuário autorizado.

* SberGigaChat

<https://developers.sber.ru/docs/ru/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>

É necessário preencher os campos “Client Id”, “Client Secret” e “Scope” na aba “Sber GigaChat” da janela “Configurações - Sherpa Assistant”:

1\. Client Id: Identificador único do cliente, usado para autenticação do aplicativo ao acessar a API Sber GigaChat. Permite que o sistema reconheça qual aplicativo está fazendo a solicitação.

2\. Client Secret: Chave secreta associada ao Client Id, que é usada para proteção adicional e autenticação da solicitação.

3\. Scope: Define a área de acesso solicitada pelo aplicativo durante a autenticação. Contém informações sobre quais recursos e funções da empresa terão acesso permitido.

* DaData

<https://support.dadata.ru/knowledge-bases/4/articles/2155-kak-poluchit-api-klyuch>

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

## É necessário preencher o campo “Token” na aba “DaData” da janela “Configurações - Sherpa Assistant”:--- description: "Documentação sobre a configuração de chaves de API para serviços integrados ao Sherpa Assistant."

Token: Chave única fornecida pelo serviço DaData para autenticação de solicitações à API. Permite usar as funções do serviço para validação e processamento de dados.

* 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>

É necessário preencher o campo “API Key” na aba “Claude” da janela “Configurações - Sherpa Assistant”:

API Key: Chave única que regula o acesso à API Claude. É usada para autenticação e restrição de acesso às funcionalidades fornecidas pelo sistema.

* 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>

É necessário preencher o campo “API Key” na aba “GroqChat” da janela “Configurações - Sherpa Assistant”:

API Key: Chave de acesso única, que é usada para autenticação e autorização de solicitações à API GroqChat. Permite identificar o aplicativo e controlar o nível de acesso aos recursos da plataforma.

Ao criar uma conta, não há requisitos específicos. O usuário recebe um token ou identificador dependendo do serviço escolhido. O sistema operacional do usuário não deve bloquear o acesso aos seguintes endereços:

* 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>Se a política de segurança da empresa proíbe o acesso, o usuário deve informar ao administrador do sistema sobre a necessidade de liberar o acesso para o funcionamento correto do sistema.</td></tr></tbody></table>

No momento da ativação da licença, o usuário recebe certos [limites](https://docs.google.com/document/d/1ewJMGZ-UbDUiokKFO-vQ6c9ypFfH4sfcQl_wS3Jg15U/edit?tab=t.0#heading=h.x4a9bk682hkd). (Por exemplo, para o serviço Yandex.Vision, é fornecido um valor de 300 rublos, o que é suficiente para testes/treinamento, considerando que o reconhecimento de uma página de documento custa 13 kopecks.) Se isso não for suficiente, é possível entrar em contato com o [suporte técnico](https://docs.sherparpa.ru/kontakty) para aumentar o limite atual.

Se for necessária a configuração de [VPN](https://disk.yandex.com/i/6z3Mmisu3Wc2eQ) para acessar a rede neural, o usuário deve configurá-la por conta própria. A VPN é configurada individualmente usando software de terceiros. Ou, o usuário pode rapidamente configurar um proxy diretamente no Sherpa Assistant.

#### Aplicativo Sherpa AI Server

Sherpa AI Server é um aplicativo web-service destinado ao treinamento, uso e re-treinamento de grandes modelos de linguagem (LLM) dentro do contorno fechado de corporações.

Para instalar o Sherpa AI Server, é necessário ter direitos de administrador. O nome de domínio é configurado diretamente durante a instalação do aplicativo. A ativação local do AI Server também ocorre lá. O aplicativo está disponível no navegador. Além da autorização local do usuário, o Sherpa AI Server também suporta autorização de domínio (via Active Directory, protocolos LDAP/LDAPS) e autorização OpenID.

O token é obtido diretamente no aplicativo web Sherpa AI Server na aba Contas. Para obtê-lo, é necessário selecionar uma Conta da lista proposta ou criar uma nova clicando no botão “Criar”:

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

Em seguida, clique no ícone “Editar” à direita do nome da Conta:

<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>

Na parte inferior da janela pop-up, copie o valor no campo “Chave API”:

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

Este é o token para preencher o campo correspondente na janela de configurações do Sherpa Assistant:

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

#### Serviço Wiregeo

Wiregeo é um serviço de registro que é usado para verificar a validade da chave durante sua ativação. Configurações adicionais não são necessárias, pois o sistema automaticamente se conecta a este serviço.

#### Serviço Tesseract

Tesseract é um mecanismo de reconhecimento de texto que é instalado localmente. Sua configuração não requer esforços especiais. O usuário pode escolher trabalhar com TesseractOCR no Templateador:

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

### Limites

Limite é o equivalente monetário restante disponível para o usuário. O cálculo é feito individualmente para cada serviço. Os limites podem ser verificados na aba “Serviços” no Sherpa Assistant:

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

Por exemplo, 1000 tokens para GPT-4 mini custam 8 kopecks, enquanto para GPT-4 custam cerca de 5-6 rublos. Se isso não for suficiente para as tarefas do usuário, é possível entrar em contato com o [suporte técnico](https://docs.sherparpa.ru/kontakty) para aumentar o limite atual.

### Timeout de Conexão

Alguns serviços têm um timeout de conexão, que é configurado caso a Tarefa leve mais tempo do que o estabelecido. Ele pode ser configurado na aba “Serviços” no 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>

Por exemplo, neste caso, se a Tarefa não for concluída em 120 segundos, o Robô não aguardará uma resposta potencial e continuará a trabalhar para evitar travamentos.

#### Opções de processamento de Tarefas (exemplo)

O usuário pode enviar uma Tarefa que o serviço deve processar e retornar uma resposta em 60 segundos. Nesse caso, existem três possíveis desdobramentos:

1. Primeira opção: O serviço processará a Tarefa e retornará a resposta rapidamente, por exemplo, em 30 segundos;
2. Segunda opção: O serviço travará e ficará em um estado de espera infinita (para interrompê-lo, é necessário um timeout de conexão);
3. Terceira opção: Mista. O usuário enviará a Tarefa, o serviço a executará, mas não em 60 segundos, e sim em 70. Sem saber o tempo de execução, o Usuário se limitará a esperar, para evitar a opção 2.

Portanto, deve-se definir um timeout de conexão de 60 segundos no Sherpa Assistant.


---

# Agent Instructions: 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:

```
GET https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-robot-i-sherpa-assistant/podklyuchenie-storonnikh-servisov.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.