Vstupní vazba dotazu pomocníka Azure OpenAI pro Azure Functions

Článek
05/21/2024

Důležité

Rozšíření Azure OpenAI pro Azure Functions je aktuálně ve verzi Preview.

Vstupní vazba dotazu pomocníka Azure OpenAI umožňuje integrovat dotazy rozhraní API asistentů do provádění kódu.

Informace o nastavení a konfiguraci rozšíření Azure OpenAI najdete v tématu Rozšíření Azure OpenAI pro Azure Functions. Další informace o asistentech Azure OpenAI najdete v tématu Rozhraní API pomocníků Azure OpenAI.

Poznámka:

Odkazy a příklady jsou k dispozici pouze pro model Node.js v4.

Poznámka:

Odkazy a příklady jsou k dispozici pouze pro model Pythonu v2.

Poznámka:

I když jsou podporovány oba modely procesu jazyka C#, jsou k dispozici pouze příklady izolovaného modelu pracovního procesu .

Příklad

Tento příklad ukazuje proces vytvoření, kdy funkce HTTP GET, která dotazuje historii konverzací chatovacího robota asistenta. Odpověď na výzvu se vrátí v odpovědi HTTP.

    public static async Task<IActionResult> GetChatState(
       [HttpTrigger(AuthorizationLevel.Anonymous, "get", Route = "assistants/{assistantId}")] HttpRequestData req,
       string assistantId,
       [AssistantQueryInput("{assistantId}", TimestampUtc = "{Query.timestampUTC}", ChatStorageConnectionSetting = DefaultChatStorageConnectionSetting, CollectionName = DefaultCollectionName)] AssistantState state)
    {
        return new OkObjectResult(state);
    }
}

Tento příklad ukazuje proces vytvoření, kdy funkce HTTP GET, která dotazuje historii konverzací chatovacího robota asistenta. Odpověď na výzvu se vrátí v odpovědi HTTP.

                "Ask for clarification if a user request is ambiguous.";

        AssistantCreateRequest assistantCreateRequest = new AssistantCreateRequest(assistantId, instructions);
        assistantCreateRequest.setChatStorageConnectionSetting(DEFAULT_CHATSTORAGE);
        assistantCreateRequest.setCollectionName(DEFAULT_COLLECTION);

        message.setValue(assistantCreateRequest);
        JSONObject response = new JSONObject();
        response.put("assistantId", assistantId);
        
        return request.createResponseBuilder(HttpStatus.CREATED)
            .header("Content-Type", "application/json")
            .body(response.toString())
            .build();    
}

Příklady ještě nejsou k dispozici.

Tento příklad ukazuje proces vytvoření, kdy funkce HTTP GET, která dotazuje historii konverzací chatovacího robota asistenta. Odpověď na výzvu se vrátí v odpovědi HTTP.

            }
        };
    }
})


const chatBotQueryInput = input.generic({
    type: 'assistantQuery',
    id: '{assistantId}',
    timestampUtc: '{Query.timestampUTC}',
    chatStorageConnectionSetting: CHAT_STORAGE_CONNECTION_SETTING,
    collectionName: COLLECTION_NAME
})
app.http('GetChatState', {
    methods: ['GET'],

Tento příklad ukazuje proces vytvoření, kdy funkce HTTP GET, která dotazuje historii konverzací chatovacího robota asistenta. Odpověď na výzvu se vrátí v odpovědi HTTP.

Tady je soubor function.json pro získání stavu chatu:

{
  "bindings": [
    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "Request",
      "route": "assistants/{assistantId}",
      "methods": [
        "get"
      ]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "Response"
    },
    {
      "name": "State",
      "type": "assistantQuery",
      "direction": "in",
      "dataType": "string",
      "id": "{assistantId}",
      "timestampUtc": "{Query.timestampUTC}",
      "chatStorageConnectionSetting": "AzureWebJobsStorage",
      "collectionName": "ChatState"
    }
  ]
}

Další informace o function.json vlastnosti souboru naleznete v části Konfigurace .

using namespace System.Net

param($Request, $TriggerMetadata, $State)

Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
    StatusCode = [HttpStatusCode]::OK
    Body       = $State
    Headers    = @{
        "Content-Type" = "application/json"
    }
})

Tento příklad ukazuje proces vytvoření, kdy funkce HTTP GET, která dotazuje historii konverzací chatovacího robota asistenta. Odpověď na výzvu se vrátí v odpovědi HTTP.

    recent_message_content = data['recentMessages'][0]['content']
    return func.HttpResponse(recent_message_content, status_code=200, mimetype="text/plain")


@apis.function_name("GetChatState")

Atributy

Pomocí atributu AssistantQuery definujte vstupní vazbu dotazu asistenta, která podporuje tyto parametry:

Parametr	Popis
Id	Získá ID asistenta k dotazování.
TimeStampUtc	Volitelné. Získá nebo nastaví časové razítko nejstarší zprávy v historii chatu k načtení. Časové razítko by mělo být ve formátu ISO 8601 – například 2023-08-01T00:00:00Z.

Poznámky

Poznámka assistantQuery umožňuje definovat vstupní vazbu dotazu asistenta, která podporuje tyto parametry:

Element (Prvek)	Popis
Jméno	Získá nebo nastaví název vstupní vazby.
id	Získá ID asistenta k dotazování.
timeStampUtc	Volitelné. Získá nebo nastaví časové razítko nejstarší zprávy v historii chatu k načtení. Časové razítko by mělo být ve formátu ISO 8601 – například 2023-08-01T00:00:00Z.

Dekoratéry

Během náhledu definujte vstupní vazbu jako generic_input_binding vazbu typu assistantQuery, která podporuje tyto parametry:

Parametr	Popis
arg_name	Název proměnné, která představuje parametr vazby.
id	Získá ID asistenta k dotazování.
time_stamp_utc	Volitelné. Získá nebo nastaví časové razítko nejstarší zprávy v historii chatu k načtení. Časové razítko by mělo být ve formátu ISO 8601 – například 2023-08-01T00:00:00Z.

Konfigurace

Vazba podporuje tyto vlastnosti konfigurace, které jste nastavili v souboru function.json.

Vlastnost	Popis
type	Musí být `assistantQuery`.
direction	Musí být `in`.
Jméno	Název vstupní vazby.
id	Získá ID asistenta k dotazování.
timeStampUtc	Volitelné. Získá nebo nastaví časové razítko nejstarší zprávy v historii chatu k načtení. Časové razítko by mělo být ve formátu ISO 8601 – například 2023-08-01T00:00:00Z.

Konfigurace

Vazba podporuje tyto vlastnosti, které jsou definovány v kódu:

Vlastnost	Popis
id	Získá ID asistenta k dotazování.
timeStampUtc	Volitelné. Získá nebo nastaví časové razítko nejstarší zprávy v historii chatu k načtení. Časové razítko by mělo být ve formátu ISO 8601 – například 2023-08-01T00:00:00Z.

Využití

Kompletní příklady najdete v části Příklad.