# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Thehiveryiq Com Kimi API
  version: 1.0.0
extends: openapi/thehiveryiq-com-kimi-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/v1/kimi/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the Kimi model integration status
      effect: read
      questions:
      - Is the Kimi K2.6 integration configured and how much has it spent?
      - What was the status of the last Kimi call?
      instructions:
      - text: Check Kimi health and cumulative spend.
      - text: Show whether Kimi is configured and its last call status.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/kimi/wisdom'].post
  update:
    x-apievangelist-phrasing:
      intent: Get Kimi wisdom recommendations for a brand
      effect: read
      questions:
      - Can Kimi suggest recommendations tailored to my brand and vertical?
      - What does the wisdom panel return if no model key is set?
      instructions:
      - text: Get Kimi wisdom recommendations for tenant {tenant_id}, brand {brand_name}.
        slots:
          tenant_id: requestBody.tenant_id
          brand_name: requestBody.brand_name
      - text: Ask the wisdom panel about "{query}" for {brand_name} (tenant {tenant_id}) in the {vertical} vertical.
        slots:
          query: requestBody.query
          brand_name: requestBody.brand_name
          tenant_id: requestBody.tenant_id
          vertical: requestBody.vertical
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/kimi/orchestrate'].post
  update:
    x-apievangelist-phrasing:
      intent: Plan a multi-agent workflow toward a goal
      effect: read
      questions:
      - Can Kimi turn a goal and a list of tools into a step-by-step plan with tool calls?
      - How do I cap the number of steps in an orchestration plan?
      instructions:
      - text: Plan the steps to achieve "{goal}" with Kimi orchestration.
        slots:
          goal: requestBody.goal
      - text: Orchestrate "{goal}" using tools {tools} in at most {max_steps} steps.
        slots:
          goal: requestBody.goal
          tools: requestBody.tools
          max_steps: requestBody.max_steps
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/kimi/long-horizon'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a long-horizon deep reasoning task
      effect: read
      questions:
      - Which endpoint handles deep reasoning tasks spanning hundreds of steps?
      - Will I get the reasoning trace back along with the final result?
      instructions:
      - text: Run a long-horizon reasoning task toward "{objective}".
        slots:
          objective: requestBody.objective
      - text: Deep-think about "{objective}" given {context}, up to {max_tokens} tokens.
        slots:
          objective: requestBody.objective
          context: requestBody.context
          max_tokens: requestBody.max_tokens
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/kimi/code'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate code, smoke tests or ship reports
      effect: read
      questions:
      - Can Kimi write smoke tests or integration glue code for me?
      - Can I pick the programming language for generated code?
      instructions:
      - text: Generate code for task "{task}".
        slots:
          task: requestBody.task
      - text: Write {language} code for "{task}" with context {context}.
        slots:
          language: requestBody.language
          task: requestBody.task
          context: requestBody.context
      method: generated
      generated: '2026-09-26'