Služby agentů v katalogu Unity

Important

Tato funkce je v beta verzi. Správci účtů můžou řídit přístup k této funkci ze stránky účtu Previews. Viz Manage Azure Databricks preview.

Služby agentů poskytují všem vašim agentům umělé inteligence domovskou stránku v katalogu Unity. Zaregistrujte agenty z libovolného týmu na jednom místě, procházejte je a objevujte společně s tabulkami, modely a funkcemi a nastavte oprávnění pomocí stejných grantů, které chrání ostatní prostředky katalogu Unity.

Zjišťování agentů v Průzkumníku katalogu

Po registraci se služba agenta zobrazí v Průzkumníku katalogu ve schématu, ve kterém byla vytvořena. Každý, kdo má u služby agenta oprávnění READ_METADATA, ji může procházet spolu s tabulkami, modely a funkcemi ve stejném schématu. Výběrem služby agenta zobrazíte její název, popis, připojení a aktuální oprávnění.

comment Pole použijte k přidání popisu při vytváření nebo aktualizaci služby agenta. Tento popis se zobrazuje v aplikaci Catalog Explorer a pomáhá členům týmu pochopit, co agent dělá, když si ho prohlížejí.

Díky tomu může vaše organizace na jednom místě zjistit, co agenti existují, kdo je vlastní a kdo má přístup, aniž by je museli sledovat v různých systémech nebo dokumentaci.

Requirements

  • Chcete-li vytvořit službu agenta, musíte mít USE CATALOG a USE SCHEMA v nadřazeném katalogu a schématu, CREATE SERVICE ve schématu a USE CONNECTION u připojení, na které služba agenta odkazuje.
  • Pokud chcete spravovat oprávnění ke službě agenta, musíte mít MANAGE_ACCESS_CONTROL ve službě agenta.

Vytvoření služby agenta

Služba agenta odkazuje na existující připojení ke katalogu Unity, které obsahuje adresu hostitele a přihlašovací údaje agenta. Vytvořte připojení předtím, než vytvoříte službu agenta.

Následující příklad vytvoří službu agenta pojmenovanou support_agent ve schématu 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": {
      "connection": {
        "name": "connections/main.default.my_agent_connection"
      },
      "base_path": "/v1/chat",
      "system_prompt": "You are a helpful support assistant."
    }
  }'

Odpověď obsahuje název prostředku služby agenta:

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

Získání a výpis služeb agenta

Načíst jednotlivou službu agenta podle jejího úplného názvu:

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

Výpis všech služeb agenta ve schématu:

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

Pokud chcete zobrazit seznam služeb agenta v celém metastoru, vynecháte filtr schématu:

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

Aktualizace služby agenta

Pokud chcete aktualizovat konkrétní pole bez přepsání ostatních, použijte PATCH požadavek a určete, která pole se mají změnit. Následující příklad aktualizuje výzvu systému a ponechá všechna ostatní pole beze změny:

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

Pole, která můžete aktualizovat: comment, config.system_promptconfig.base_path.

Udělení přístupu

Nastavte oprávnění ke službě agenta pomocí stejného modelu udělení, který chrání vaše ostatní zabezpečitelné objekty katalogu Unity. Udělení EXECUTE uživatelům a instančním objektům služby:

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

Kontrola aktuálních grantů:

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

Odvolání přístupu:

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

Přiřaditelná oprávnění: EXECUTE, READ_METADATA, MANAGE, MANAGE_ACCESS_CONTROL, ALL_PRIVILEGES.

Odstranění služby agenta

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

Limitations

Během beta verze platí následující omezení:

  • Vyvolání za běhu není k dispozici. Agenty nelze vyvolat pomocí registrované služby agenta. Správa registrací a oprávnění jsou nyní k dispozici.
  • Rozhraní API nepodporuje zásady služeb a omezení rychlosti. Pokus o nastavení těchto polí vrátí chybu.
  • SQL DDL pro služby agenta není k dispozici. Vytvářejte a spravujte služby agenta pomocí rozhraní REST API.
  • full_name a owner pole vracejí null v odpovědích GET v tomto vydání.
  • Globální vyhledávání v katalogu Unity nezobrazuje služby agentů.

Další kroky

  • Last updated on