Довідник інструментів AI-агента

Повний довідник усіх 12 інструментів AI-агента, доступних у Vartovii.

Короткий опис інструментів

Корпоративний інтелект (6 інструментів)

Інструмент	Призначення	Параметри
search_company	Знайти компанію в базі даних	company_name, country?
get_trust_score	Детальний розподіл Trust Score	company_name
list_companies	Рейтинг найкращих роботодавців	country?, limit?, sort_by?
compare_companies	Порівняти двох роботодавців	company1, company2
run_analysis	Розпочати аналіз для нової компанії	company_name, country?, category?
get_company_reviews	Показати зразки відгуків	company_name, sentiment?, limit?

Криптоінтелект (2 інструменти)

Інструмент	Призначення	Параметри
search_crypto_projects	Знайти криптопроєкти	query
get_crypto_trust_score	Отримати Crypto Trust Score	slug

Форензік-агент (4 інструменти)

Інструмент	Призначення	Параметри
check_wallet	Перевірити баланс ETH	address
get_transaction_history	Отримати транзакції гаманця	address, limit?, days?
get_token_holders	Розподіл власників токенів	contract_address, limit?
get_contract_info	Перевірити смарт-контракт	contract_address

---

1. search_company

Пошук компанії в базі даних.

Параметри

Назва	Тип	Обов'язковий	Опис
company_name	string	✅	Назва компанії для пошуку
country	string	❌	Код країни (de, at, ch)

Приклад

User: "Find BMW company"

Відповідь

{
  "found": true,
  "company_name": "BMW",
  "trust_score": 71,
  "avg_rating": 3.97,
  "review_count": 5621,
  "sentiment_positive": 50,
  "sentiment_negative": 50,
  "data_freshness": "fresh (< 7 days)"
}

---

2. get_trust_score

Отримати детальний Trust Score з розбивкою.

Параметри

Назва	Тип	Обов'язковий	Опис
company_name	string	✅	Назва компанії

Відповідь

{
  "company_name": "BMW",
  "trust_score": 71,
  "risk_level": "MEDIUM",
  "breakdown": {
    "rating_quality": 23.8,
    "sentiment": 12.5,
    "volume": 20,
    "consistency": 10,
    "recency": 5
  }
}

---

3. list_companies

Отримати рейтинг найкращих роботодавців за Trust Score.

Параметри

Назва	Тип	Обов'язковий	За замовчуванням	Опис
country	string	❌	all	Фільтрувати за країною
limit	integer	❌	10	Кількість компаній
sort_by	string	❌	trust_score	Поле сортування

Приклад

User: "Show top 5 companies"

Відповідь

Повертає список компаній, що містить:

• Назва компанії
• Trust Score
• Кількість відгуків
• Середній рейтинг

---

4. compare_companies

Порівняти двох роботодавців поруч.

Параметри

Назва	Тип	Обов'язковий	Опис
company1	string	✅	Перша компанія
company2	string	✅	Друга компанія

Приклад

User: "Compare BMW and Audi"

Відповідь

{
  "company1": {
    "name": "BMW",
    "trust_score": 71,
    "review_count": 5621,
    "avg_rating": 3.97
  },
  "company2": {
    "name": "Audi",
    "trust_score": 57,
    "review_count": 1243,
    "avg_rating": 3.45
  },
  "winner": "BMW",
  "score_difference": 14
}

---

5. run_analysis

Розпочати збір даних та аналіз для НОВОЇ компанії.

Магічний пошук Цей інструмент запускає нашу систему "Магічний пошук", яка

здійснює пошук у Kununu, розпочинає збір даних з багатьох джерел та створює повний аналіз. :::

Параметри

Назва	Тип	Обов'язковий	За замовчуванням	Опис
company_name	string	✅	-	Компанія для аналізу
country	string	❌	de	Код країни

Приклад

User: "Analyze Spotify company"

Відповідь

{
  "action": "analysis_started",
  "company_name": "Spotify",
  "company_slug": "spotify-ab1",
  "scraping_jobs": ["job-1", "job-2", "job-3", "job-4"],
  "message": "🚀 Analysis started! Check back in 5-10 minutes."
}

Запущені типи завдань

1. Kununu - Основне джерело відгуків
2. Google Reviews - Рейтинги компаній
3. Reddit - Обговорення співробітників
4. Indeed Vacancies - Дані ринку праці

---

6. get_company_reviews

Отримати зразки відгуків співробітників.

Параметри

Назва	Тип	Обов'язковий	За замовчуванням	Опис
company_name	string	✅	-	Назва компанії
sentiment	string	❌	all	Фільтр: позитивні, негативні, всі
limit	integer	❌	5	Кількість відгуків (макс. 10)

Приклад

User: "Show reviews for BMW"

Відповідь

{
  "company_name": "BMW",
  "reviews": [
    {
      "text": "👍 Great work-life balance, interesting projects...",
      "rating": 4.5,
      "sentiment": "POSITIVE",
      "source": "kununu"
    },
    {
      "text": "👎 Management could be better, communication issues...",
      "rating": 2.5,
      "sentiment": "NEGATIVE",
      "source": "kununu"
    }
  ],
  "summary": {
    "total": 5,
    "positive": 3,
    "negative": 2
  }
}

---

Ключові слова для активації

AI-агент автоматично активується, коли виявляє ці ключові слова:

English

• company, employer, find, search, compare
• trust score, rating, top, best, worst
• analyze, reviews, analysis

Ukrainian

• компанія, роботодавець, знайди, пошук
• траст скор, рейтинг, топ, порівняй
• проаналізуй, відгуки, аналіз

7. search_crypto_projects

Пошук криптовалютних проєктів у базі даних.

Параметри

Назва	Тип	Обов'язковий	Опис
query	string	✅	Назва проєкту, символ або slug (наприклад, "Bitcoin", "BTC", "Solana")

Приклад

User: "Find Solana project"

Відповідь

{
  "found": true,
  "count": 1,
  "results": [
    {
      "slug": "solana",
      "name": "Solana",
      "symbol": "SOL",
      "price_usd": 102.5,
      "market_cap": 45123456789,
      "trust_score": 85,
      "risk_level": "LOW"
    }
  ],
  "message": "Found 1 project matching 'Solana'. Use the slug for detailed analysis."
}

---

8. get_crypto_trust_score

Отримати повний Trust Score та дані проєкту для криптопроєкту.

Параметри

Назва	Тип	Обов'язковий	Опис
slug	string	✅	Slug проєкту з результатів пошуку (наприклад, "solana", "bitcoin")

Відповідь

{
  "found": true,
  "name": "Solana",
  "symbol": "SOL",
  "slug": "solana",
  "price_usd": 102.5,
  "market_cap": 45123456789,
  "fdv": 55000000000,
  "trust_score": 85,
  "risk_level": "LOW",
  "score_breakdown": {
    "treasury": 75,
    "dev_activity": 90,
    "financials": 85,
    "security": 80,
    "tokenomics": 88,
    "community": 82
  },
  "treasury_usd": 12500000,
  "runway_months": 25,
  "github_org": "solana-labs",
  "commits_last_30d": 450,
  "active_devs": 35
}

---

9. check_wallet

Перевірити баланс ETH для будь-якої адреси Ethereum-гаманця.

Параметри

Назва	Тип	Обов'язковий	Опис
address	string	✅	Адреса Ethereum (0x...)

Приклад

User: "Check balance of 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

Відповідь

{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "eth_balance": 32.1112,
  "usd_value": 94241.62,
  "found": true,
  "chain": "ethereum",
  "etherscan_link": "https://etherscan.io/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}

---

10. get_transaction_history

Отримати історію останніх транзакцій для адреси гаманця.

Параметри

Назва	Тип	Обов'язковий	За замовчуванням	Опис
address	string	✅	-	Адреса Ethereum
limit	integer	❌	10	Максимальна кількість транзакцій для повернення
days	integer	❌	30	Період перегляду

Приклад

User: "Show transactions for 0xd8dA... in last 30 days"

Відповідь

{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "transactions": [
    {
      "hash": "0x123...",
      "from": "0xabc...",
      "to": "0xd8dA...",
      "value_eth": 2.5,
      "value_usd": 7334.15,
      "timestamp": "2026-01-20T10:30:00Z",
      "direction": "in"
    }
  ],
  "count": 5,
  "etherscan_link": "https://etherscan.io/address/0xd8dA...#transactions"
}

---

11. get_token_holders

Аналіз розподілу власників токенів ERC20.

Параметри

Назва	Тип	Обов'язковий	За замовчуванням	Опис
contract_address	string	✅	-	Адреса контракту токена ERC20
limit	integer	❌	20	Максимальна кількість власників для повернення

Приклад

User: "Top holders of USDT"

Відповідь

{
  "contract_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
  "token_symbol": "USDT",
  "token_price_usd": 0.998,
  "holders": [
    {
      "rank": 1,
      "address": "0xf977814e90da44bfa03b6295a0616a897441acec",
      "balance": "21,951,179,974.29 USDT",
      "balance_usd": 21925650751.98,
      "percentage": 18.5
    }
  ],
  "count": 20,
  "total_supply": 118490426863.74,
  "etherscan_link": "https://etherscan.io/token/0xdac17f..."
}

---

12. get_contract_info

Перевірити деталі та тип смарт-контракту.

Параметри

Назва	Тип	Обов'язковий	Опис
contract_address	string	✅	Адреса смарт-контракту

Приклад

User: "Is 0xdAC17F... an ERC20 contract?"

Відповідь

{
  "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
  "found": true,
  "is_erc20": true,
  "is_erc721": false,
  "deployed_at": "2017-11-28T00:41:21+00:00",
  "has_bytecode": true,
  "contract_type": "ERC20 Token",
  "etherscan_link": "https://etherscan.io/address/0xdac17f..."
}

---

Ключові слова для активації

AI-агент автоматично активується, коли виявляє ці ключові слова:

English

• Corporate: company, employer, find, search, compare
• Crypto: crypto, token, coin, price, market cap, project
• Forensic: wallet, address, balance, transaction, holder, contract, 0x
• Analysis: trust score, rating, top, best, worst, analyze, reviews

Ukrainian

• Корпоративні: компанія, роботодавець, знайди, пошук, порівняй
• Крипто: крипта, токен, монета, ціна, проект
• Форензік: гаманець, адреса, баланс, транзакції, контракт
• Аналіз: траст скор, рейтинг, топ, проаналізуй, відгуки