Registeragenter (agenttjänster)

Registrera agenter i Unity-katalogen så att varje teams agenter finns på ett och samma ställe. När du registrerar en agent som agenttjänst kan du bläddra och upptäcka den tillsammans med dina tabeller, modeller och funktioner, och ställa in behörigheter med samma tillstånd som skyddar dina andra Unity-katalogtillgångar.

Identifiera agenter i Katalogutforskaren

Efter att en agenttjänst har registrerats visas den i Katalogutforskaren under schemat där den skapades. För att se en agenttjänst behöver en användare en explicit privilegium på den, såsom EXECUTE. Välj en agenttjänst för att visa dess namn, beskrivning, anslutning och aktuella behörigheter.

Använd fältet comment för att lägga till en beskrivning när du skapar eller uppdaterar en agenttjänst. Den här beskrivningen visas i Katalogutforskaren och hjälper teammedlemmar att förstå vad agenten gör när de bläddrar i den.

Detta ger din organisation en enda plats för att se vilka agenter som finns, vem som äger dem och vem som har åtkomst, utan att behöva spåra dem över separata system eller dokumentation.

Requirements

• Unity AI Gateway beta-funktionerna är aktiverade för ditt konto. Se Hantera förhandsversioner av Azure Databricks.
• Om du vill skapa en agenttjänst måste du ha USE CATALOG och USE SCHEMA för den överordnade katalogen och det överordnade schemat, CREATE SERVICE för schemat och USE CONNECTION för anslutningen som agenttjänsten refererar till.
• Om du vill hantera behörigheter för en agenttjänst måste du vara ägare till agenttjänsten eller ha behörigheten MANAGE .

Skapa en agenttjänst

En agenttjänst hänvisar till en befintlig Unity Catalog-anslutning som innehåller värden och autentiseringsuppgifter för agenten. Skapa anslutningen innan du skapar agenttjänsten.

I följande exempel skapas en agenttjänst med namnet support_agent i main.default schemat:

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

Svaret innehåller agenttjänstens resursnamn:

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

Hämta och lista agenttjänster

Hämta en enda agenttjänst med dess fullständiga namn:

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

Visa en lista över alla agenttjänster i ett schema:

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

Om du vill visa agenttjänster i hela metaarkivet utelämnar du schemafiltret:

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

Uppdatera en agenttjänst

Om du vill uppdatera specifika fält utan att skriva över andra använder du en PATCH begäran och anger vilka fält som ska ändras. I följande exempel uppdateras systemprompten samtidigt som alla andra fält lämnas oförändrade:

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

Fält som du kan uppdatera: comment, config.system_prompt, config.base_path.

Bevilja åtkomst

Ange behörigheter för en agenttjänst med samma beviljandemodell som skyddar dina andra skyddsbara objekt i Unity Catalog. Bevilja EXECUTE för användare och tjänsthuvudnamn:

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

Granska aktuella bidrag:

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

Återkalla åtkomst:

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

Behörigheter som kan tilldelas: EXECUTE, READ METADATA, MANAGE, ALL PRIVILEGES.

Ta bort en agenttjänst

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

Limitations

Under betaversionen gäller följande begränsningar:

• Anrop under körning är inte tillgängliga. Agenter kan inte anropas via en registrerad agenttjänst. Registrerings- och behörighetshantering är tillgängliga nu.
• Tjänstprinciper och hastighetsbegränsningar stöds inte av API:et. Om du försöker ange dessa fält returneras ett fel.
• SQL DDL för agenttjänster är inte tillgängligt. Skapa och hantera agenttjänster med REST-API:et.
• full_name- och owner-fälten returnerar null i GET-svar i den här versionen.
• Global sökning i Unity Catalog visar inte agenttjänster.
• Privilegiet BROWSE stöds inte. För att se en agenttjänst behöver en användare en explicit privilegium på den, såsom EXECUTE.

Nästa steg

• AI-styrning med Unity AI Gateway för att styra AI-trafik från en central plats.