personalizer

package
v59.0.0+incompatible Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 28, 2021 License: MIT Imports: 10 Imported by: 0

Documentation ¶

Overview ¶

Package personalizer implements the Azure ARM Personalizer service API version v1.0.

Personalizer Service is an Azure Cognitive Service that makes it easy to target content and experiences without complex pre-analysis or cleanup of past data. Given a context and featurized content, the Personalizer Service returns which content item to show to users in rewardActionId. As rewards are sent in response to the use of rewardActionId, the reinforcement learning algorithm will improve the model and improve performance of future rank calls.

Index ¶

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func UserAgent ¶ 

func UserAgent() string

UserAgent returns the UserAgent string to use when sending http.Requests.

func Version ¶ 

func Version() string

Version returns the semantic version (see http://semver.org) of the client.

Types ¶

type BaseClient ¶ 

type BaseClient struct {
	autorest.Client
	Endpoint string
}

BaseClient is the base client for Personalizer.

func New ¶ 

func New(endpoint string) BaseClient

New creates an instance of the BaseClient client.

func NewWithoutDefaults ¶ 

func NewWithoutDefaults(endpoint string) BaseClient

NewWithoutDefaults creates an instance of the BaseClient client.

func (BaseClient) Rank ¶ 

func (client BaseClient) Rank(ctx context.Context, rankRequest RankRequest) (result RankResponse, err error)

Rank submit a Personalizer rank request, to get which of the provided actions should be used in the provided context. Parameters: rankRequest - a Personalizer request.

func (BaseClient) RankPreparer ¶ 

func (client BaseClient) RankPreparer(ctx context.Context, rankRequest RankRequest) (*http.Request, error)

RankPreparer prepares the Rank request.

func (BaseClient) RankResponder ¶ 

func (client BaseClient) RankResponder(resp *http.Response) (result RankResponse, err error)

RankResponder handles the response to the Rank request. The method always closes the http.Response Body.

func (BaseClient) RankSender ¶ 

func (client BaseClient) RankSender(req *http.Request) (*http.Response, error)

RankSender sends the Rank request. The method will close the http.Response Body if it receives an error.

type ContainerStatus ¶ 

type ContainerStatus struct {
	Service          *string `json:"service,omitempty"`
	APIStatus        *string `json:"apiStatus,omitempty"`
	APIStatusMessage *string `json:"apiStatusMessage,omitempty"`
}

ContainerStatus ...

type DateRange ¶ 

type DateRange struct {
	// From - READ-ONLY
	From *date.Time `json:"from,omitempty"`
	// To - READ-ONLY
	To *date.Time `json:"to,omitempty"`
}

DateRange ...

func (DateRange) MarshalJSON ¶ 

func (dr DateRange) MarshalJSON() ([]byte, error)

MarshalJSON is the custom marshaler for DateRange.

type Error ¶ 

type Error struct {
	// Code - High level error code. Possible values include: 'BadRequest', 'ResourceNotFound', 'InternalServerError', 'InvalidServiceConfiguration', 'InvalidPolicyConfiguration', 'InvalidPolicyContract', 'InvalidEvaluationContract', 'InvalidRewardRequest', 'InvalidEventIDToActivate', 'InvalidRankRequest', 'InvalidExportLogsRequest', 'InvalidContainer', 'FrontEndNotFound', 'EvaluationNotFound', 'LogsPropertiesNotFound', 'RankNullResponse', 'UpdateConfigurationFailed', 'ModelResetFailed'
	Code ErrorCode `json:"code,omitempty"`
	// Message - A message explaining the error reported by the service.
	Message *string `json:"message,omitempty"`
	// Target - Error source element.
	Target *string `json:"target,omitempty"`
	// Details - An array of details about specific errors that led to this reported error.
	Details *[]Error `json:"details,omitempty"`
	// InnerError - Finer error details.
	InnerError *InternalError `json:"innerError,omitempty"`
}

Error the error object.

type ErrorCode ¶ 

type ErrorCode string

ErrorCode enumerates the values for error code. 

const (
	// BadRequest Request could not be understood by the server.
	BadRequest ErrorCode = "BadRequest"
	// EvaluationNotFound Evaluation not found.
	EvaluationNotFound ErrorCode = "EvaluationNotFound"
	// FrontEndNotFound Front end not found.
	FrontEndNotFound ErrorCode = "FrontEndNotFound"
	// InternalServerError A generic error has occurred on the server.
	InternalServerError ErrorCode = "InternalServerError"
	// InvalidContainer SAS Uri must be the Uri to a container that has write permissions.
	InvalidContainer ErrorCode = "InvalidContainer"
	// InvalidEvaluationContract Invalid evaluation contract.
	InvalidEvaluationContract ErrorCode = "InvalidEvaluationContract"
	// InvalidEventIDToActivate Invalid activate event request.
	InvalidEventIDToActivate ErrorCode = "InvalidEventIdToActivate"
	// InvalidExportLogsRequest Invalid export logs request.
	InvalidExportLogsRequest ErrorCode = "InvalidExportLogsRequest"
	// InvalidPolicyConfiguration Invalid policy configuration.
	InvalidPolicyConfiguration ErrorCode = "InvalidPolicyConfiguration"
	// InvalidPolicyContract Invalid policy contract.
	InvalidPolicyContract ErrorCode = "InvalidPolicyContract"
	// InvalidRankRequest Invalid rank request.
	InvalidRankRequest ErrorCode = "InvalidRankRequest"
	// InvalidRewardRequest Invalid reward request.
	InvalidRewardRequest ErrorCode = "InvalidRewardRequest"
	// InvalidServiceConfiguration Invalid service configuration.
	InvalidServiceConfiguration ErrorCode = "InvalidServiceConfiguration"
	// LogsPropertiesNotFound Logs properties not found.
	LogsPropertiesNotFound ErrorCode = "LogsPropertiesNotFound"
	// ModelResetFailed Model reset failed.
	ModelResetFailed ErrorCode = "ModelResetFailed"
	// RankNullResponse Rank call returned null response.
	RankNullResponse ErrorCode = "RankNullResponse"
	// ResourceNotFound Requested resource does not exist on the server.
	ResourceNotFound ErrorCode = "ResourceNotFound"
	// UpdateConfigurationFailed Failed to update configuration.
	UpdateConfigurationFailed ErrorCode = "UpdateConfigurationFailed"
)

func PossibleErrorCodeValues ¶ 

func PossibleErrorCodeValues() []ErrorCode

PossibleErrorCodeValues returns an array of possible values for the ErrorCode const type.

type ErrorResponse ¶ 

type ErrorResponse struct {
	// Error - The error object.
	Error *Error `json:"error,omitempty"`
}

ErrorResponse used to return an error to the client

type Evaluation ¶ 

type Evaluation struct {
	autorest.Response `json:"-"`
	// ID - READ-ONLY
	ID *string `json:"id,omitempty"`
	// Name - READ-ONLY
	Name *string `json:"name,omitempty"`
	// StartTime - READ-ONLY
	StartTime *date.Time `json:"startTime,omitempty"`
	// EndTime - READ-ONLY
	EndTime *date.Time `json:"endTime,omitempty"`
	// JobID - READ-ONLY
	JobID *string `json:"jobId,omitempty"`
	// Status - READ-ONLY; Possible values include: 'Completed', 'Pending', 'Failed', 'NotSubmitted'
	Status            EvaluationJobStatus `json:"status,omitempty"`
	PolicyResults     *[]PolicyResult     `json:"policyResults,omitempty"`
	FeatureImportance *[][]string         `json:"featureImportance,omitempty"`
}

Evaluation ...

func (Evaluation) MarshalJSON ¶ 

func (e Evaluation) MarshalJSON() ([]byte, error)

MarshalJSON is the custom marshaler for Evaluation.

type EvaluationContract ¶ 

type EvaluationContract struct {
	// EnableOfflineExperimentation - True if the evaluation should explore for a more optimal Learning settings.
	EnableOfflineExperimentation *bool `json:"enableOfflineExperimentation,omitempty"`
	// Name - The name of the evaluation.
	Name *string `json:"name,omitempty"`
	// StartTime - The start time of the evaluation.
	StartTime *date.Time `json:"startTime,omitempty"`
	// EndTime - The end time of the evaluation.
	EndTime *date.Time `json:"endTime,omitempty"`
	// Policies - Additional Learning settings to evaluate.
	Policies *[]PolicyContract `json:"policies,omitempty"`
}

EvaluationContract a counterfactual evaluation.

type EvaluationJobStatus ¶ 

type EvaluationJobStatus string

EvaluationJobStatus enumerates the values for evaluation job status. 

const (
	// Completed ...
	Completed EvaluationJobStatus = "completed"
	// Failed ...
	Failed EvaluationJobStatus = "failed"
	// NotSubmitted ...
	NotSubmitted EvaluationJobStatus = "notSubmitted"
	// Pending ...
	Pending EvaluationJobStatus = "pending"
)

func PossibleEvaluationJobStatusValues ¶ 

func PossibleEvaluationJobStatusValues() []EvaluationJobStatus

PossibleEvaluationJobStatusValues returns an array of possible values for the EvaluationJobStatus const type.

type EvaluationsClient ¶ 

type EvaluationsClient struct {
	BaseClient
}

EvaluationsClient is the personalizer Service is an Azure Cognitive Service that makes it easy to target content and experiences without complex pre-analysis or cleanup of past data. Given a context and featurized content, the Personalizer Service returns which content item to show to users in rewardActionId. As rewards are sent in response to the use of rewardActionId, the reinforcement learning algorithm will improve the model and improve performance of future rank calls.

func NewEvaluationsClient ¶ 

func NewEvaluationsClient(endpoint string) EvaluationsClient

NewEvaluationsClient creates an instance of the EvaluationsClient client.

func (EvaluationsClient) Create ¶ 

func (client EvaluationsClient) Create(ctx context.Context, evaluation EvaluationContract) (result Evaluation, err error)

Create submit a new evaluation job. Parameters: evaluation - the evaluation job definition.

func (EvaluationsClient) CreatePreparer ¶ 

func (client EvaluationsClient) CreatePreparer(ctx context.Context, evaluation EvaluationContract) (*http.Request, error)

CreatePreparer prepares the Create request.

func (EvaluationsClient) CreateResponder ¶ 

func (client EvaluationsClient) CreateResponder(resp *http.Response) (result Evaluation, err error)

CreateResponder handles the response to the Create request. The method always closes the http.Response Body.

func (EvaluationsClient) CreateSender ¶ 

func (client EvaluationsClient) CreateSender(req *http.Request) (*http.Response, error)

CreateSender sends the Create request. The method will close the http.Response Body if it receives an error.

func (EvaluationsClient) Delete ¶ 

func (client EvaluationsClient) Delete(ctx context.Context, evaluationID string) (result autorest.Response, err error)

Delete delete the evaluation associated with the Id. Parameters: evaluationID - id of the evaluation to delete.

func (EvaluationsClient) DeletePreparer ¶ 

func (client EvaluationsClient) DeletePreparer(ctx context.Context, evaluationID string) (*http.Request, error)

DeletePreparer prepares the Delete request.

func (EvaluationsClient) DeleteResponder ¶ 

func (client EvaluationsClient) DeleteResponder(resp *http.Response) (result autorest.Response, err error)

DeleteResponder handles the response to the Delete request. The method always closes the http.Response Body.

func (EvaluationsClient) DeleteSender ¶ 

func (client EvaluationsClient) DeleteSender(req *http.Request) (*http.Response, error)

DeleteSender sends the Delete request. The method will close the http.Response Body if it receives an error.

func (EvaluationsClient) Get ¶ 

func (client EvaluationsClient) Get(ctx context.Context, evaluationID string) (result Evaluation, err error)

Get get the evaluation associated with the Id. Parameters: evaluationID - id of the evaluation.

func (EvaluationsClient) GetPreparer ¶ 

func (client EvaluationsClient) GetPreparer(ctx context.Context, evaluationID string) (*http.Request, error)

GetPreparer prepares the Get request.

func (EvaluationsClient) GetResponder ¶ 

func (client EvaluationsClient) GetResponder(resp *http.Response) (result Evaluation, err error)

GetResponder handles the response to the Get request. The method always closes the http.Response Body.

func (EvaluationsClient) GetSender ¶ 

func (client EvaluationsClient) GetSender(req *http.Request) (*http.Response, error)

GetSender sends the Get request. The method will close the http.Response Body if it receives an error.

func (EvaluationsClient) List ¶ 

func (client EvaluationsClient) List(ctx context.Context) (result ListEvaluation, err error)

List list all the submitted evaluations.

func (EvaluationsClient) ListPreparer ¶ 

func (client EvaluationsClient) ListPreparer(ctx context.Context) (*http.Request, error)

ListPreparer prepares the List request.

func (EvaluationsClient) ListResponder ¶ 

func (client EvaluationsClient) ListResponder(resp *http.Response) (result ListEvaluation, err error)

ListResponder handles the response to the List request. The method always closes the http.Response Body.

func (EvaluationsClient) ListSender ¶ 

func (client EvaluationsClient) ListSender(req *http.Request) (*http.Response, error)

ListSender sends the List request. The method will close the http.Response Body if it receives an error.

type EventsClient ¶ 

type EventsClient struct {
	BaseClient
}

EventsClient is the personalizer Service is an Azure Cognitive Service that makes it easy to target content and experiences without complex pre-analysis or cleanup of past data. Given a context and featurized content, the Personalizer Service returns which content item to show to users in rewardActionId. As rewards are sent in response to the use of rewardActionId, the reinforcement learning algorithm will improve the model and improve performance of future rank calls.

func NewEventsClient ¶ 

func NewEventsClient(endpoint string) EventsClient

NewEventsClient creates an instance of the EventsClient client.

func (EventsClient) Activate ¶ 

func (client EventsClient) Activate(ctx context.Context, eventID string) (result autorest.Response, err error)

Activate report that the specified event was actually displayed to the user and a reward should be expected for it Parameters: eventID - the event ID this activation applies to.

func (EventsClient) ActivatePreparer ¶ 

func (client EventsClient) ActivatePreparer(ctx context.Context, eventID string) (*http.Request, error)

ActivatePreparer prepares the Activate request.

func (EventsClient) ActivateResponder ¶ 

func (client EventsClient) ActivateResponder(resp *http.Response) (result autorest.Response, err error)

ActivateResponder handles the response to the Activate request. The method always closes the http.Response Body.

func (EventsClient) ActivateSender ¶ 

func (client EventsClient) ActivateSender(req *http.Request) (*http.Response, error)

ActivateSender sends the Activate request. The method will close the http.Response Body if it receives an error.

func (EventsClient) Reward ¶ 

func (client EventsClient) Reward(ctx context.Context, eventID string, reward RewardRequest) (result autorest.Response, err error)

Reward report reward that resulted from using the action specified in rewardActionId for the specified event. Parameters: eventID - the event id this reward applies to. reward - the reward should be a floating point number, typically between 0 and 1.

func (EventsClient) RewardPreparer ¶ 

func (client EventsClient) RewardPreparer(ctx context.Context, eventID string, reward RewardRequest) (*http.Request, error)

RewardPreparer prepares the Reward request.

func (EventsClient) RewardResponder ¶ 

func (client EventsClient) RewardResponder(resp *http.Response) (result autorest.Response, err error)

RewardResponder handles the response to the Reward request. The method always closes the http.Response Body.

func (EventsClient) RewardSender ¶ 

func (client EventsClient) RewardSender(req *http.Request) (*http.Response, error)

RewardSender sends the Reward request. The method will close the http.Response Body if it receives an error.

type InternalError ¶ 

type InternalError struct {
	// Code - Detailed error code.
	Code *string `json:"code,omitempty"`
	// Innererror - The error object.
	Innererror *InternalError `json:"innererror,omitempty"`
}

InternalError an object containing more specific information than the parent object about the error.

type ListEvaluation ¶ 

type ListEvaluation struct {
	autorest.Response `json:"-"`
	Value             *[]Evaluation `json:"value,omitempty"`
}

ListEvaluation ...

type LogClient ¶ 

type LogClient struct {
	BaseClient
}

LogClient is the personalizer Service is an Azure Cognitive Service that makes it easy to target content and experiences without complex pre-analysis or cleanup of past data. Given a context and featurized content, the Personalizer Service returns which content item to show to users in rewardActionId. As rewards are sent in response to the use of rewardActionId, the reinforcement learning algorithm will improve the model and improve performance of future rank calls.

func NewLogClient ¶ 

func NewLogClient(endpoint string) LogClient

NewLogClient creates an instance of the LogClient client.

func (LogClient) Delete ¶ 

func (client LogClient) Delete(ctx context.Context) (result autorest.Response, err error)

Delete delete all generated logs.

func (LogClient) DeletePreparer ¶ 

func (client LogClient) DeletePreparer(ctx context.Context) (*http.Request, error)

DeletePreparer prepares the Delete request.

func (LogClient) DeleteResponder ¶ 

func (client LogClient) DeleteResponder(resp *http.Response) (result autorest.Response, err error)

DeleteResponder handles the response to the Delete request. The method always closes the http.Response Body.

func (LogClient) DeleteSender ¶ 

func (client LogClient) DeleteSender(req *http.Request) (*http.Response, error)

DeleteSender sends the Delete request. The method will close the http.Response Body if it receives an error.

func (LogClient) GetProperties ¶ 

func (client LogClient) GetProperties(ctx context.Context) (result LogsProperties, err error)

GetProperties get properties of generated logs.

func (LogClient) GetPropertiesPreparer ¶ 

func (client LogClient) GetPropertiesPreparer(ctx context.Context) (*http.Request, error)

GetPropertiesPreparer prepares the GetProperties request.

func (LogClient) GetPropertiesResponder ¶ 

func (client LogClient) GetPropertiesResponder(resp *http.Response) (result LogsProperties, err error)

GetPropertiesResponder handles the response to the GetProperties request. The method always closes the http.Response Body.

func (LogClient) GetPropertiesSender ¶ 

func (client LogClient) GetPropertiesSender(req *http.Request) (*http.Response, error)

GetPropertiesSender sends the GetProperties request. The method will close the http.Response Body if it receives an error.

type LogsProperties ¶ 

type LogsProperties struct {
	autorest.Response `json:"-"`
	// DateRange - READ-ONLY
	DateRange *LogsPropertiesDateRange `json:"dateRange,omitempty"`
}

LogsProperties ...

func (LogsProperties) MarshalJSON ¶ 

func (lp LogsProperties) MarshalJSON() ([]byte, error)

MarshalJSON is the custom marshaler for LogsProperties.

type LogsPropertiesDateRange ¶ 

type LogsPropertiesDateRange struct {
	// From - READ-ONLY
	From *date.Time `json:"from,omitempty"`
	// To - READ-ONLY
	To *date.Time `json:"to,omitempty"`
}

LogsPropertiesDateRange ...

func (LogsPropertiesDateRange) MarshalJSON ¶ 

func (lpR LogsPropertiesDateRange) MarshalJSON() ([]byte, error)

MarshalJSON is the custom marshaler for LogsPropertiesDateRange.

type ModelClient ¶ 

type ModelClient struct {
	BaseClient
}

ModelClient is the personalizer Service is an Azure Cognitive Service that makes it easy to target content and experiences without complex pre-analysis or cleanup of past data. Given a context and featurized content, the Personalizer Service returns which content item to show to users in rewardActionId. As rewards are sent in response to the use of rewardActionId, the reinforcement learning algorithm will improve the model and improve performance of future rank calls.

func NewModelClient ¶ 

func NewModelClient(endpoint string) ModelClient

NewModelClient creates an instance of the ModelClient client.

func (ModelClient) Get ¶ 

func (client ModelClient) Get(ctx context.Context) (result ReadCloser, err error)

Get get the model file generated by Personalizer service.

func (ModelClient) GetPreparer ¶ 

func (client ModelClient) GetPreparer(ctx context.Context) (*http.Request, error)

GetPreparer prepares the Get request.

func (ModelClient) GetProperties ¶ 

func (client ModelClient) GetProperties(ctx context.Context) (result ModelProperties, err error)

GetProperties get properties of the model file generated by Personalizer service.

func (ModelClient) GetPropertiesPreparer ¶ 

func (client ModelClient) GetPropertiesPreparer(ctx context.Context) (*http.Request, error)

GetPropertiesPreparer prepares the GetProperties request.

func (ModelClient) GetPropertiesResponder ¶ 

func (client ModelClient) GetPropertiesResponder(resp *http.Response) (result ModelProperties, err error)

GetPropertiesResponder handles the response to the GetProperties request. The method always closes the http.Response Body.

func (ModelClient) GetPropertiesSender ¶ 

func (client ModelClient) GetPropertiesSender(req *http.Request) (*http.Response, error)

GetPropertiesSender sends the GetProperties request. The method will close the http.Response Body if it receives an error.

func (ModelClient) GetResponder ¶ 

func (client ModelClient) GetResponder(resp *http.Response) (result ReadCloser, err error)

GetResponder handles the response to the Get request. The method always closes the http.Response Body.

func (ModelClient) GetSender ¶ 

func (client ModelClient) GetSender(req *http.Request) (*http.Response, error)

GetSender sends the Get request. The method will close the http.Response Body if it receives an error.

func (ModelClient) Reset ¶ 

func (client ModelClient) Reset(ctx context.Context) (result autorest.Response, err error)

Reset resets the model file generated by Personalizer service.

func (ModelClient) ResetPreparer ¶ 

func (client ModelClient) ResetPreparer(ctx context.Context) (*http.Request, error)

ResetPreparer prepares the Reset request.

func (ModelClient) ResetResponder ¶ 

func (client ModelClient) ResetResponder(resp *http.Response) (result autorest.Response, err error)

ResetResponder handles the response to the Reset request. The method always closes the http.Response Body.

func (ModelClient) ResetSender ¶ 

func (client ModelClient) ResetSender(req *http.Request) (*http.Response, error)

ResetSender sends the Reset request. The method will close the http.Response Body if it receives an error.

type ModelProperties ¶ 

type ModelProperties struct {
	autorest.Response `json:"-"`
	// CreationTime - READ-ONLY
	CreationTime *date.Time `json:"creationTime,omitempty"`
	// LastModifiedTime - READ-ONLY
	LastModifiedTime *date.Time `json:"lastModifiedTime,omitempty"`
}

ModelProperties ...

func (ModelProperties) MarshalJSON ¶ 

func (mp ModelProperties) MarshalJSON() ([]byte, error)

MarshalJSON is the custom marshaler for ModelProperties.

type PolicyClient ¶ 

type PolicyClient struct {
	BaseClient
}

PolicyClient is the personalizer Service is an Azure Cognitive Service that makes it easy to target content and experiences without complex pre-analysis or cleanup of past data. Given a context and featurized content, the Personalizer Service returns which content item to show to users in rewardActionId. As rewards are sent in response to the use of rewardActionId, the reinforcement learning algorithm will improve the model and improve performance of future rank calls.

func NewPolicyClient ¶ 

func NewPolicyClient(endpoint string) PolicyClient

NewPolicyClient creates an instance of the PolicyClient client.

func (PolicyClient) Get ¶ 

func (client PolicyClient) Get(ctx context.Context) (result PolicyContract, err error)

Get get the Learning settings currently used by the Personalizer service.

func (PolicyClient) GetPreparer ¶ 

func (client PolicyClient) GetPreparer(ctx context.Context) (*http.Request, error)

GetPreparer prepares the Get request.

func (PolicyClient) GetResponder ¶ 

func (client PolicyClient) GetResponder(resp *http.Response) (result PolicyContract, err error)

GetResponder handles the response to the Get request. The method always closes the http.Response Body.

func (PolicyClient) GetSender ¶ 

func (client PolicyClient) GetSender(req *http.Request) (*http.Response, error)

GetSender sends the Get request. The method will close the http.Response Body if it receives an error.

func (PolicyClient) Reset ¶ 

func (client PolicyClient) Reset(ctx context.Context) (result PolicyContract, err error)

Reset resets the Learning settings of the Personalizer service to default.

func (PolicyClient) ResetPreparer ¶ 

func (client PolicyClient) ResetPreparer(ctx context.Context) (*http.Request, error)

ResetPreparer prepares the Reset request.

func (PolicyClient) ResetResponder ¶ 

func (client PolicyClient) ResetResponder(resp *http.Response) (result PolicyContract, err error)

ResetResponder handles the response to the Reset request. The method always closes the http.Response Body.

func (PolicyClient) ResetSender ¶ 

func (client PolicyClient) ResetSender(req *http.Request) (*http.Response, error)

ResetSender sends the Reset request. The method will close the http.Response Body if it receives an error.

func (PolicyClient) Update ¶ 

func (client PolicyClient) Update(ctx context.Context, policy PolicyContract) (result PolicyContract, err error)

Update update the Learning settings that the Personalizer service will use to train models. Parameters: policy - the Learning settings.

func (PolicyClient) UpdatePreparer ¶ 

func (client PolicyClient) UpdatePreparer(ctx context.Context, policy PolicyContract) (*http.Request, error)

UpdatePreparer prepares the Update request.

func (PolicyClient) UpdateResponder ¶ 

func (client PolicyClient) UpdateResponder(resp *http.Response) (result PolicyContract, err error)

UpdateResponder handles the response to the Update request. The method always closes the http.Response Body.

func (PolicyClient) UpdateSender ¶ 

func (client PolicyClient) UpdateSender(req *http.Request) (*http.Response, error)

UpdateSender sends the Update request. The method will close the http.Response Body if it receives an error.

type PolicyContract ¶ 

type PolicyContract struct {
	autorest.Response `json:"-"`
	// Name - Name of the Learning settings.
	Name *string `json:"name,omitempty"`
	// Arguments - Arguments of the Learning settings.
	Arguments *string `json:"arguments,omitempty"`
}

PolicyContract learning settings specifying how to train the model.

type PolicyResult ¶ 

type PolicyResult struct {
	// Name - READ-ONLY
	Name *string `json:"name,omitempty"`
	// Arguments - READ-ONLY
	Arguments *string `json:"arguments,omitempty"`
	// Summary - READ-ONLY
	Summary *[]PolicyResultSummary `json:"summary,omitempty"`
	// TotalSummary - READ-ONLY
	TotalSummary *PolicyResultTotalSummary `json:"totalSummary,omitempty"`
}

PolicyResult ...

func (PolicyResult) MarshalJSON ¶ 

func (pr PolicyResult) MarshalJSON() ([]byte, error)

MarshalJSON is the custom marshaler for PolicyResult.

type PolicyResultSummary ¶ 

type PolicyResultSummary struct {
	// TimeStamp - READ-ONLY
	TimeStamp *date.Time `json:"timeStamp,omitempty"`
	// IpsEstimatorNumerator - READ-ONLY
	IpsEstimatorNumerator *float64 `json:"ipsEstimatorNumerator,omitempty"`
	// IpsEstimatorDenominator - READ-ONLY
	IpsEstimatorDenominator *float64 `json:"ipsEstimatorDenominator,omitempty"`
	// SnipsEstimatorDenominator - READ-ONLY
	SnipsEstimatorDenominator *float64 `json:"snipsEstimatorDenominator,omitempty"`
	// AggregateTimeWindow - READ-ONLY
	AggregateTimeWindow *string  `json:"aggregateTimeWindow,omitempty"`
	NonZeroProbability  *float64 `json:"nonZeroProbability,omitempty"`
	// ConfidenceInterval - READ-ONLY
	ConfidenceInterval *float64 `json:"confidenceInterval,omitempty"`
	// SumOfSquares - READ-ONLY
	SumOfSquares *float64 `json:"sumOfSquares,omitempty"`
}

PolicyResultSummary ...

func (PolicyResultSummary) MarshalJSON ¶ 

func (prs PolicyResultSummary) MarshalJSON() ([]byte, error)

MarshalJSON is the custom marshaler for PolicyResultSummary.

type PolicyResultTotalSummary ¶ 

type PolicyResultTotalSummary struct {
	// TimeStamp - READ-ONLY
	TimeStamp *date.Time `json:"timeStamp,omitempty"`
	// IpsEstimatorNumerator - READ-ONLY
	IpsEstimatorNumerator *float64 `json:"ipsEstimatorNumerator,omitempty"`
	// IpsEstimatorDenominator - READ-ONLY
	IpsEstimatorDenominator *float64 `json:"ipsEstimatorDenominator,omitempty"`
	// SnipsEstimatorDenominator - READ-ONLY
	SnipsEstimatorDenominator *float64 `json:"snipsEstimatorDenominator,omitempty"`
	// AggregateTimeWindow - READ-ONLY
	AggregateTimeWindow *string  `json:"aggregateTimeWindow,omitempty"`
	NonZeroProbability  *float64 `json:"nonZeroProbability,omitempty"`
	// ConfidenceInterval - READ-ONLY
	ConfidenceInterval *float64 `json:"confidenceInterval,omitempty"`
	// SumOfSquares - READ-ONLY
	SumOfSquares *float64 `json:"sumOfSquares,omitempty"`
}

PolicyResultTotalSummary ...

func (PolicyResultTotalSummary) MarshalJSON ¶ 

func (prS PolicyResultTotalSummary) MarshalJSON() ([]byte, error)

MarshalJSON is the custom marshaler for PolicyResultTotalSummary.

type RankRequest ¶ 

type RankRequest struct {
	// ContextFeatures - Features of the context used for Personalizer as a
	// dictionary of dictionaries. This depends on the application, and
	// typically includes features about the current user, their
	// device, profile information, aggregated data about time and date, etc.
	// Features should not include personally identifiable information (PII),
	// unique UserIDs, or precise timestamps.
	ContextFeatures *[]interface{} `json:"contextFeatures,omitempty"`
	// Actions - The set of actions the Personalizer service can pick from.
	// The set should not contain more than 50 actions.
	// The order of the actions does not affect the rank result but the order
	// should match the sequence your application would have used to display them.
	// The first item in the array will be used as Baseline item in Offline evaluations.
	Actions *[]RankableAction `json:"actions,omitempty"`
	// ExcludedActions - The set of action ids to exclude from ranking.
	ExcludedActions *[]string `json:"excludedActions,omitempty"`
	// EventID - Optionally pass an eventId that uniquely identifies this Rank event.
	// If null, the service generates a unique eventId. The eventId will be used for
	// associating this request with its reward, as well as seeding the pseudo-random
	// generator when making a Personalizer call.
	EventID *string `json:"eventId,omitempty"`
	// DeferActivation - Send false if it is certain the rewardActionId in rank results will be shown to the user, therefore
	// Personalizer will expect a Reward call, otherwise it will assign the default
	// Reward to the event. Send true if it is possible the user will not see the
	// action specified in the rank results, because the page is rendering later, or the Rank results may be
	// overridden by code further downstream.
	DeferActivation *bool `json:"deferActivation,omitempty"`
}

RankRequest request a set of actions to be ranked by the Personalizer service.

type RankResponse ¶ 

type RankResponse struct {
	autorest.Response `json:"-"`
	// Ranking - READ-ONLY; The calculated ranking for the current request.
	Ranking *[]RankedAction `json:"ranking,omitempty"`
	// EventID - READ-ONLY; The eventId for the round trip from request to response.
	EventID *string `json:"eventId,omitempty"`
	// RewardActionID - READ-ONLY; The action chosen by the Personalizer service. This is the action your application should display, and for which to report the reward. This might not be the
	// first found in 'ranking' if an action in the request in first position was part of the excluded ids.
	RewardActionID *string `json:"rewardActionId,omitempty"`
}

RankResponse returns which action to use as rewardActionId, and additional information about each action as a result of a Rank request.

func (RankResponse) MarshalJSON ¶ 

func (rr RankResponse) MarshalJSON() ([]byte, error)

MarshalJSON is the custom marshaler for RankResponse.

type RankableAction ¶ 

type RankableAction struct {
	// ID - Id of the action.
	ID *string `json:"id,omitempty"`
	// Features - List of dictionaries containing features.
	Features *[]interface{} `json:"features,omitempty"`
}

RankableAction an action with it's associated features used for ranking.

type RankedAction ¶ 

type RankedAction struct {
	// ID - READ-ONLY; Id of the action
	ID *string `json:"id,omitempty"`
	// Probability - READ-ONLY; Probability of the action
	Probability *float64 `json:"probability,omitempty"`
}

RankedAction a ranked action with its resulting probability.

func (RankedAction) MarshalJSON ¶ 

func (ra RankedAction) MarshalJSON() ([]byte, error)

MarshalJSON is the custom marshaler for RankedAction.

type ReadCloser ¶ 

type ReadCloser struct {
	autorest.Response `json:"-"`
	Value             *io.ReadCloser `json:"value,omitempty"`
}

ReadCloser ...

type RewardRequest ¶ 

type RewardRequest struct {
	// Value - Reward to be assigned to an action. Value should be between -1 and 1 inclusive.
	Value *float64 `json:"value,omitempty"`
}

RewardRequest reward given to a rank response.

type ServiceConfiguration ¶ 

type ServiceConfiguration struct {
	autorest.Response `json:"-"`
	// RewardWaitTime - The time span waited until a request is marked with the default reward.
	// For example, PT5M (5 mins). For information about the time format,
	// see http://en.wikipedia.org/wiki/ISO_8601#Durations
	RewardWaitTime *string `json:"rewardWaitTime,omitempty"`
	// DefaultReward - The reward given if a reward is not received within the specified wait time.
	DefaultReward *float64 `json:"defaultReward,omitempty"`
	// RewardAggregation - The function used to process rewards, if multiple reward scores are received before rewardWaitTime is over.
	RewardAggregation *string `json:"rewardAggregation,omitempty"`
	// ExplorationPercentage - The percentage of rank responses that will use exploration.
	ExplorationPercentage *float64 `json:"explorationPercentage,omitempty"`
	// ModelExportFrequency - Personalizer will start using the most updated trained model for online ranks automatically every specified time period.
	// For example, PT5M (5 mins). For information about the time format,
	// see http://en.wikipedia.org/wiki/ISO_8601#Durations
	ModelExportFrequency *string `json:"modelExportFrequency,omitempty"`
	// LogMirrorEnabled - Flag indicates whether log mirroring is enabled.
	LogMirrorEnabled *bool `json:"logMirrorEnabled,omitempty"`
	// LogMirrorSasURI - Azure storage account container SAS URI for log mirroring.
	LogMirrorSasURI *string `json:"logMirrorSasUri,omitempty"`
	// LogRetentionDays - Number of days historical logs are to be maintained. -1 implies the logs will never be deleted.
	LogRetentionDays *int32 `json:"logRetentionDays,omitempty"`
}

ServiceConfiguration the configuration of the service.

type ServiceConfigurationClient ¶ 

type ServiceConfigurationClient struct {
	BaseClient
}

ServiceConfigurationClient is the personalizer Service is an Azure Cognitive Service that makes it easy to target content and experiences without complex pre-analysis or cleanup of past data. Given a context and featurized content, the Personalizer Service returns which content item to show to users in rewardActionId. As rewards are sent in response to the use of rewardActionId, the reinforcement learning algorithm will improve the model and improve performance of future rank calls.

func NewServiceConfigurationClient ¶ 

func NewServiceConfigurationClient(endpoint string) ServiceConfigurationClient

NewServiceConfigurationClient creates an instance of the ServiceConfigurationClient client.

func (ServiceConfigurationClient) Get ¶ 

func (client ServiceConfigurationClient) Get(ctx context.Context) (result ServiceConfiguration, err error)

Get get the Personalizer service configuration.

func (ServiceConfigurationClient) GetPreparer ¶ 

func (client ServiceConfigurationClient) GetPreparer(ctx context.Context) (*http.Request, error)

GetPreparer prepares the Get request.

func (ServiceConfigurationClient) GetResponder ¶ 

func (client ServiceConfigurationClient) GetResponder(resp *http.Response) (result ServiceConfiguration, err error)

GetResponder handles the response to the Get request. The method always closes the http.Response Body.

func (ServiceConfigurationClient) GetSender ¶ 

func (client ServiceConfigurationClient) GetSender(req *http.Request) (*http.Response, error)

GetSender sends the Get request. The method will close the http.Response Body if it receives an error.

func (ServiceConfigurationClient) Update ¶ 

func (client ServiceConfigurationClient) Update(ctx context.Context, config ServiceConfiguration) (result ServiceConfiguration, err error)

Update update the Personalizer service configuration. Parameters: config - the personalizer service configuration.

func (ServiceConfigurationClient) UpdatePreparer ¶ 

func (client ServiceConfigurationClient) UpdatePreparer(ctx context.Context, config ServiceConfiguration) (*http.Request, error)

UpdatePreparer prepares the Update request.

func (ServiceConfigurationClient) UpdateResponder ¶ 

func (client ServiceConfigurationClient) UpdateResponder(resp *http.Response) (result ServiceConfiguration, err error)

UpdateResponder handles the response to the Update request. The method always closes the http.Response Body.

func (ServiceConfigurationClient) UpdateSender ¶ 

func (client ServiceConfigurationClient) UpdateSender(req *http.Request) (*http.Response, error)

UpdateSender sends the Update request. The method will close the http.Response Body if it receives an error.

Source Files ¶

View all Source files

Directories ¶

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.