Artificial Intelligence Recommendation:Quickly create projects

Getting started

Install command

You can use pairecmd to quickly create projects. Version 2 supports the PAI-Rec console (recommended).

Version 2

Download links:

Linux version

Mac version

Mac ARM version

Windows version

After downloading, on Unix-like systems you must set the executable file. Command: chmod +x pairecmd

Create a project

Taking the creation of a project named pairec-demo as an example, after executing the command, a pairec-demo directory will be generated in the current directory. The pairec-demo directory contains the project code.

./pairecmdmac project --name pairec-demo

The folder has the following structure:

pairec-demo
├── Makefile
├── conf
│   └── config.json.production
├── docker
│   └── Dockerfile
├── go.mod
└── src
    ├── controller
    │   └── feed.go
    └── main.go

Enter the pairec-demo directory and execute the following command:

go mod tidy

Compile and package the project

The project provides a Makefile file. To compile the project, run the following command:

make && make build

If you encounter errors, you can first execute the following command:

go mod tidy

To package the project into an image, execute the following command:

make release

You can modify the Makefile file according to the actual situation.

Note: You can activate a personal image through an Alibaba Cloud image and then create an image repository specified by BIN_NAME.

Run the project

You can enter the pairec-demo directory and run the following command to start the service. The log will be output to the terminal.

Pass the configuration file path through the config parameter.

go run src/main.go --config=conf/config.json.production --alsologtostderr

You can test with the following API in another terminal:

curl -v http://localhost:8000/api/rec/feed -d '{"uid":"76295990", "size":10, "scene_id":"home_feed"}'

For specific configuration, see Engine configurations.

API testing

In the generated project, a recommendation API has already been implemented. For specific implementation, see controller/feed.go. The API is defined as follows:

API name

/api/rec/feed

Request parameters

When there is a batch of retrieval data that you want to pass through the API, you can assign it to item_list. item_list is an array, and each item is a map object. The item must have an item_id field, which represents the item's ID. The rest are optional. If the item contains a score field, it will be treated as a retrieval score. All other fields will be treated as item properties.

complex_type_features

Complex type context features must be passed as an array. Each element contains the following content:

Example usage:

1. Pass a single value [{"name":"age", "type":"int", "values":20}, {"name":"sex", "values":"male", "type":"string"}]

2. Pass an array [{"name":"list_features", "type":"list<int>", "values":[1,2,3]}]

3. Pass a map [{"name":"map_features", "type":"map<int,int>", "values":{"1":10,"2":20,"3":30}}], or [{"name":"map_features", "type":"map<int,int>", "values":{"1":"10","2":"20","3":"30"}}],

The supported types include int, int64, float, double, string, list<int>, list<int64>, list<float>, list<double>, list<string>, map<int,int>, map<int,int64>, map<int,float>, map<int,double>, map<int,string>, map<string,int>, map<string,int64>, map<string,float>, map<string,double>, map<string,string>, map<int64,int>, map<int64,int64>, map<int64,float>, map<int64,double>, and map<int64,string>.

In the context, complex_type_features and features can be used simultaneously.

API return

The following table describes the items:

Error codes

Request sample

curl -v http://host/api/rec/feed -d '{"uid":"76295990", "size":10, "scene_id":"home_feed"}'

Return data

{
    "code":200,
    "msg":"success",
    "request_id":"e332fe9c-7d99-45a8-a047-bc7ec33d07f6",
    "size":10,
    "experiment_id":"",
    "items":[
          {
            "item_id":"248791390",
            "score":0.9991594902203332,
            "retrieve_id":"mock_recall"
          },
                ...
    ]
}