[Intum](https://intum.pl/pomoc.md) / [Noe AI](https://intum.pl/pomoc/noe-ai.md)

# [Konektory - połączenia z zewnętrznymi API](https://intum.pl/pomoc/noe-ai/konektory.md) | [API](#api)

Konektory to połączenia konta z zewnętrznymi API - od dostawców AI, przez e-commerce, po Twoje własne serwisy. Listę znajdziesz w **Noe AI → Konektory** (albo w module Integracje). Przycisk **AI** obok listy skonfiguruje konektor poleceniem tekstowym.

## Do czego służy konektor

Konektor przechowuje adres zewnętrznego API i klucz dostępu (pole **Secret token** - wysyłany bezpiecznie przy każdym wywołaniu), a jego **metody** to gotowe operacje, z których korzystają flow i aplikacje: "pobierz pogodę", "wyślij SMS", "zapytaj model AI". Dzięki temu klucze API nigdy nie trafiają do kodu aplikacji.

## Rodzaje konektorów

- **AI** - OpenAI, Claude (Anthropic), Gemini (Google), AWS Bedrock; wybierasz model rozmów i embeddingów, a konektor obsługuje rozmowy i wyszukiwanie semantyczne w całym systemie
- **Integracje gotowe** - np. e-commerce, płatności, banki (instalowane zwykle razem z aplikacjami z Ustawienia konta → Aplikacje i dodatki)
- **Custom connector** - własne API bez pisania kodu: definiujesz metody (adres, parametry w klamrach, typ żądania), a system sam wykonuje wywołania. Tak działa np. pobieranie pogody w przykładowej aplikacji Pogoda

## Testowanie

Na stronie konektora przy każdej metodzie jest przycisk wykonania - możesz sprawdzić połączenie (np. metoda `check`) bez budowania całego flow. Wynik widać od razu.

## Powiązania

Konektor podłączasz do flow jako krok programu - na stronie flow w sekcji **Powiązania** widać, które konektory program wykorzystuje.


---

## API

### Ogólne API

# Intum API

Dokumentacja API platformy [Intum](https://intum.pl) - system operacyjny firmy.

## Host

Host jest zawsze taki sam jak adres konta: `xxxx.intum.com` lub `xxx.intum.pl` (w zależności od ustawień konta)

## Autoryzacja

Wszystkie requesty API wymagają `api_token`:
- header: `Authorization: Bearer TOKEN`

Token możesz wygenerować w **Ustawienia Konta** → **Tokeny API**

## Endpointy

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| GET | `/connect/connectors.json` | Lista konektorów (filtr `?kind=...`) |
| GET | `/connect/connectors/:id.json` | Pojedynczy konektor |
| POST | `/connect/connectors.json` | Utworzenie |
| PATCH | `/connect/connectors/:id.json` | Aktualizacja |
| DELETE | `/connect/connectors/:id.json` | Usunięcie |
| GET/POST | `/connect/connectors/:id/method/:method_name` | Wywołanie metody (test/integracja) |

## Custom connector (kind: noe/custom_connector)

Metody definiowane w top-level polu `methods` (tablica), `secret_token` wysyłany jako Bearer
do zewnętrznego API, bazowy `url` normalizowany do hosta (ścieżkę podawaj w `path` metody):

```json
{
  "connector": {
    "name": "Open-Meteo",
    "code": "open-meteo",
    "kind": "noe/custom_connector",
    "url": "https://api.open-meteo.com",
    "methods": [
      { "method": "get_weather", "object_in": "json_object", "object_out": "json_object",
        "http_method": "GET", "path": "/v1/forecast?latitude={latitude}&longitude={longitude}&current_weather=true" }
    ]
  }
}
```

Pełne instrukcje dla agentów (w tym konektory AI z modelami): `/noe/prompt/connector_api.md`.