# Solicitação ao GroqChat

Este bloco permite enviar solicitações aos modelos generativos do GroqChat. Com ele, você pode criar novos textos sob demanda, realizar diversas tarefas:

* classificação,
* sumarização,
* tradução e reescrita de textos,
* escrita de protótipos de código em diferentes linguagens de programação,
* analisar dados semi-estruturados e não estruturados,
* extrair e processar fatos,
* manter diálogos sobre diversos temas, e muito mais.

O pagamento pelo uso dessa funcionalidade é debitado da conta do cliente na plataforma. Para fins de teste, cada novo Usuário tem a oportunidade de testar essa funcionalidade sem custo. Após a conclusão do desenvolvimento do Robô, o uso dessa funcionalidade requer pagamento.

<table data-header-hidden><thead><tr><th width="306.81671142578125" valign="top"></th><th width="322.44989013671875" valign="top"></th></tr></thead><tbody><tr><td valign="top">Histórico de chat</td><td valign="top"><p>[Tabela de Dados] Adicione o histórico de chat, com base no contexto do qual a rede neural deve gerar uma resposta. A tabela de dados especificada deve conter colunas com os nomes "role" e "content".</p><p>Na ausência dessas colunas, a primeira coluna da tabela será usada como "role" e a segunda coluna como "content". Na coluna "role", você pode indicar apenas um dos seguintes valores:</p><ul><li>system,</li><li>assistant,</li><li>user.</li></ul><p>A função system é destinada a configurar o tom e as configurações básicas da rede neural, por exemplo:</p><ul><li>com a função "system", você pode escrever <code>"You are helpful assistant on used cars selection. You know everything on how to choose the best deal for used car"</code>,</li><li>com a função "assistant", é recomendado incluir mensagens anteriores geradas pela própria rede neural,</li><li>com a função "user", é recomendado incluir falas escritas pelo usuário interlocutor.</li></ul><p>Mensagens mais antigas devem ser colocadas no início da tabela, as mais novas no final. A coluna "content" deve conter a própria mensagem.</p><p>Essa propriedade pode ser deixada em branco, então a geração será realizada apenas com base no conteúdo das propriedades "Role" e "Request".</p><p>Se a propriedade "Tools" for utilizada, a tabela deve ter 4 colunas:</p><ul><li>"role",</li><li>"content",</li><li>"tool_call_id",</li><li>"name".</li></ul></td></tr><tr><td valign="top">Solicitação System</td><td valign="top">[Texto] Insira o texto de uma nova solicitação à rede neural. A solicitação será executada com a função system.</td></tr><tr><td valign="top">Solicitação User</td><td valign="top">[Texto] Insira o texto de uma nova solicitação à rede neural. A solicitação será executada com a função user.</td></tr><tr><td valign="top">Modelo</td><td valign="top">Selecione o modelo para gerar a resposta.</td></tr><tr><td valign="top">Palavras de parada</td><td valign="top">[Texto/Lista] String ou lista contendo no máximo 4 strings que interromperão a geração subsequente. O texto retornado não conterá essas palavras.</td></tr><tr><td valign="top">Temperatura</td><td valign="top"><p>[Número] Número decimal entre 0 e 1, que indica o grau de "aleatoriedade" ou "criatividade" do resultado, onde:</p><ul><li>0 - resultado menos criativo,</li><li>1 - resultado mais aleatório.</li></ul><p>Para a maioria das tarefas criativas, o valor 0.7 é mais adequado, e se você deseja receber a mesma resposta para a mesma solicitação a cada vez - defina o valor como 0.</p></td></tr><tr><td valign="top">Comprimento máximo</td><td valign="top"><p>[Número] Comprimento máximo do resultado, expresso em tokens condicionais.</p><p>Para o inglês, 1 token é 4 caracteres, para a maioria das outras línguas, 1 token é 1 caractere.</p><p>Reduza esse número se quiser receber, em média, solicitações mais curtas, aumente para obter solicitações mais longas. Lembre-se de que esse número limita o comprimento da resposta, no entanto, a resposta obtida pode não ter o comprimento especificado por você - dependendo do conteúdo da solicitação, ela pode ser mais curta.</p></td></tr><tr><td valign="top">Auto-limitação de comprimento</td><td valign="top">Quando ativado, o comprimento máximo especificado será automaticamente ajustado. Para isso, é calculado o número de tokens na solicitação e considerado o número máximo possível de tokens para o modelo selecionado.</td></tr><tr><td valign="top">Ferramentas</td><td valign="top"><p>[Tabela de Dados] Tabela com a descrição das ferramentas que a rede neural pode escolher para resolver a tarefa em vez de uma resposta textual. Essa funcionalidade não é suportada por todos os modelos.</p><p>A tabela de dados deve conter três colunas:</p><ul><li>"name" - nome da ferramenta (letras latinas e números, no máximo 64 caracteres),</li><li>"description" - descrição da ferramenta (pode estar em idiomas diferentes do inglês),</li><li>"parameters" - argumentos passados para a ferramenta ao chamá-la no formato JSON.</li></ul><p>Exemplo de descrição JSON dos parâmetros: <code>"{\"type\": \"object\", \"properties\": { \"query\": { \"type\": \"string\", \"description\": \"Request for a Google search result\" } }, \"required\": [\"query\"] }"</code>.</p><p>Ao chamar a ferramenta, a rede neural escolherá a ferramenta apropriada entre as disponíveis, com base na descrição das ferramentas que você forneceu, e também preencherá (gerará) os valores dos parâmetros que você especificou para chamar essas ferramentas.</p><p>Mais detalhes sobre o mecanismo de uso das ferramentas podem ser encontrados na descrição da propriedade de saída CalledTools.</p></td></tr><tr><td valign="top">Timeout</td><td valign="top"><p>[Número] Tempo máximo de espera pela resposta em segundos. O tempo real de espera depende do modelo selecionado, do comprimento da sua solicitação e do comprimento previsto da resposta, bem como da carga atual dos servidores.</p><p>Se o limite de espera for excedido, ocorre um erro.</p></td></tr><tr><td valign="top">Esquema de resposta</td><td valign="top">[Texto] Esquema de resposta no formato JSON. Por exemplo:<br>{<br>"name": "weather",<br>"strict": true,<br>"schema": {<br>"type": "object",<br>"properties": {<br>"location": {<br>"type": "string",<br>"description": "Nome da cidade ou local"<br>},<br>"temperature": {<br>"type": "number",<br>"description": "Temperatura em Celsius"<br>},<br>"conditions": {<br>"type": "string",<br>"description": "Descrição das condições climáticas"<br>}<br>},<br>"required": ["location", "temperature", "conditions"],<br>"additionalProperties": false<br>}<br>}</td></tr><tr><td valign="top">Número de tentativas</td><td valign="top">[Número] Número de tentativas em caso de erro de conexão com o servidor.</td></tr><tr><td valign="top">Papel da resposta</td><td valign="top">[Texto] Papel com o qual a rede neural respondeu.</td></tr><tr><td valign="top">Resposta</td><td valign="top">[Texto] Texto da resposta da rede neural.</td></tr><tr><td valign="top">Reflexões</td><td valign="top">[Texto] Reflexões da rede neural (se houver no resposta).</td></tr><tr><td valign="top">Comprimento total</td><td valign="top">[Número] Comprimento total da solicitação e do resultado (juntos), expresso em tokens condicionais.</td></tr><tr><td valign="top">Ferramentas chamadas</td><td valign="top"><p>[Lista] Lista de objetos ToolItem.</p><p>Se a rede neural, após a solicitação, em vez de uma resposta textual, sugerir usar uma ou mais ferramentas especificadas na propriedade "Ferramentas", então esta propriedade retornará uma lista de objetos ToolItem.</p><p>O objeto contém as seguintes propriedades:</p><ul><li>id,</li><li>name,</li><li>arguments.</li></ul><p>Os valores de id e name devem ser usados na tabela "Histórico de chat". A propriedade arguments é um dicionário, onde a chave é o nome do parâmetro da ferramenta chamada, e o valor é o valor gerado pela rede neural para esse parâmetro.</p><p>Ao usar o mecanismo de ferramentas, após a chamada deste bloco, você deve verificar se a rede neural selecionou alguma ferramenta, com base no conteúdo desta lista.</p><p>Se a lista não estiver vazia, você deve implementar a funcionalidade da ferramenta ou ferramentas selecionadas no script do Robô e, em seguida, na próxima chamada deste bloco, retornar à rede neural o resultado da execução da ferramenta, que a rede neural usará na geração de mensagens subsequentes.</p><p>O resultado da execução das ferramentas deve ser registrado na tabela "Histórico de chat" da seguinte forma:</p><ul><li>na coluna "role" é registrado o valor constante "tool",</li><li>na coluna "content" - o valor do resultado da execução da ferramenta (que você implementou em seu script e agora comunica esse resultado à rede neural),</li><li>na coluna "tool_call_id" - o valor do ToolItem.id atual,</li><li>na coluna "name" - o valor do ToolItem.name atual.</li></ul></td></tr><tr><td valign="top">Nível de processamento</td><td valign="top"><p>Seleção do nível de tratamento de erros. Valores possíveis:</p><ul><li>"Default" - padrão;</li><li>"Ignore" - erros são ignorados;</li><li>"Handle" - erros são tratados.</li></ul><p>Se o valor "Default" for selecionado, será utilizado o valor do bloco "Início" deste diagrama.</p></td></tr><tr><td valign="top">Nível de mensagens</td><td valign="top"><p>Seleção do nível de mensagens que os blocos exibirão durante a operação. Valores possíveis:</p><ul><li>"Default" - padrão;</li><li>"Release" - saída desativada;</li><li>"Debug" - saída de informações principais;</li><li>"Detailed" - saída de informações detalhadas.</li></ul><p>Se o valor "Default" for selecionado, será utilizado o valor do bloco "Início" deste diagrama.</p></td></tr><tr><td valign="top">Texto do erro</td><td valign="top">[Texto] Retorna informações detalhadas sobre o erro em caso de execução incorreta do bloco.</td></tr></tbody></table>


---

# 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-designer/spravochnik-blokov/mashinnoe-obuchenie-machine-learning/zapros-k-groqchat-groqchatrequest.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.
