AI Assistant API

This documentation guides you on how to integrate the Coalesce Catalog AI Assistant into your agent by calling it through the public API.

Summary

You can use it with:

an MCP server
as part of your agent's tools

Resources

Prerequisites

You need a Coalesce Catalog API Token. If you do not have one, reach out to the Catalog ops team to request a new token.

Introduction

Coalesce Catalog public API is a GraphQL API
To interact with the AI Assistant, you need to implement a polling system using the two queries below:
- addAiAssistantJob: Creates an asynchronous AI Assistant job and returns a jobId.
- getAiAssistantJobResult: Uses the jobId to poll for the job result.

Details

addAiAssistantJob

Input

Headers
```
{"Authorization": "Token <API_TOKEN>"}
```

Body

query {
  addAiAssistantJob (
    data: {
      question: "<user_question>"
      email: "<user_email>"
      externalConversationId: "<unique_conversation_id>"
    }
  ){
    data {
      jobId
    }
  }
}

Output

{
  "data": {
    "addAiAssistantJob": {
      "data": {
        "jobId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      }
    }
  }
}

getAiAssistantJobResult

Input

Headers
```
{"Authorization": "Token <API_TOKEN>"}
```

Body

query {
  getAiAssistantJobResult (
    data: {
      id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      delaySeconds: 5
    }
  ){
    data {
      status
      answer
      assets {
        id
        internalLink
        name
        url
      }
    }
  }
}

Output

{
  "data": {
    "getAiAssistantJobResult": {
      "data": {
        "status": "completed",
        "answer": "<AI_Assistant_answer>",
        "assets": [
          {
            "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "internalLink": "https://castordoc.com",
            "name": "",
            "url": "https://example.com"
          }
        ]
      }
    }
  }
}

First, call addAiAssistantJob to receive the jobId. Then, use that jobId to poll for the result with getAiAssistantJobResult, which includes a built-in polling delay controlled by the delaySeconds parameter.

Summary​

Resources​

Prerequisites​

Introduction​

Details​

addAiAssistantJob​

getAiAssistantJobResult​