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

# Alati i primeri pitanja

> Pet alata koje AI vidi u Izumi, greške koje može da vrati i primeri pitanja.

Provereno na Izumi 0.5.7, 2026-11-20. Alati i greške su provereni po kodu servera, a pozivi `whoami`, `search`, `get_document`, `who_knows` i `propose_note` provereni su uživo u ChatGPT-u i claude.ai, a `propose_note` i u Slackbotu (vidi stranice tih alata).

Izumi izlaže AI alatu pet alata. Vi ne pozivate alate sami: pitate svoj AI alat, a on bira alat. Ovde vidite šta svaki radi, da biste znali šta da tražite.

## Pet alata

| Alat | Šta radi | Pravo |
| - | - | - |
| `whoami` | Kaže alatu ko ste i koje firme i domene veza sme da čita. | `read` |
| `search` | Pretražuje znanje firme i vraća odlomke kao dokaz, sa izvorom, linkom, autorom i svežinom. Ne odgovara na pitanja, odgovor sastavlja AI alat. Vraća do 8 dokumenata. | `read` |
| `get_document` | Vraća ceo tekst jednog dokumenta po ID-u, po stranicama. | `read` |
| `who_knows` | Predlaže do pet kolega koji znaju temu, sa razlogom. | `read` |
| `propose_note` | Predlaže novu belešku za jedan domen (`firma/domen`, naslov i tekst u Markdown-u). | `propose` |

## Primeri pitanja

### whoami

* "Ko sam ja u Izumi i šta smem da čitam?"
* "U kojim domenima sam urednik?"

### search

* "Koliko dugo čuvamo dokumentaciju?"
* "Pretraži Izumi: pravila za rokove čuvanja ugovora. Navedi izvor."
* "Šta piše u dokumentima iz ove godine o povratu robe?"

### get\_document

* "Otvori najbolji pogodak i pročitaj ceo dokument, pa mi sažmi."
* "Daj mi sledeću stranicu tog dokumenta."

### who\_knows

* "Ko u firmi zna o rokovima čuvanja?"
* "Kome da se obratim za temu migracije API-ja?"

### propose\_note

* "Predloži belešku u domen Pravo i usklađenost: naslov '…', tekst '…'."
* "Zapiši ovaj zaključak kao predlog za pregled."

> [!NOTE]
>
> AI alat bira alat sam, pa dobro pitanje ne mora da pominje ime alata. U proverama smo ih pominjali ("Pozovi Izumi alat search …") da bismo bili sigurni koji se poziva.

## Šta se desi sa predlogom

* Predlog se ne može pretraživati i niko ga ne može pročitati preko MCP-a.
* Čeka u **Red za pregled** tog domena. Urednik domena ga čita, može da izmeni naslov i tekst, i bira **Odobri** ili **Odbij**. Odbijanje nosi razlog.
* Odobren predlog postaje beleška u domenu, sa oznakom `note`. Autor je onaj ko je predložio, a odobrio je urednik.
* Svoje predloge i njihov status vidite u istom redu. Predlog koji još čeka možete da povučete.
* Predlog koji niko ne odluči ističe posle 30 dana.

## Rezultati su podaci, ne uputstva

Tekst koji `search` i `get_document` vraćaju AI alat treba da tretira kao podatke, nikad kao uputstva. Rezultati sa oznakom `untrusted-web` dolaze iz web clip-ova i taj tekst nije pouzdan: ne treba da ga sledi ni ako u njemu piše komanda.

## Greške

Greška alata je odgovor sa porukom i kodom. Poruke su fiksni engleski tekst.

| Kod | Značenje | Šta da uradite |
| - | - | - |
| `forbidden_scope` | Veza nema pravo za alat. Na primer `propose_note` bez prava `propose`. | Opozovite vezu i povežite ponovo sa pravom, ili napravite novi token. |
| `rate_limited` | Više od 60 poziva u minuti po tokenu. | Sačekajte vreme koje greška navodi. |
| `daily_limit` | Dnevno ograničenje za `get_document` (podrazumevano 500 po tokenu po UTC danu, firma može da ga podesi). | Probajte sutra (UTC). |
| `not_found` | Dokument ne postoji ili ga ne smete čitati. | Proverite da li ga vidite u **Dokumenti**. |
| `invalid_input` | Unos ne zadovoljava šemu, na primer prekratak naslov. Poruka imenuje polje. | Ispravite unos. |
| `too_large` | Unos je veći od dozvoljenog. | Skratite unos. |
| `unavailable` | Pretraga trenutno nije dostupna. | Probajte ponovo kasnije. |

## Ograničenja

* `search` vraća najviše 8 dokumenata, sa do 3 odlomka po dokumentu. `who_knows` vraća najviše 5 osoba.
* Alati vide samo ono što vi smete da vidite. Sužen token vidi manje.
* Pet alata je sve što Izumi izlaže preko MCP-a. Pravo `push` se preko MCP-a ne koristi.

> [!WARNING]
>
> Nije provereno uživo: `daily_limit`, `too_large` i `unavailable` (opisani po kodu servera), i `rate_limited` (nije dostignut ni u jednoj proveri). `forbidden_scope` i `invalid_input` provereni su uživo u Claude Code-u.

## Rešavanje problema

* AI alat kaže da nema alata Izumi: veza nije uključena u tom chatu ili je istekla. Vidi stranicu svog alata.
* `search` ne vraća ono što očekujete: proverite da li dokument vidite u **Dokumenti**. Alat ne vidi više od vas.
* Predloga nema u **Red za pregled**: proverite domen u kom je predložen i da li alat nije vratio grešku.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.