Połącz dostawcę AI

AI Engine wysyła żądania do Twojego dostawcy AI przez Named Credential w Salesforce. Twój klucz API jest przechowywany w External Credential w Twoim własnym orgu, a Salesforce dodaje go do każdego żądania. Klucz nie jest częścią konfiguracji AI Engine i nie jest wysyłany do Cloud Connected.

Konfiguracja składa się z czterech części:

1. External Credential, który przechowuje Twój klucz.
2. Named Credential z URL-em dostawcy.
3. Dostęp do poświadczenia dla wszystkich, którzy korzystają z AI Engine.
4. Nazwa poświadczenia w Org Profile AI Engine.

Zanim zaczniesz#

• Klucz API od OpenAI lub Anthropic albo zasób Azure OpenAI z wdrożeniem modelu i jego kluczem.
• Przypisane Ci permission sety AI Engine Admin i AI Engine User. Zobacz Przypisz permission sety.

Krok 1: Utwórz External Credential#

1. Przejdź do Setup → Named Credentials, otwórz zakładkę External Credentials i kliknij New.
2. Wpisz Label i Name, na przykład OpenAI, a Authentication Protocol ustaw na Custom. Zapisz.
3. W sekcji Principals kliknij New. Wpisz Parameter Name, na przykład Default, pozostaw Identity Type jako Named Principal i zapisz.
4. W sekcji Custom Headers kliknij New i dodaj nagłówek właściwy dla Twojego dostawcy:

Zastąp YOUR_API_KEY swoim kluczem. W przypadku Authorization zachowaj słowo Bearer i jedną spację przed kluczem. W przypadku Anthropic nie potrzebujesz nagłówka anthropic-version: AI Engine sam wysyła go z każdym żądaniem do Anthropic.

Krok 2: Utwórz Named Credential#

1. Przejdź do Setup → Named Credentials, otwórz zakładkę Named Credentials i kliknij New.
2. Wpisz Label i Name, na przykład OpenAI, Anthropic lub AzureOpenAI. Dokładnie tę nazwę wpiszesz później w AI Engine.
3. Ustaw URL:

4. Wybierz External Credential z kroku 1.
5. Upewnij się, że Enabled for Callouts jest włączone.
6. W sekcji Managed Package Callout Allowlist wpisz CloudConnected w polu Allowed Namespaces for Callouts. AI Engine działa w przestrzeni nazw CloudConnected i bez tego wpisu Salesforce nie pozwoli mu użyć utworzonego przez Ciebie poświadczenia.
7. Zapisz.

Używaj tylko bazowego URL-a. AI Engine sam dodaje ścieżkę do każdego żądania.

Krok 3: Nadaj użytkownikom dostęp do principala#

Każda osoba korzystająca z AI Engine, łącznie z administratorami, potrzebuje dostępu do principala z kroku 1. AI Engine User i AI Engine Admin pochodzą z managed package, więc Twój org może nie pozwalać na ich edycję. Niezawodnym sposobem jest własny permission set:

1. Przejdź do Setup → Permission Sets i kliknij New.
2. Wpisz etykietę, na przykład AI Provider Access, pozostaw License jako --None-- i zapisz.
3. Otwórz External Credential Principal Access, kliknij Edit, dodaj principala z kroku 1 (na przykład OpenAI - Default) i zapisz.
4. Kliknij Manage Assignments → Add Assignment, zaznacz wszystkich użytkowników i administratorów AI Engine i przypisz.

Użytkownicy potrzebują też permission setu AI Engine User, który zawiera dostęp Read do User External Credentials wymagany przez Salesforce do wykonania wywołania. Gdy później dodajesz użytkowników AI Engine, przypisz im oba permission sety.

Krok 4: Powiąż poświadczenie w AI Engine#

AI Engine używa jednego Org Profile dla całego orga. Jeśli profil już istnieje, edytuj go zamiast tworzyć drugi.

1. Otwórz zakładkę Ai Agent Admin Setup, przejdź do Org Profile i kliknij + New Profile albo kliknij istniejący profil, aby go edytować.
2. Wybierz AI Provider: OpenAI (Responses API), Azure OpenAI lub Anthropic Claude. AI Engine uzupełni sugerowany model i nazwę poświadczenia.
3. W polu Named Credential wpisz dokładną nazwę z kroku 2.
4. Wybierz AI Model. W przypadku Azure OpenAI wpisz deployment name (nazwę wdrożenia), a nie nazwę rodziny modeli.
5. Opcjonalnie wybierz Fast model (internal steps) od tego samego dostawcy. AI Engine używa go do kroków wyszukiwania w internecie, takich jak Web Check i Company News, oraz do odpowiedzi w Help mode; wszystko inne działa na głównym modelu. Jeśli nie masz pewności, pozostaw wartość domyślną dostawcy (w przypadku Azure OpenAI pozostaw puste).
6. Kliknij Save.

Następnie przeprowadź pierwszy test.

Azure OpenAI#

• AI Engine wywołuje Twoje wdrożenie pod adresem /openai/deployments/<deployment name>/chat/completions, więc pole AI Model musi dokładnie odpowiadać nazwie wdrożenia. Nazwy wdrożeń mogą zawierać tylko litery, cyfry, kropki, łączniki i podkreślenia.
• Funkcje wyszukiwania w internecie w AI Engine korzystają z narzędzia web search od OpenAI, którego AI Engine nie wywołuje przez Azure OpenAI. Gdy Twoim dostawcą jest Azure OpenAI, funkcje przeszukujące internet, takie jak Web Check i Company News, są zamiast tego wysyłane do OpenAI, z użyciem modelu gpt-4.1-mini, przez Named Credential, który musi mieć nazwę dokładnie OpenAI. Jeśli chcesz korzystać z tych funkcji, utwórz External Credential i Named Credential dla OpenAI w sposób opisany powyżej, z tą nazwą, i upewnij się, że Twój klucz OpenAI może używać gpt-4.1-mini. Jeśli tego nie zrobisz, te funkcje zakończą się błędem, a wszystko inne będzie działać dalej. Weź to pod uwagę, jeśli Azure wybrano ze względu na lokalizację danych (data residency). Zobacz Wybór dostawcy pod kątem zgodności.

Późniejsza zmiana dostawcy#

Dostawcę możesz zmienić w dowolnym momencie: utwórz poświadczenia dla nowego dostawcy i zmień AI Provider, AI Model oraz Named Credential w Org Profile. Ponowna instalacja nie jest potrzebna. AI Engine nie przełącza dostawców automatycznie, ale jeśli utrzymujesz skonfigurowane i przetestowane poświadczenia drugiego dostawcy, możesz ręcznie przełączyć na niego Org Profile w razie awarii głównego dostawcy.

Rozwiązywanie problemów#

Aby wymienić klucz, zobacz Klucze API i Named Credentials.