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

# Списък с инструменти по време на разговор

> Извличане на всички инструменти по време на разговор

Този endpoint ви позволява да извлечете всички инструменти по време на разговор. Инструментите по време на разговор позволяват на вашите AI асистенти да взаимодействат с външни API-та по време на разговор.

### Заглавки

<ParamField header="Authorization" type="string" required>
  Bearer token за удостоверяване
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Трябва да бъде `application/json`
</ParamField>

<ParamField header="Accept" type="string" required>
  Трябва да бъде `application/json`
</ParamField>

### Полета в отговора

<ResponseField name="data" type="array">
  Масив от инструменти по време на разговор

  <Expandable title="properties">
    <ResponseField name="id" type="integer">
      Уникалният идентификатор на инструмента
    </ResponseField>

    <ResponseField name="name" type="string">
      Името на инструмента (малки букви с долни черти)
    </ResponseField>

    <ResponseField name="description" type="string">
      Подробно обяснение кога и как AI трябва да използва този инструмент
    </ResponseField>

    <ResponseField name="endpoint" type="string">
      API endpoint URL, който ще бъде извикан
    </ResponseField>

    <ResponseField name="method" type="string">
      HTTP метод (GET, POST, PUT, PATCH, DELETE)
    </ResponseField>

    <ResponseField name="timeout" type="integer">
      Timeout на заявката в секунди (1-30)
    </ResponseField>

    <ResponseField name="headers" type="array">
      HTTP заглавки за изпращане със заявката

      <Expandable title="header properties">
        <ResponseField name="name" type="string">
          Име на заглавката
        </ResponseField>

        <ResponseField name="value" type="string">
          Стойност на заглавката
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="schema" type="array">
      Параметри, които AI ще извлече и изпрати към endpoint-a

      <Expandable title="schema properties">
        <ResponseField name="name" type="string">
          Име на параметъра
        </ResponseField>

        <ResponseField name="type" type="string">
          Тип на параметъра (string, number, boolean)
        </ResponseField>

        <ResponseField name="description" type="string">
          Описание, което помага на AI да разбере как да извлече този параметър
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp кога е създаден инструментът
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp кога е последно актуализиран инструментът
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  [
    {
      "id": 1,
      "name": "get_weather",
      "description": "Use this tool to get the current weather in a specific city. Call this when the customer asks about weather conditions.",
      "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": "The city name to get weather for"
        },
        {
          "name": "temperature",
          "type": "number",
          "description": "Current temperature value"
        },
        {
          "name": "is_raining",
          "type": "boolean",
          "description": "Whether it is currently raining"
        }
      ],
      "created_at": "2025-10-10T12:00:00.000000Z",
      "updated_at": "2025-10-10T12:00:00.000000Z"
    },
    {
      "id": 2,
      "name": "send_notification",
      "description": "Use this tool to send a notification to the customer. Call this when customer requests updates.",
      "endpoint": "https://api.yourcompany.com/notifications/send",
      "method": "POST",
      "timeout": 15,
      "headers": [
        {
          "name": "Content-Type",
          "value": "application/json"
        }
      ],
      "schema": [
        {
          "name": "message",
          "type": "string",
          "description": "The notification message to send"
        },
        {
          "name": "priority_level",
          "type": "number",
          "description": "Priority level from 1 to 5"
        },
        {
          "name": "send_sms",
          "type": "boolean",
          "description": "Whether to also send SMS notification"
        }
      ],
      "created_at": "2025-10-09T14:30:00.000000Z",
      "updated_at": "2025-10-10T09:15:00.000000Z"
    }
  ]
  ```
</ResponseExample>

### Присвояване на инструменти на асистенти

За да използвате тези инструменти с асистенти, вижте:

* **[Създаване на асистент](/api-reference/assistants/create-assistant)** - Прикачете инструменти използвайки параметъра `tool_ids`
* **[Актуализиране на асистент](/api-reference/assistants/update-assistant)** - Управлявайте присвояванията на инструменти използвайки параметъра `tool_ids`

***