Google Cloud Dialogflow Cx V3 Client - Class SessionsClient (0.8.0)

 use Google\ApiCore\ApiException;
use Google\Cloud\Dialogflow\Cx\V3\Client\SessionsClient;
use Google\Cloud\Dialogflow\Cx\V3\DetectIntentRequest;
use Google\Cloud\Dialogflow\Cx\V3\DetectIntentResponse;
use Google\Cloud\Dialogflow\Cx\V3\QueryInput;

/**
 * @param string $formattedSession       The name of the session this query is sent to.
 *                                       Format:
 *                                       `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/sessions/<Session
 *                                       ID>` or
 *                                       `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/sessions/<SessionID>`.
 *                                       If `Environment ID` is not specified, we assume default 'draft'
 *                                       environment.
 *                                       It's up to the API caller to choose an appropriate `Session ID`. It can be
 *                                       a random number or some type of session identifiers (preferably hashed).
 *                                       The length of the `Session ID` must not exceed 36 characters.
 *
 *                                       For more information, see the [sessions
 *                                       guide](https://cloud.google.com/dialogflow/cx/docs/concept/session).
 *
 *                                       Note: Always use agent versions for production traffic.
 *                                       See [Versions and
 *                                       environments](https://cloud.google.com/dialogflow/cx/docs/concept/version). Please see
 *                                       {@see SessionsClient::sessionName()} for help formatting this field.
 * @param string $queryInputLanguageCode The language of the input. See [Language
 *                                       Support](https://cloud.google.com/dialogflow/cx/docs/reference/language)
 *                                       for a list of the currently supported language codes. Note that queries in
 *                                       the same session do not necessarily need to specify the same language.
 */
function detect_intent_sample(string $formattedSession, string $queryInputLanguageCode): void
{
    // Create a client.
    $sessionsClient = new SessionsClient();

    // Prepare the request message.
    $queryInput = (new QueryInput())
        ->setLanguageCode($queryInputLanguageCode);
    $request = (new DetectIntentRequest())
        ->setSession($formattedSession)
        ->setQueryInput($queryInput);

    // Call the API and handle any network failures.
    try {
        /** @var DetectIntentResponse $response */
        $response = $sessionsClient->detectIntent($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedSession = SessionsClient::sessionName('[PROJECT]', '[LOCATION]', '[AGENT]', '[SESSION]');
    $queryInputLanguageCode = '[LANGUAGE_CODE]';

    detect_intent_sample($formattedSession, $queryInputLanguageCode);
} 

 use Google\ApiCore\ApiException;
use Google\Cloud\Dialogflow\Cx\V3\Client\SessionsClient;
use Google\Cloud\Dialogflow\Cx\V3\FulfillIntentRequest;
use Google\Cloud\Dialogflow\Cx\V3\FulfillIntentResponse;

/**
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function fulfill_intent_sample(): void
{
    // Create a client.
    $sessionsClient = new SessionsClient();

    // Prepare the request message.
    $request = new FulfillIntentRequest();

    // Call the API and handle any network failures.
    try {
        /** @var FulfillIntentResponse $response */
        $response = $sessionsClient->fulfillIntent($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
} 

 use Google\ApiCore\ApiException;
use Google\Cloud\Dialogflow\Cx\V3\Client\SessionsClient;
use Google\Cloud\Dialogflow\Cx\V3\MatchIntentRequest;
use Google\Cloud\Dialogflow\Cx\V3\MatchIntentResponse;
use Google\Cloud\Dialogflow\Cx\V3\QueryInput;

/**
 * @param string $formattedSession       The name of the session this query is sent to.
 *                                       Format:
 *                                       `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/sessions/<SessionID>`
 *                                       or
 *                                       `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/sessions/<SessionID>`.
 *                                       If `Environment ID` is not specified, we assume default 'draft'
 *                                       environment.
 *                                       It's up to the API caller to choose an appropriate `Session ID`. It can be
 *                                       a random number or some type of session identifiers (preferably hashed).
 *                                       The length of the `Session ID` must not exceed 36 characters.
 *
 *                                       For more information, see the [sessions
 *                                       guide](https://cloud.google.com/dialogflow/cx/docs/concept/session). Please see
 *                                       {@see SessionsClient::sessionName()} for help formatting this field.
 * @param string $queryInputLanguageCode The language of the input. See [Language
 *                                       Support](https://cloud.google.com/dialogflow/cx/docs/reference/language)
 *                                       for a list of the currently supported language codes. Note that queries in
 *                                       the same session do not necessarily need to specify the same language.
 */
function match_intent_sample(string $formattedSession, string $queryInputLanguageCode): void
{
    // Create a client.
    $sessionsClient = new SessionsClient();

    // Prepare the request message.
    $queryInput = (new QueryInput())
        ->setLanguageCode($queryInputLanguageCode);
    $request = (new MatchIntentRequest())
        ->setSession($formattedSession)
        ->setQueryInput($queryInput);

    // Call the API and handle any network failures.
    try {
        /** @var MatchIntentResponse $response */
        $response = $sessionsClient->matchIntent($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedSession = SessionsClient::sessionName('[PROJECT]', '[LOCATION]', '[AGENT]', '[SESSION]');
    $queryInputLanguageCode = '[LANGUAGE_CODE]';

    match_intent_sample($formattedSession, $queryInputLanguageCode);
} 

 use Google\ApiCore\ApiException;
use Google\ApiCore\ServerStream;
use Google\Cloud\Dialogflow\Cx\V3\Client\SessionsClient;
use Google\Cloud\Dialogflow\Cx\V3\DetectIntentRequest;
use Google\Cloud\Dialogflow\Cx\V3\DetectIntentResponse;
use Google\Cloud\Dialogflow\Cx\V3\QueryInput;

/**
 * @param string $formattedSession       The name of the session this query is sent to.
 *                                       Format:
 *                                       `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/sessions/<Session
 *                                       ID>` or
 *                                       `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/environments/<EnvironmentID>/sessions/<SessionID>`.
 *                                       If `Environment ID` is not specified, we assume default 'draft'
 *                                       environment.
 *                                       It's up to the API caller to choose an appropriate `Session ID`. It can be
 *                                       a random number or some type of session identifiers (preferably hashed).
 *                                       The length of the `Session ID` must not exceed 36 characters.
 *
 *                                       For more information, see the [sessions
 *                                       guide](https://cloud.google.com/dialogflow/cx/docs/concept/session).
 *
 *                                       Note: Always use agent versions for production traffic.
 *                                       See [Versions and
 *                                       environments](https://cloud.google.com/dialogflow/cx/docs/concept/version). Please see
 *                                       {@see SessionsClient::sessionName()} for help formatting this field.
 * @param string $queryInputLanguageCode The language of the input. See [Language
 *                                       Support](https://cloud.google.com/dialogflow/cx/docs/reference/language)
 *                                       for a list of the currently supported language codes. Note that queries in
 *                                       the same session do not necessarily need to specify the same language.
 */
function server_streaming_detect_intent_sample(
    string $formattedSession,
    string $queryInputLanguageCode
): void {
    // Create a client.
    $sessionsClient = new SessionsClient();

    // Prepare the request message.
    $queryInput = (new QueryInput())
        ->setLanguageCode($queryInputLanguageCode);
    $request = (new DetectIntentRequest())
        ->setSession($formattedSession)
        ->setQueryInput($queryInput);

    // Call the API and handle any network failures.
    try {
        /** @var ServerStream $stream */
        $stream = $sessionsClient->serverStreamingDetectIntent($request);

        /** @var DetectIntentResponse $element */
        foreach ($stream->readAll() as $element) {
            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedSession = SessionsClient::sessionName('[PROJECT]', '[LOCATION]', '[AGENT]', '[SESSION]');
    $queryInputLanguageCode = '[LANGUAGE_CODE]';

    server_streaming_detect_intent_sample($formattedSession, $queryInputLanguageCode);
} 

 use Google\ApiCore\ApiException;
use Google\ApiCore\BidiStream;
use Google\Cloud\Dialogflow\Cx\V3\Client\SessionsClient;
use Google\Cloud\Dialogflow\Cx\V3\QueryInput;
use Google\Cloud\Dialogflow\Cx\V3\StreamingDetectIntentRequest;
use Google\Cloud\Dialogflow\Cx\V3\StreamingDetectIntentResponse;

/**
 * @param string $queryInputLanguageCode The language of the input. See [Language
 *                                       Support](https://cloud.google.com/dialogflow/cx/docs/reference/language)
 *                                       for a list of the currently supported language codes. Note that queries in
 *                                       the same session do not necessarily need to specify the same language.
 */
function streaming_detect_intent_sample(string $queryInputLanguageCode): void
{
    // Create a client.
    $sessionsClient = new SessionsClient();

    // Prepare the request message.
    $queryInput = (new QueryInput())
        ->setLanguageCode($queryInputLanguageCode);
    $request = (new StreamingDetectIntentRequest())
        ->setQueryInput($queryInput);

    // Call the API and handle any network failures.
    try {
        /** @var BidiStream $stream */
        $stream = $sessionsClient->streamingDetectIntent();
        $stream->writeAll([$request,]);

        /** @var StreamingDetectIntentResponse $element */
        foreach ($stream->closeWriteAndReadAll() as $element) {
            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $queryInputLanguageCode = '[LANGUAGE_CODE]';

    streaming_detect_intent_sample($queryInputLanguageCode);
} 

 use Google\ApiCore\ApiException;
use Google\Cloud\Dialogflow\Cx\V3\AnswerFeedback;
use Google\Cloud\Dialogflow\Cx\V3\Client\SessionsClient;
use Google\Cloud\Dialogflow\Cx\V3\SubmitAnswerFeedbackRequest;

/**
 * @param string $formattedSession The name of the session the feedback was sent to. Please see
 *                                 {@see SessionsClient::sessionName()} for help formatting this field.
 * @param string $responseId       ID of the response to update its feedback. This is the same as
 *                                 DetectIntentResponse.response_id.
 */
function submit_answer_feedback_sample(string $formattedSession, string $responseId): void
{
    // Create a client.
    $sessionsClient = new SessionsClient();

    // Prepare the request message.
    $answerFeedback = new AnswerFeedback();
    $request = (new SubmitAnswerFeedbackRequest())
        ->setSession($formattedSession)
        ->setResponseId($responseId)
        ->setAnswerFeedback($answerFeedback);

    // Call the API and handle any network failures.
    try {
        /** @var AnswerFeedback $response */
        $response = $sessionsClient->submitAnswerFeedback($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedSession = SessionsClient::sessionName('[PROJECT]', '[LOCATION]', '[AGENT]', '[SESSION]');
    $responseId = '[RESPONSE_ID]';

    submit_answer_feedback_sample($formattedSession, $responseId);
} 

 use Google\ApiCore\ApiException;
use Google\Cloud\Dialogflow\Cx\V3\Client\SessionsClient;
use Google\Cloud\Location\GetLocationRequest;
use Google\Cloud\Location\Location;

/**
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function get_location_sample(): void
{
    // Create a client.
    $sessionsClient = new SessionsClient();

    // Prepare the request message.
    $request = new GetLocationRequest();

    // Call the API and handle any network failures.
    try {
        /** @var Location $response */
        $response = $sessionsClient->getLocation($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
} 

 use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\Dialogflow\Cx\V3\Client\SessionsClient;
use Google\Cloud\Location\ListLocationsRequest;
use Google\Cloud\Location\Location;

/**
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function list_locations_sample(): void
{
    // Create a client.
    $sessionsClient = new SessionsClient();

    // Prepare the request message.
    $request = new ListLocationsRequest();

    // Call the API and handle any network failures.
    try {
        /** @var PagedListResponse $response */
        $response = $sessionsClient->listLocations($request);

        /** @var Location $element */
        foreach ($response as $element) {
            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}