Exposes the DXP AI service as a package for consumers
npm install @squiz/dxp-ai-clientThe @squiz/dxp-ai-client is auto generated client library designed to simplify the interactions with the dxp-ai-service
- Abstract away the complexity of HTTP requests and API interactions, allowing other services to interact with the dxp-ai-service service with less effort.
- Provide a consistent and intuitive API interface, enabling developers to integrate with the dxp-ai-service service efficiently and not waste time updating their own integration services.
To utilize the Main Service Client Library within your service, follow these steps:
1. Installation: Install the client library package in your service's environment using your preferred package manager (e.g. npm , pnpm or yarn).
``bash`
npm install @squiz/dxp-ai-client
1. Initialize Client: Initialize an instance of the dxp-ai-service client within your service's codebase, providing any required configuration parameters. The following example is from the DXP console
`ts`
export class AiService extends BaseService {
public readonly apiClient: DxpAiService
public constructor(configuration: AiServiceConfiguration) {
super(configuration);
const baseUrl = this.getServiceUrlByTenant('ai');
if (!baseUrl) {
throw new Error('BaseUrl is undefined');
}
const httpClient = createClient({
baseUrl: baseUrl,
});
this.apiClient = new DxpAiService(httpClient);
}
}
1. Interact with Main Service: Once initialized, you can start making requests to the dxp-ai-service service using the methods exposed by the client library. These methods abstract away the underlying HTTP requests and provide a simple interface for interacting with the dxp-ai-service service's endpoints.
`ts`
aiService.apiClient.generative.list(query)
.then((user) => {
// Handle ai data
})
.catch((error) => {
// Handle error
});
2. Contribute and Extend: If your service requires changes to the package generation settings or extension in its interaction with the dxp-ai-service` service (requiring changes to the service code). Please see the Contribution guidelines