Registeragenten (agentendiensten)

Registreer agenten in Unity Catalog zodat elke teamagent op één plek woont. Wanneer je een agent registreert als agentservice, kun je deze bekijken en ontdekken naast je tabellen, modellen en functies, en permissies instellen met dezelfde toekenningen die je andere Unity Catalog-assets beschermen.

Agents ontdekken in Catalog Explorer

Nadat een agentdienst is geregistreerd, verschijnt deze in Catalog Explorer onder het schema waar deze is aangemaakt. Om een agentdienst te zien, heeft een gebruiker een expliciet privilege nodig op deze dienst, zoals EXECUTE. Selecteer een agentservice om de naam, beschrijving, verbinding en huidige machtigingen weer te geven.

Gebruik het comment veld om een beschrijving toe te voegen wanneer u een agentservice maakt of bijwerkt. Deze beschrijving wordt weergegeven in Catalog Explorer en helpt teamleden te begrijpen wat de agent doet wanneer ze ernaar bladeren.

Dit geeft uw organisatie één plek om te zien welke agents er bestaan, wie eigenaar is van de agents en wie toegang heeft, zonder dat u ze hoeft bij te houden in afzonderlijke systemen of documentatie.

Requirements

• De Unity AI Gateway bètafuncties zijn ingeschakeld voor jouw account. Zie Azure Databricks previews beheren.
• Om een agentservice te maken, moet u beschikken over USE CATALOG en USE SCHEMA voor de bovenliggende catalogus en het schema, CREATE SERVICE voor het schema en USE CONNECTION voor de verbinding waarnaar de agentservice verwijst.
• Als u machtigingen voor een agentservice wilt beheren , moet u de eigenaar van de agentservice zijn of over de MANAGE bevoegdheid beschikken.

Een agentservice maken

Een agentservice verwijst naar een bestaande Unity Catalog-verbinding die de host en referenties voor de agent bevat. Maak de verbinding voordat u de agentservice maakt.

In het volgende voorbeeld wordt een agentservice gemaakt met de naam support_agent in het main.default schema:

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."
    }
  }'

Het antwoord bevat de resourcenaam van de agentservice:

{
  "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."
  }
}

Agentservices ophalen en vermelden

Haal één agentservice op met de volledige naam:

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

Alle agentservices in een schema weergeven:

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

Als u agentservices in de hele metastore wilt weergeven, laat u het schemafilter weg:

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

Een agentservice bijwerken

Als u specifieke velden wilt bijwerken zonder anderen te overschrijven, gebruikt u een PATCH aanvraag en geeft u op welke velden u wilt wijzigen. In het volgende voorbeeld wordt de systeemprompt bijgewerkt terwijl alle andere velden ongewijzigd blijven:

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." } }'

Velden die u kunt bijwerken: comment, config.system_prompt. config.base_path

Toegang verlenen

Stel machtigingen in voor een agentservice met hetzelfde toekenningsmodel dat uw andere Unity Catalog beveiligbare objecten beveiligt. Toegang verlenen EXECUTE aan gebruikers en service-principals:

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

Huidige subsidies inspecteren:

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

Toegang intrekken:

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

Toewijsbare bevoegdheden: EXECUTE, READ METADATA, MANAGE, . ALL PRIVILEGES

Een agentservice verwijderen

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

Limitations

Tijdens de bèta zijn de volgende beperkingen van toepassing:

• Runtime-aanroep is niet beschikbaar. Agents kunnen niet worden aangeroepen via een geregistreerde agentservice. Registratie- en machtigingenbeheer zijn nu beschikbaar.
• Servicebeleid en frequentielimieten worden niet ondersteund door de API. Pogingen om deze velden in te stellen leveren een fout op.
• SQL DDL voor agentservices is niet beschikbaar. Agentservices maken en beheren met de REST API.
• full_name- en owner-velden geven in deze release null terug in GET-responses.
• Global Search in Unity Catalog biedt geen agentservices.
• Het BROWSE privilege wordt niet ondersteund. Om een agentdienst te zien, heeft een gebruiker een expliciet privilege nodig op deze dienst, zoals EXECUTE.

Volgende stappen 

• AI-governance met Unity AI Gateway om AI-verkeer vanaf een centrale locatie te beheren.