Model zpětné vazby (zastaralý)

Important

Pro nové případy použití doporučuje Databricks nasazovat agenty v Databricks Apps, aby bylo možné plně řídit kód agenta, konfiguraci serveru a pracovní postup nasazení. Viz Vytvoření agenta AI a jeho nasazení v Databricks Apps. Pokud chcete migrovat existujícího agenta, přečtěte si téma Migrace agenta z modelové obsluhy do Databricks Apps.

Important

Oznámení o vyřazení: Model zpětné vazby byl od 4. prosince 2025 zastaralý a v nejnovější verzi agentů Databricks-agents se už nepodporuje.

Je vyžadována akce: Použijte MLflow 3 k protokolování modelu 3 místo toho. Pak místo toho použijte log_feedback rozhraní API a rozhraní API pro hodnocení MLflow 3 ke shromažďování názorů.

Model zpětné vazby umožňuje programově shromažďovat zpětnou vazbu k odpovědím agenta. Když nasadíte agenta pomocí agents.deploy(), Databricks automaticky vytvoří koncový bod modelu zpětné vazby společně s vaším agentem.

Tento koncový bod přijímá strukturovanou zpětnou vazbu (hodnocení, komentáře, posudky) a protokoluje ji do tabulek určených pro inferenci. Tento přístup byl však nahrazen robustnějšími možnostmi zpětné vazby MLflow 3.

Migrace na MLflow 3

Místo použití zastaralého modelu zpětné vazby migrujte na MLflow 3, abyste mohli získat komplexní zpětnou vazbu a možnosti hodnocení:

  • Špičkové protokolování hodnocení s robustním ověřováním a řízením chyb
  • Integrace trasování v reálném čase pro okamžitou viditelnost zpětné vazby
  • Integrace aplikace Review se zdokonalenými funkcemi pro spolupráci zainteresovaných stran
  • Podpora monitorování produkce s využitím automatizovaného hodnocení kvality

Migrace existujících úloh do MLflow 3:

  1. Upgrade na MLflow 3.1.3 nebo novější ve vašem vývojovém prostředí:

    %pip install mlflow>=3.1.3
dbutils.library.restartPython()

  2. Povolte shromažďování zpětné vazby účastníků v aplikaci Review App .

  3. Nahraďte volání rozhraní API pro zpětnou vazbu protokolováním hodnocení MLflow 3.

  4. Nasazení agenta pomocí MLflow 3:

    • Trasování v reálném čase automaticky zachycuje všechny interakce.
    • Hodnocení se připojují přímo k trasám pro jednotnou viditelnost

  5. Nastavení provozního monitorování (volitelné):

Jak funguje rozhraní API pro zpětnou vazbu (zastaralé)

Model zpětné vazby odhalil koncový bod REST, který přijal strukturovanou zpětnou vazbu ohledně odpovědí agenta. Po zpracování požadavku agenta byste odeslali zpětnou vazbu prostřednictvím požadavku POST na koncový bod zpětné vazby.

Příklad žádosti o zpětnou vazbu:

curl \
  -u token:$DATABRICKS_TOKEN \
  -X POST \
  -H "Content-Type: application/json" \
  -d '
      {
          "dataframe_records": [
              {
                  "source": {
                      "id": "user@company.com",
                      "type": "human"
                  },
                  "request_id": "573d4a61-4adb-41bd-96db-0ec8cebc3744",
                  "text_assessments": [
                      {
                          "ratings": {
                              "answer_correct": {
                                  "value": "positive"
                              },
                              "accurate": {
                                  "value": "positive"
                              }
                          },
                          "free_text_comment": "The answer used the provided context to talk about pipelines"
                      }
                  ],
                  "retrieval_assessments": [
                      {
                          "ratings": {
                              "groundedness": {
                                  "value": "positive"
                              }
                          }
                      }
                  ]
              }
          ]
      }' \
https://<workspace-host>.databricks.com/serving-endpoints/<your-agent-endpoint-name>/served-models/feedback/invocations

Do polí text_assessments.ratings a retrieval_assessments.ratings můžete předat další nebo různé páry klíč-hodnota a poskytnout tak různé typy zpětné vazby. V příkladu datová část zpětné vazby označuje, že odpověď agenta na požadavek s ID 573d4a61-4adb-41bd-96db-0ec8cebc3744 je správná, přesná a zakotvená v kontextu získaném nástrojem pro získávání.

Omezení rozhraní API pro zpětnou vazbu

Rozhraní API pro experimentální zpětnou vazbu má několik omezení:

  • Žádné ověření vstupu; Rozhraní API vždy úspěšně reaguje i s neplatným vstupem.
  • Požadované ID požadavku Databricks: Potřebujete předat databricks_request_id z původního požadavku agenta.
  • Závislost odvozovací tabulky: Zpětná vazba se shromažďuje s využitím odvozovacích tabulek se svými vlastními omezeními.
  • Omezené zpracování chyb: Žádné smysluplné chybové zprávy pro řešení potíží

Pokud chcete získat požadované databricks_request_id, musíte do původního požadavku zahrnout {"databricks_options": {"return_trace": True}} agentovi obsluhující koncový bod.

Další zdroje informací

  • Last updated on