Data Retrieval + User Model Management

Retrieving Conversation History

You can list and filter conversations for a user with various parameters:

curl --request GET \\\\
     --url '<https://api.amigo.ai/v1/<your-org-id>/conversation/?user_id=><USER_ID>&limit=10&offset=0' \\\\
     --header 'Authorization: Bearer <AUTH-TOKEN-OF-USER>' \\\\
     --header 'accept: application/json'

Available Filters

• user_id: Retrieve conversations for a specific user

• service_id: Filter by service type

• limit and offset: Control pagination

• created_at_gt/created_at_lt: Filter by creation date range

• is_finished: Filter by conversation state (true/false)

For detailed filter options, refer to the Get Conversations API Reference.

Retrieving Conversation Messages

To fetch the messages from a specific conversation:

curl --request GET \\\\
     --url '<https://api.amigo.ai/v1/<your-org-id>/conversation/><CONVERSATION_ID>/message' \\\\
     --header 'Authorization: Bearer <AUTH-TOKEN-OF-USER>' \\\\
     --header 'accept: application/json'

For message filtering options and details, see the Get Conversation Messages API Reference.

User Model Management

The Amigo platform maintains user models that evolve based on interactions. These models enable personalized experiences across sessions.

Updating User Context Information

To add or update contextual information for a user:

curl --request POST \\\\
     --url <https://api.amigo.ai/v1/<your-org-id>/user/><USER_ID>/user \\\\
     --header 'Authorization: Bearer <AUTH-TOKEN-OF-USER>' \\\\
     --header 'content-type: application/json' \\\\
     --data '
{
  "additional_context": [
    "new content"
  ]
}'

This endpoint allows you to provide:

• New client information

• Contextual data relevant to the user

• Information that should influence future interactions

The provided information will be incorporated into the user's snapshot model, affecting subsequent conversations.

Retrieving User Models

To get the latest user model for a specific user:

curl --request GET \\\\
     --url <https://api.amigo.ai/v1/<your-org-id>/user/><USER_ID>/user_model \\\\
     --header 'accept: application/json' \\\\
     --header 'Authorization: Bearer <AUTH-TOKEN-OF-USER>'

This endpoint returns the current user model containing:

• User properties and preferences

• Interaction history summaries

• System-generated insights about the user

• Any additional context previously provided

Best Practices for Data Management

1. Regular Synchronization: Periodically retrieve and sync user models with your systems

2. Contextual Updates: Update user context when you have new, relevant information

3. Privacy Compliance: Ensure all data operations comply with privacy requirements

4. Intelligent Filtering: Use available filters to retrieve precisely the data you need

5. Efficient Caching: Cache appropriate conversation and user data to reduce API calls