---
{
  "id": "platform.expert.overview",
  "topic": "expert",
  "title": "Expert Hub discovery and ceiling-protected asks",
  "locale": "en",
  "version": "2026-08-25",
  "summary": "Expert Hub lets an Agent discover published experts and ask one only when the live quoted price is within a caller-supplied hard point ceiling.",
  "content": "`list_experts` browses published Experts, `get_expert` returns one published detail projection and current price information, and `list_models` describes models available to managed Experts. Expert authoring state is a separate creator surface. Expert Actions are private-conversation capabilities; public and restricted conversations fail closed.\n\n`ask_expert` requires `expertId`, a 1–2000 character `question`, and `maxPricePoints`. The server computes the live cost quote before any reserve debit. If `costQuote.grossPoints` is greater than the ceiling, it returns `EXPERT_PRICE_CEILING_EXCEEDED` and spends nothing. The ceiling is required even when a free trial might make the final charge zero, so a later price or trial-state change cannot silently exceed the caller's approved bound. The Action uses no confirmation because the ceiling is the spending authorization, but it uses Strict drift policy.\n\nA published Expert must have a valid positive price and an available owner cost budget. The asking user must have accepted the current Expert disclaimer; Expert owners use creator preview rather than buying from themselves. A non-free ask debits PaidOnly API-credit points and refunds the reserve when provider initialization, streaming, or finalization fails. The managed answer and retrieval embeddings run through LlmGateway. The Action consumes the complete server stream and returns the final answer with its ask ID and retrieval coverage; live typed errors outrank this card.\n",
  "aliases": [
    "Expert Hub",
    "find an expert",
    "paid expert",
    "ask an expert",
    "Expert price",
    "maxPricePoints"
  ],
  "tags": [
    "expert",
    "discovery",
    "pricing",
    "paid-only",
    "safety"
  ],
  "relatedActions": [
    "arinova.expert.list_experts",
    "arinova.expert.get_expert",
    "arinova.expert.list_models",
    "arinova.expert.ask_expert"
  ],
  "relatedActionPrefixes": [
    "arinova.expert."
  ],
  "url": "https://docs.arinova.ai/en/kb/expert/overview/"
}
---

`list_experts` browses published Experts, `get_expert` returns one published detail projection and current price information, and `list_models` describes models available to managed Experts. Expert authoring state is a separate creator surface. Expert Actions are private-conversation capabilities; public and restricted conversations fail closed.

`ask_expert` requires `expertId`, a 1–2000 character `question`, and `maxPricePoints`. The server computes the live cost quote before any reserve debit. If `costQuote.grossPoints` is greater than the ceiling, it returns `EXPERT_PRICE_CEILING_EXCEEDED` and spends nothing. The ceiling is required even when a free trial might make the final charge zero, so a later price or trial-state change cannot silently exceed the caller's approved bound. The Action uses no confirmation because the ceiling is the spending authorization, but it uses Strict drift policy.

A published Expert must have a valid positive price and an available owner cost budget. The asking user must have accepted the current Expert disclaimer; Expert owners use creator preview rather than buying from themselves. A non-free ask debits PaidOnly API-credit points and refunds the reserve when provider initialization, streaming, or finalization fails. The managed answer and retrieval embeddings run through LlmGateway. The Action consumes the complete server stream and returns the final answer with its ask ID and retrieval coverage; live typed errors outrank this card.