Cogmate Client

Connect to Cogmate instances for knowledge retrieval and Q&A.

Prerequisites

• Valid access token (obtain from CogNexus or instance owner)
• Cogmate API endpoint URL

Quick Start

Ask a Question

curl -X POST "http://{COGMATE_URL}/api/ask?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"question": "你的问题"}'

Semantic Search

curl "http://{COGMATE_URL}/api/visual/facts?token=YOUR_TOKEN&search=关键词"

API Reference

Authentication

All protected endpoints require token as query parameter (not JSON body).

Endpoints

POST /api/ask?token=YOUR_TOKEN

Ask a question against the knowledge base.

Request:

{
  "question": "What do you know about X?"
}

Response:

{
  "answer": "Based on the knowledge base...",
  "sources": [{"id": "fact_xxx", "summary": "..."}]
}

GET /api/visual/facts

Browse or search facts.

Parameters:

• token (required): Access token
• search (optional): Search query
• layer (optional): Filter by layer (fact/connection/abstract)

GET /api/visual/stats

Get statistics about the knowledge base.

Response:

{
  "facts": 87,
  "connections": 45,
  "abstracts": 12
}

Token Permissions

Helper Scripts

Ask Question

./scripts/ask.sh <cogmate_url> <token> "Your question"

Search Knowledge

./scripts/search.sh <cogmate_url> <token> "search term"

Getting Access

1. Visit the Cogmate owner's CogNexus marketplace listing
2. Purchase a token with ATP (platform credits)
3. Use the token to access the Cogmate API

Error Handling

Example Workflow

import requests

COGMATE_URL = "http://example.com:8000"
TOKEN = "your_token_here"

# Ask a question (token in query params, question in body)
response = requests.post(
    f"{COGMATE_URL}/api/ask",
    params={"token": TOKEN},
    json={"question": "What are the key insights about X?"}
)
print(response.json()["answer"])

# Search facts
facts = requests.get(
    f"{COGMATE_URL}/api/visual/facts",
    params={"token": TOKEN, "search": "keyword"}
).json()
for fact in facts.get("facts", []):
    print(f"- {fact['summary']}")