Conexão de serviços de terceiros#
- 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.
- 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:
- Em seguida, vá para a aba “Serviços”:
 | 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. |
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/
Existem duas opções para preencher as configurações na aba “Yandex Cloud” da janela “Configurações - Sherpa Assistant”:
- 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. - 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
É 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
É 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
É 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
É 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
É 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
É 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
É 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
É 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
- Yandex
https://ocr.api.cloud.yandex.net
- Anti Captcha
- OpenAI
- OCR Space
- SberGigaChat
- DaData
- Claude
- GroqChat
| 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. |
No momento da ativação da licença, o usuário recebe certos limites. (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 para aumentar o limite atual.
Se for necessária a configuração de VPN 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”:
Em seguida, clique no ícone “Editar” à direita do nome da Conta:
Na parte inferior da janela pop-up, copie o valor no campo “Chave API”:
Este é o token para preencher o campo correspondente na janela de configurações do Sherpa Assistant:
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:
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:
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 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:
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:
- Primeira opção: O serviço processará a Tarefa e retornará a resposta rapidamente, por exemplo, em 30 segundos;
- 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);
- 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.