Skip to main content
GET
/
user
/
tools
/
{id}
Вземи инструмент за средата на обаждане
curl --request GET \
  --url https://call.aiployees.com/api/user/tools/{id} \
  --header 'Accept: <accept>' \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>'
{
  "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"
}
Този endpoint ви позволява да извлечете подробна информация за конкретен инструмент за средата на обаждане.

​
Headers

​
Authorization
string
required
Bearer token за автентикация
​
Content-Type
string
required
Трябва да бъде application/json
​
Accept
string
required
Трябва да бъде application/json

​
Path Parameters

​
id
integer
required
Уникалният идентификатор на инструмента

​
Response fields

​
id
integer
Уникалният идентификатор на инструмента
​
name
string
Името на инструмента (с малки букви и долни черти)
​
description
string
Подробно обяснение на кога и как AI трябва да използва този инструмент
​
endpoint
string
URL адресът на API endpoint-а, който ще бъде извикан
​
method
string
HTTP метод (GET, POST, PUT, PATCH, DELETE)
​
timeout
integer
Таймаут на заявката в секунди (1-30)
​
headers
array
HTTP headers за изпращане със заявката
​
schema
array
Параметри, които AI ще извлече и изпрати към endpoint-а
​
created_at
string
ISO 8601 timestamp кога е създаден инструментът
​
updated_at
string
ISO 8601 timestamp кога е последно обновен инструментът
{
  "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"
}

​
Присвояване на инструменти към асистенти

За да използвате този инструмент с асистент, вижте:
  • Създай асистент - Прикачете инструменти използвайки параметъра tool_ids
  • Обнови асистент - Управлявайте присвоявания на инструменти използвайки параметъра tool_ids