> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Perplexity

## Omówienie

Połącz agentów AI ElevenLabs z Perplexity, aby podczas rozmów odpowiadali na pytania na podstawie aktualnych informacji z sieci. Agenci mogą zadać pytanie i otrzymać krótką odpowiedź popartą cytowanymi źródłami albo bezpośrednio przeszukać sieć w poszukiwaniu stron i artykułów. Użyj tej integracji, aby oprzeć odpowiedzi na informacjach nowszych niż wiedza agenta.

## Konfiguracja

Ta integracja używa do uwierzytelniania **klucza API Perplexity**.

#### Utwórz konto Perplexity

Załóż konto na [perplexity.ai](https://www.perplexity.ai), jeśli jeszcze go nie masz.

#### Dodaj metodę płatności

Perplexity rozlicza użycie API w modelu pay-as-you-go. Dodaj metodę płatności w [konsoli API](https://console.perplexity.ai), zanim wygenerujesz klucz.

#### Wygeneruj klucz API

Przejdź do [console.perplexity.ai/project/keys](https://console.perplexity.ai/project/keys) i utwórz nowy klucz. Zaczyna się od `pplx-`.

#### Połącz w ElevenLabs

W konfiguracji integracji ElevenLabs wklej klucz API Perplexity w polu **API Key**.

## Narzędzia

Integracja udostępnia dwa narzędzia. To, które wybierze agent, zależy od tego, czy rozmówca chce odpowiedź, czy listę źródeł.

| Narzędzie | Co zwraca                                                  |
| --------- | ---------------------------------------------------------- |
| `Ask`     | Krótką odpowiedź tekstową z adresami URL źródeł            |
| `Search`  | Strony internetowe z tytułem, linkiem i krótkim fragmentem |

### Ask

Ask wysyła pytanie do Agent API Perplexity, które przeszukuje sieć i tworzy odpowiedź. Odpowiedzi są ograniczone do około trzech zdań zwykłego tekstu, dostosowane do odczytania na głos, a źródła odpowiedzi są zwracane razem z nią. Użyj go przy pytaniach typu „co wydarzyło się w tym tygodniu z X”, gdy rozmówca chce usłyszeć odpowiedź.

### Search

Search wysyła zapytanie do Search API Perplexity i zwraca same strony — każdą z tytułem, linkiem i krótkim fragmentem. Agent może ograniczyć wyniki do konkretnych domen lub okresu: godziny, dnia, tygodnia, miesiąca albo roku. Domyślnie zwraca trzy strony, na tyle krótkie, by odczytać je podczas rozmowy, a maksymalnie dwadzieścia, gdy rozmówca poprosi o konkretną liczbę.

### Tryby wyszukiwania

Search domyślnie przeszukuje otwartą sieć. Parametr `search_type` narzędzia Search wybiera tryb, który zmieniasz podczas konfiguracji narzędzia:

| Tryb     | Zwraca                                                          |
| -------- | --------------------------------------------------------------- |
| `web`    | Strony internetowe. Domyślna opcja.                             |
| `fast`   | Strony internetowe zoptymalizowane pod kątem niższych opóźnień. |
| `people` | Informacje profilowe o osobach.                                 |

Twoja konfiguracja ustala tryb dla każdego wywołania przez agenta. Jeśli wybierzesz `people`, zmień **Condition prompt** narzędzia Search, aby wskazywał, że wyszukuje osoby — wtedy agent będzie wywoływać je przy właściwych pytaniach.

## Jak skracane są odpowiedzi

Oba narzędzia zwracają celowo krótkie wyniki, dostosowane do tego, ile rozmówca może przyswoić w trakcie rozmowy. Integracja domyślnie ustawia liczbę zwracanych stron na trzy, żąda najkrótszych dostępnych fragmentów stron i poleca modelowi odpowiedzi zmieścić się w kilku zdaniach. Każda z tych opcji jest parametrem narzędzia, więc zwiększ je podczas konfiguracji, jeśli agent potrzebuje szerszego kontekstu.

## Przydatne linki

* [Dokumentacja API Perplexity](https://docs.perplexity.ai)
* [Konsola API Perplexity](https://console.perplexity.ai)
* [Dokumentacja Agent API](https://docs.perplexity.ai/api-reference/agent-post)
* [Dokumentacja Search API](https://docs.perplexity.ai/api-reference/search-post)