Skip to content

Ask Ishvana

POST
/api/creative/ishvana/chat

Ask Ishvana a freeform question — she’ll use her tools to answer.

Ishvana can search lore, read documents, detect entities, and delegate to Hawken (writing), Lagan (research), or GameMaster (mechanics).

AgentChatRequest

Request body for freeform agent chat across core conversational agents.

object
message
required
Message

User’s freeform message to the agent

string
conversationHistory
Conversationhistory

Prior conversation turns. Capped at 50 so the prompt stays bounded — older turns are dropped by the caller.

Array<object>
<= 50 items
AgentChatTurn

A single turn in a freeform agent conversation history.

object
role
required
Role

Message role (user or assistant)

string
Allowed values: user assistant
content
required
Content

Message content

string
context
Any of:
AgentChatContext

Ambient author context attached to a freeform agent request.

object
activeUrl
Any of:
string
pageTitle
Any of:
string
pageContentExcerpt
Any of:
string
activeDocumentTitle
Any of:
string
activeDocumentExcerpt
Any of:
string

Successful Response

AgentChatResponse

Response from agent freeform chat interaction.

object
response
required
Response

Agent’s response text

string
toolsUsed
Any of:
Array<string>
toolCalls
Any of:
Array<object>
AgentToolCallSummary

A single tool invocation Lagan made during a freeform chat turn.

Richer than a bare tool name — the UI can show arguments (so the author sees what Lagan searched for) and, when the agent reports it, a short preview of the result the tool returned.

object
id
required
Id

Provider-assigned tool call id

string
name
required
Name

Tool name the agent invoked

string
arguments
Any of:
object
key
additional properties
any
argumentsRaw
Any of:
string
resultPreview
Any of:
string
durationMs
Any of:
integer

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object