Niestandardowe konektory

Niestandardowy konektor pozwala administratorowi organizacji zarejestrować HTTPS API lub, jeśli jest to włączone, serwer Streamable HTTP MCP, który nie znajduje się w katalogu wbudowanym. Określa granicę sieciową i metodę uwierzytelniania. Nie generuje automatycznie pełnej dokumentacji API dla agenta.

Kto konfiguruje co

• Administratorzy organizacji tworzą, edytują i usuwają definicję konektora.
• Członkowie podłączają własny sekret lub kończą proces OAuth konektora.
• Autoryzacja agenta kontroluje, które agenty mogą korzystać z podłączonego poświadczenia i jakie nazwane uprawnienia otrzymują.

Definicja jest współdzielona w organizacji. Poświadczenia członków pozostają przypisane do członka i organizacji.

Konektor HTTP API

1. Otwórz Konektory → Niestandardowe i wybierz Nowy konektor.
2. Wybierz HTTP API i wpisz nazwę wyświetlaną.
3. Dodaj jeden lub więcej prefiksów HTTPS, każdy w osobnej linii. Żądanie musi pasować do skonfigurowanego prefiksu, zanim konektor je autoryzuje.
4. Dodaj uwierzytelnianie, jeśli API tego wymaga:
   • Uwierzytelnianie API: wpisz nazwę nagłówka i szablon nagłówka zawierający {{secret}}, na przykład Authorization i Bearer {{secret}}.
   • OAuth 2.0: wpisz adres URL autoryzacji, adres URL tokena, identyfikator klienta, sekret klienta, zakresy i metodę uwierzytelniania punktu końcowego tokena. Zarejestruj dokładny adres URL przekierowania pokazany w formularzu u dostawcy.
5. Utwórz konektor. Każdy członek, który go potrzebuje, wybiera następnie Połącz i podaje swój sekret lub kończy proces OAuth.
6. Autoryzuj wymagany agent i uprawnienia.

Zmiana istniejącej definicji OAuth lub jej poświadczeń klienta powoduje rozłączenie obecnych połączeń OAuth. Członkowie muszą połączyć się ponownie po zmianie.

Konektor MCP

Jeśli MCP pojawia się jako typ konektora w Twoim środowisku pracy, wpisz punkt końcowy HTTPS Streamable HTTP MCP i skonfiguruj uwierzytelnianie API lub OAuth w tym samym formularzu. Jeśli MCP nie jest dostępny w selektorze, nie jest włączony dla tego środowiska pracy.

Naucz agenta procedury API

Niestandardowy konektor zapewnia bezpieczny dostęp do sieci i wstrzykiwanie poświadczeń. Formularz tworzenia nie przesyła ani nie wykrywa automatycznie dokumentu OpenAPI. Podaj agentowi punkt końcowy, metodę, parametry i oczekiwaną odpowiedź w żądaniu lub zapisz tę procedurę w workflow z załączoną dokumentacją API jako plik.

Zweryfikuj nowy konektor za pomocą wąskiego, tylko do odczytu żądania do znanego punktu końcowego. Nie ma ogólnego żądania Testuj połączenie, ponieważ wiele API nie udostępnia znaczącego punktu głównego.

Granice bezpieczeństwa

• Akceptowane są tylko prefiksy HTTPS i punkty końcowe MCP.
• Zapora wstrzykuje zapisane poświadczenie tylko do pasujących żądań.
• Zapisany sekret jest szyfrowany w spoczynku i nie jest udostępniany agentowi jako zmienna środowiskowa.
• Nie umieszczaj kluczy, tokenów ani sekretów klienta w wiadomościach czatu, instrukcjach workflow ani załączonych plikach.
• Używaj poświadczenia serwisowego z minimalnymi wymaganymi zakresami dla workflow.

Rozwiązywanie problemów

Co dalej

• Zobacz Przepływy pracy, aby rejestrować powtarzalne zadania z niestandardowym konektorem.
• Zobacz Uprawnienia, aby dowiedzieć się, jak obsługiwane są poświadczenia niestandardowych konektorów.
• Zajrzyj do Katalogu przed budową własnego — Twoja usługa może być już obsługiwana.