Przejdź do treści

Integracja Claude API: model Anthropic w aplikacji i procesach firmy

Okno czatu wystarcza pracownikowi. Gdy ten sam model ma codziennie przetwarzać setki maili, zgłoszeń albo dokumentów, wywołuję go z kodu przez API, a wynik trafia prosto do systemu firmy.

Autor: Szymon Łakomy. Aktualizacja:

Gdzie uruchomić Claude: API Anthropic czy chmura?

Model Claude można wywołać bezpośrednio przez API Anthropic albo w chmurze, w której firma już ma konto i rozliczenia. Tak wybieram wariant:

DostępKiedy go wybieram
API Anthropicnowy projekt bez zobowiązań chmurowych, rozliczenie bezpośrednio u Anthropic
Amazon Bedrockfirma ma już infrastrukturę, rozliczenia i uprawnienia w AWS
Google Cloud (Vertex AI)dane i aplikacje firmy działają w Google Cloud
Microsoft Foundryfirma rozlicza chmurę w Azure i chce mieć model w tym samym miejscu

Dostępność funkcji różni się między platformami. Przed wyborem sprawdzam ją w dokumentacji Anthropic.

Gdy dane mają być przetwarzane w Unii Europejskiej, ustawienia regionu porównuję tak, jak opisuję na stronie modele AI z danymi w UE.

Funkcje API, z których korzystam najczęściej

W integracjach najczęściej korzystam z pięciu funkcji API: odpowiedzi według schematu, narzędzi, cache promptu, przetwarzania wsadowego i cytowań.

Odpowiedź według schematu

Model zwraca dane w formacie JSON zgodnym ze schematem, na przykład kategorię zgłoszenia, priorytet i podsumowanie. Kod sprawdza wynik, zanim zapisze go w systemie.

Narzędzia (tool use)

Claude może poprosić o wywołanie funkcji Waszego systemu, na przykład sprawdzenie statusu zamówienia. Funkcję wykonuje kod aplikacji, z jej uprawnieniami i dziennikiem. Gdy te same narzędzia mają działać także w aplikacji Claude, udostępniam je przez serwer MCP dla firmy, a sam protokół opisuję na stronie co to jest MCP.

Cache promptu

Długa, stała część zapytania, na przykład regulamin czy katalog produktów, trafia do pamięci podręcznej. Kolejne zapytania czytają ją taniej i szybciej.

Przetwarzanie wsadowe

Tysiące dokumentów bez pośpiechu idą jednym zleceniem, taniej niż pojedyncze zapytania. Wyniki przychodzą później, więc to rozwiązanie do zadań nocnych, a nie do czatu.

Cytowania

Przy odpowiedziach na podstawie dokumentów model wskazuje fragment źródła, więc pracownik sprawdza zapis jednym kliknięciem.

Jak wybrać model Claude do integracji?

Model wybieram na kilkudziesięciu przykładach z prawdziwymi danymi firmy, a nie z pamięci ani z rankingów. Anthropic udostępnia kilka rodzin modeli, między innymi Fable, Opus, Sonnet i Haiku. Mocniejszy model lepiej radzi sobie z trudną analizą, ale kosztuje więcej i odpowiada wolniej. Do klasyfikacji krótkich wiadomości zwykle wystarcza mniejszy model, do analizy długiej umowy potrzebny jest mocniejszy.

Na tym zestawie porównuję wyniki oraz koszt kilku modeli, tak jak opisuję na stronie wybór modelu AI do agenta. Koszt użycia różnych modeli policzysz w kalkulatorze kosztów API AI.

Przykład: zgłoszenia od klientów w CRM

Przykład hipotetyczny, typowy dla firmy usługowej: Claude przez API klasyfikuje zgłoszenia od klientów i przygotowuje szkic odpowiedzi w CRM.

  1. Wejście. Mail albo formularz trafia do przepływu w n8n albo do kodu aplikacji.
  2. Wywołanie Claude. Model dostaje treść, listę kategorii i instrukcję, a zwraca kategorię, pilność, dane klienta i szkic odpowiedzi.
  3. Kontrola. Kod sprawdza format, a przy niepewnej kategorii zgłoszenie trafia do człowieka.
  4. Zapis. Zgłoszenie powstaje w CRM, a szkic odpowiedzi czeka na akceptację pracownika.
  5. Dziennik. Każde wywołanie ma zapisany czas, koszt i wynik, co ułatwia poprawki instrukcji.

Ten przepływ ma stałe kroki, więc wystarcza zwykła integracja. Gdy model ma sam decydować o kolejnych krokach i kilka razy sięgać po narzędzia w jednym zadaniu, potrzebny jest agent. Kiedy i jak go zbudować, opisuję na stronie agent AI na Claude.

Jak utrzymać integrację, gdy Anthropic wycofuje modele?

Integracja trzyma nazwę modelu w konfiguracji, a nie w kodzie, i ma zestaw testów, który uruchamiam przed zmianą modelu. To ważne, bo Anthropic co jakiś czas wycofuje starsze modele z API i podaje terminy na stronie o wycofywaniu modeli. Taką opiekę opisuje strona opieka nad agentem AI. Integrację z modelem OpenAI opisuję osobno na stronie integracja ChatGPT API z aplikacją firmową.

Źródła

Opis opieram na poniższych źródłach. Przepisy, dokumentacja producentów i warunki usług się zmieniają, więc szczegóły warto sprawdzić u źródła:

Najczęstsze pytania

Czy do integracji Claude API potrzebuję planu Team?

Nie. API ma osobne konto w konsoli Anthropic i rozliczenie za faktyczne użycie, niezależne od abonamentów w aplikacji Claude. Plan Team dotyczy pracowników korzystających z okna rozmowy.

Ile kosztuje używanie Claude przez API?

Płacicie za tokeny na wejściu i na wyjściu według cennika Anthropic, osobno dla każdego modelu. Koszt obniżają cache promptu, przetwarzanie wsadowe i mniejszy model tam, gdzie wystarcza. Szacunek dla swojego przypadku policzysz w kalkulatorze kosztów API AI.

Czy dane wysyłane do Claude API służą do trenowania modeli?

Zasady dla API opisują warunki handlowe Anthropic, a ustawienia przechowywania danych zależą od konta i platformy. Przed wdrożeniem czytam je dla wybranego wariantu i zapisuję w dokumentacji projektu. To nie jest porada prawna.

Czy Claude API można podłączyć do n8n?

Tak, n8n ma węzły do modeli Anthropic, a w razie potrzeby wywołuję API zwykłym zapytaniem HTTP. Gotowe przepływy z agentem opisuję na stronie agent AI w n8n.

Powiązane strony

Chcesz, żeby Claude pracował w Waszym systemie?

Napisz, jakie dane ma przetwarzać model i do jakiego systemu trafia wynik. Odpowiem, jak zbudować integrację i ile może kosztować użycie.