> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suasofia.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter ferramenta utilizadas durante a chamada

> Recuperar uma ferramenta utilizadas durante a chamada específica por ID

Este endpoint permite que você recupere informações detalhadas sobre uma ferramenta utilizadas durante a chamada específica.

### Cabeçalhos

<ParamField header="Authorization" type="string" required>
  Token Bearer para autenticação
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Deve ser `application/json`
</ParamField>

<ParamField header="Accept" type="string" required>
  Deve ser `application/json`
</ParamField>

### Parâmetros de Caminho

<ParamField path="id" type="integer" required>
  O identificador único da ferramenta
</ParamField>

### Campos de resposta

<ResponseField name="id" type="integer">
  O identificador único da ferramenta
</ResponseField>

<ResponseField name="name" type="string">
  O nome da ferramenta (minúsculas com sublinhados)
</ResponseField>

<ResponseField name="description" type="string">
  Explicação detalhada de quando e como a IA deve usar esta ferramenta
</ResponseField>

<ResponseField name="endpoint" type="string">
  A URL do endpoint da API que será chamado
</ResponseField>

<ResponseField name="method" type="string">
  Método HTTP (GET, POST, PUT, PATCH, DELETE)
</ResponseField>

<ResponseField name="timeout" type="integer">
  Timeout da solicitação em segundos (1-30)
</ResponseField>

<ResponseField name="headers" type="array">
  Cabeçalhos HTTP para enviar com a solicitação

  <Expandable title="propriedades de header">
    <ResponseField name="name" type="string">
      Nome do cabeçalho
    </ResponseField>

    <ResponseField name="value" type="string">
      Valor do cabeçalho
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="schema" type="array">
  Parâmetros que a IA extrairá e enviará para o endpoint

  <Expandable title="propriedades de schema">
    <ResponseField name="name" type="string">
      Nome do parâmetro
    </ResponseField>

    <ResponseField name="type" type="string">
      Tipo do parâmetro (string, number, boolean)
    </ResponseField>

    <ResponseField name="description" type="string">
      Descrição para ajudar a IA a entender como extrair este parâmetro
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="created_at" type="string">
  Timestamp ISO 8601 de quando a ferramenta foi criada
</ResponseField>

<ResponseField name="updated_at" type="string">
  Timestamp ISO 8601 de quando a ferramenta foi atualizada pela última vez
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  {
    "id": 1,
    "name": "get_weather",
    "description": "Use esta ferramenta para obter o clima atual em uma cidade específica. Chame isto quando o cliente perguntar sobre condições climáticas.",
    "endpoint": "https://api.openweathermap.org/data/2.5/weather",
    "method": "GET",
    "timeout": 10,
    "headers": [
      {
        "name": "Content-Type",
        "value": "application/json"
      },
      {
        "name": "Authorization",
        "value": "Bearer sk_..."
      }
    ],
    "schema": [
      {
        "name": "city",
        "type": "string",
        "description": "O nome da cidade para obter o clima"
      },
      {
        "name": "temperature",
        "type": "number",
        "description": "Valor da temperatura atual"
      },
      {
        "name": "is_raining",
        "type": "boolean",
        "description": "Se está chovendo atualmente"
      }
    ],
    "created_at": "2025-10-10T12:00:00.000000Z",
    "updated_at": "2025-10-10T12:00:00.000000Z"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "message": "Ferramenta não encontrada"
  }
  ```
</ResponseExample>

### Atribuindo Ferramentas a Assistentes

Para usar esta ferramenta com um assistente, veja:

* **[Criar Assistente](/api-reference/assistants/create-assistant)** - Anexe ferramentas usando o parâmetro `tool_ids`
* **[Atualizar Assistente](/api-reference/assistants/update-assistant)** - Gerencie atribuições de ferramentas usando o parâmetro `tool_ids`