mirror of
https://github.com/trustgraph-ai/trustgraph.git
synced 2026-07-14 07:42:11 +02:00
40f01c123b
Adds a full-stack image description service: schema, base class,
OpenAI backend, gateway dispatch, client APIs (sync/async REST +
websocket), tg-describe-image CLI, IAM capability, and specs.
Closes #879
60 lines
1.9 KiB
YAML
60 lines
1.9 KiB
YAML
type: object
|
|
description: |
|
|
WebSocket request message envelope.
|
|
|
|
Wraps service-specific request payloads with routing and correlation metadata.
|
|
required:
|
|
- id
|
|
- service
|
|
- request
|
|
properties:
|
|
id:
|
|
type: string
|
|
description: |
|
|
Client-generated unique identifier for this request within the WebSocket session.
|
|
Used to correlate responses with requests in multiplexed async communication.
|
|
Can be any string, but must be unique per active request.
|
|
examples:
|
|
- req-123
|
|
- request-abc-456
|
|
- b5f8d9a2-4c3e-11ef-9c8a-0242ac120002
|
|
service:
|
|
type: string
|
|
description: |
|
|
Service identifier. Same as {kind} in REST API URLs.
|
|
|
|
Global services: iam
|
|
Workspace-scoped services: config, flow, librarian, knowledge, collection-management
|
|
Flow-scoped services: agent, text-completion, image-to-text, prompt,
|
|
document-rag, graph-rag, embeddings, graph-embeddings, document-embeddings,
|
|
triples, objects, nlp-query, structured-query, structured-diag, text-load,
|
|
document-load, mcp-tool
|
|
examples:
|
|
- config
|
|
- agent
|
|
- document-rag
|
|
flow:
|
|
type: string
|
|
description: |
|
|
Flow ID for flow-scoped services. Required for services accessed via
|
|
/api/v1/flow/{flow}/service/{kind} in REST API.
|
|
|
|
Omit for global services (iam) and workspace-scoped services
|
|
(config, flow, librarian, knowledge, collection-management).
|
|
Workspace context is resolved from the authenticated token.
|
|
examples:
|
|
- my-flow
|
|
- production-flow
|
|
request:
|
|
type: object
|
|
description: |
|
|
Service-specific request payload. Structure is identical to the request body
|
|
in the corresponding REST API endpoint.
|
|
|
|
See OpenAPI specification for detailed schemas per service.
|
|
examples:
|
|
- operation: list
|
|
type: flow
|
|
- question: What is quantum computing?
|
|
streaming: true
|
|
system-prompt: You are a helpful assistant
|