Copy page

AI & MCP · New

Domain GenAI

Domain GenAI allows you to ask questions and receive synthesized answers derived from IntelCenter intelligence data.

Unlike search endpoints, which return lists of matching records, Domain GenAI produces a focused response based on analysis of transcripts, visual content, summaries, and metadata.

---

Endpoints

• POST /v1/icd/domain-genai
• POST /v1/icdb/domain-genai

---

When to Use Domain GenAI

Use Domain GenAI when:

• You want a direct answer, not a list of results
• You are asking analytical or investigative questions
• You want to synthesize information across multiple records
• You are exploring a topic where relationships and context matter

---

Example Request

Code
curl --request POST \
  --url https://api.intelcenter.com/v1/icd/domain-genai \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "question": "What recent activity has been reported involving Houthis [Ansar Allah]?",
    "entity": "Houthis [Ansar Allah]",
    "top_k": 10
  }'

---

Request Parameters

Parameter	Required	Description
question	Yes	The question to be answered
entity	No	Restrict analysis to a specific entity
primary_country	No	Filter by country
top_k	No	Number of relevant records to consider (controls breadth of analysis)
conversation_id	No	Optional identifier for multi-turn interactions

---

How It Works

Domain GenAI:

1. Retrieves relevant records from the dataset
2. Analyzes:
   • Transcripts
   • Visual analysis
   • Audio analysis
   • Summaries
   • Metadata
3. Synthesizes a response based on the retrieved context

This allows it to provide answers that go beyond simple keyword matching.

---

Response Behavior

• Responses are generated, not static
• Results may vary slightly between requests
• Answers reflect the available underlying data

---

Example Use Cases

• Summarizing recent activity related to an entity
• Identifying trends or patterns
• Answering investigative or analytical questions
• Generating concise intelligence summaries

---

Rate Limits

Domain GenAI endpoints are more resource-intensive and have stricter limits:

• Requests per minute
• Requests per hour
• Requests per day

If limits are exceeded, the API will return:

Code
{
  "error": "quota_exceeded",
  "message": "This API key exceeded a usage or rate limit and the request was blocked."
}

---

Best Practices

• Use specific questions for better results
• Apply entity or primary_country filters when possible
• Use Natural Language Search first if exploring broadly
• Avoid unnecessary repeated calls
• Cache results when appropriate

---

Limitations

• Responses depend on available data and may not be complete
• Outputs are generated and may vary
• Not all questions will produce definitive answers

---

Recommended Workflow

1. Use Natural Language Search to explore a topic
2. Identify relevant records or entities
3. Use Domain GenAI for deeper analysis or synthesis

---

Tip

Use Domain GenAI for answers, not discovery.
Use search endpoints when you need structured results or precise filtering.