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"
}

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 ви позволява да извлечете подробна информация за конкретен инструмент за средата на обаждане.

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