Rejestrowanie agentów (usługi agentów)

Ważna

Usługi agentów są w fazie beta. Unity Gateway jest zazwyczaj dostępny, ale jego możliwości beta są włączane osobno. Administrator konta musi włączyć funkcje beta Unity Gateway na stronie Zapowiedzi konsoli konta. Zobacz Zarządzanie wersjami zapoznawczami usługi Azure Databricks.

Rejestruj agentów w Unity Catalog, aby agenci każdego zespołu mieszkali w jednym miejscu. Gdy zarejestrujesz agenta jako usługę agenta, możesz go przeglądać i wyszukiwać obok tabel, modeli i funkcji oraz ustawiać uprawnienia za pomocą tych samych przydziałów uprawnień, które chronią inne zasoby Unity Catalog.

Odkryj agentów w Catalog Explorer

Po zarejestrowaniu usługi agenta pojawia się ona w Eksploratorze katalogu pod schematem, w którym została utworzona. Aby zobaczyć usługę agenta, użytkownik potrzebuje na niej wyraźnych uprawnień, takich jak EXECUTE. Wybierz usługę agenta, aby wyświetlić jej nazwę, opis, połączenie i bieżące uprawnienia.

Note

Przyznanie EXECUTE umożliwia użytkownikowi nie tylko wykrycie usługi agenta, ale także jej wywołanie. Udziel go tylko użytkownikom, którzy powinni móc korzystać z agenta.

comment Użyj pola, aby dodać opis podczas tworzenia lub aktualizowania usługi agenta. Ten opis jest wyświetlany w Eksploratorze wykazu i pomaga kolegom z zespołu zrozumieć, co robi agent podczas przeglądania.

Zapewnia to organizacji pojedyncze miejsce, aby zobaczyć, którzy agenci istnieją, kto jest ich właścicielem i kto ma dostęp, bez konieczności śledzenia ich w oddzielnych systemach lub dokumentacji.

Requirements

  • Funkcje beta Unity Gateway są włączone dla Twojego konta. Zobacz Zarządzanie wersjami zapoznawczami usługi Azure Databricks.
  • Aby utworzyć usługę agenta, musisz mieć USE CATALOG i USE SCHEMA do katalogu nadrzędnego i schematu, CREATE SERVICE do schematu oraz USE CONNECTION do połączenia, do którego odwołuje się usługa agenta.
  • Aby zarządzać uprawnieniami w usłudze agenta, musisz być właścicielem usługi agenta lub mieć MANAGE uprawnienia.

Tworzenie usługi agenta

Usługa agenta odwołuje się do istniejącego połączenia Unity Catalog, które zawiera adres hosta i poświadczenia agenta. Utwórz połączenie przed utworzeniem usługi agenta.

Poniższy przykład tworzy usługę agenta o nazwie support_agent w schemacie main.default :

databricks api post \
  "/api/2.1/unity-catalog/agent-services?parent=schemas/main.default&agent_service_id=support_agent" \
  --json '{
    "agent_service_type": "AGENT_SERVICE_TYPE_EXTERNAL",
    "comment": "Support agent for the customer team",
    "config": {
      "source_connection": {
        "name": "connections/main.default.my_agent_connection"
      },
      "base_path": "/v1/chat",
      "system_prompt": "You are a helpful support assistant."
    }
  }'

Odpowiedź zawiera nazwę zasobu usługi agenta:

{
  "name": "agent-services/main.default.support_agent",
  "agent_service_type": "AGENT_SERVICE_TYPE_EXTERNAL",
  "created_by": "you@company.com",
  "config": {
    "source_connection": { "name": "connections/main.default.my_agent_connection" },
    "base_path": "/v1/chat",
    "system_prompt": "You are a helpful support assistant."
  }
}

Pobierz i wyświetl usługi agenta

Pobierz pojedynczą usługę agenta pod jego pełną nazwą:

databricks api get "/api/2.1/unity-catalog/agent-services/main.default.support_agent"

Wyświetl listę wszystkich usług agentów w schemacie:

databricks api get "/api/2.1/unity-catalog/agent-services?parent=schemas/main.default"

Aby wyświetlić listę usług agentów w całym magazynie metadanych, pomiń filtr schematu:

databricks api get "/api/2.1/unity-catalog/agent-services"

Aktualizowanie usługi agenta

Aby zaktualizować określone pola bez zastępowania innych, użyj PATCH żądania i określ pola do zmiany. Poniższy przykład aktualizuje monit systemowy, pozostawiając wszystkie pozostałe pola bez zmian:

databricks api patch \
  "/api/2.1/unity-catalog/agent-services/main.default.support_agent?update_mask=config.system_prompt" \
  --json '{ "config": { "system_prompt": "You are a concise support assistant." } }'

Pola, które można zaktualizować: comment, , config.system_promptconfig.base_path.

Przyznaj dostęp

Ustaw uprawnienia dla usługi agenta przy użyciu tego samego modelu przyznawania uprawnień, który chroni inne zabezpieczalne obiekty w Unity Catalog. Przyznaj EXECUTE użytkownikom i nazwom głównym usług:

databricks api patch \
  "/api/2.1/unity-catalog/permissions/AGENT_SERVICE/main.default.support_agent" \
  --json '{
    "changes": [
      { "principal": "teammate@company.com", "add": ["EXECUTE"] }
    ]
  }'

Sprawdź bieżące dotacje:

databricks api get "/api/2.1/unity-catalog/permissions/AGENT_SERVICE/main.default.support_agent"

Odwoływanie dostępu:

databricks api patch \
  "/api/2.1/unity-catalog/permissions/AGENT_SERVICE/main.default.support_agent" \
  --json '{
    "changes": [
      { "principal": "teammate@company.com", "remove": ["EXECUTE"] }
    ]
  }'

Przypisywane uprawnienia: EXECUTE, , READ METADATAMANAGE, ALL PRIVILEGES.

Usuwanie usługi agenta

databricks api delete "/api/2.1/unity-catalog/agent-services/main.default.support_agent"

Ograniczenia

W wersji beta obowiązują następujące ograniczenia:

  • Wywołanie środowiska uruchomieniowego nie jest dostępne. Agentów nie można wywoływać za pośrednictwem zarejestrowanej usługi agenta. Zarządzanie rejestracją i uprawnieniami jest teraz dostępne.
  • Zasady usług i limity szybkości nie są obsługiwane przez interfejs API. Próba ustawienia tych pól zwraca błąd.
  • SQL DDL dla usług agenta jest niedostępne. Tworzenie usług agentów i zarządzanie nimi za pomocą interfejsu API REST.
  • Pola full_name i owner zwracają null w odpowiedziach GET w tej wersji.
  • Globalne wyszukiwanie w Unity Catalog nie wyświetla usług agentów.
  • Przywilej BROWSE nie jest obsługiwany. Aby zobaczyć usługę agenta, użytkownik potrzebuje na niej wyraźnych uprawnień, takich jak EXECUTE.

Następne kroki

  • Last updated on