Files
marqdo/ext/ai/llm.mq.md

647 lines
26 KiB
Markdown

---
markup: occlusion
title: ext/ai/llm
description: >-
Marqdo LLM intelligence primitive — ask / stream / collect / named handles.
OpenAI-compatible and Ollama HTTP stay behind the semantic surface.
import:
sys: lib/sys.mq.md
json: lib/json.mq.md
table: lib/table.mq.md
fs: lib/fs.mq.md
text: lib/text.mq.md
openai: ext/ai/llm/openai.mq.md
---
Choose the public model resource here for ask, stream and collected response behavior. [The AI entry](index.mq.md) provides an offline event workflow; [the adapter entry](llm/index.mq.md) owns provider configuration and transport shapes. Agents and workbook orchestration belong in agent.mq.md. A created handle is configuration, not proof that authentication or a model request succeeded. Keep transport errors, semantic events and usage counters visible when extending this file.
## load_env
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| path | any | None | Explicit filesystem path; honor the documented filesystem root and operation effects |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Load `.env` from cwd (optional `path=`). Does not override existing variables. |
Use `path`=None as the inputs for this operation.
Load `.env` from cwd (optional `path=`). Does not override existing variables.
Return *[Load dotenv](sys.load_dotenv(path=`path`))*.
## collect
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| events | any | required | Ordered semantic or provider stream-event records |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Collapse a stream event list to final answer text. Accepts semantic events (`delta` / `text` / `done.result` / `error.message`) and native-plugin raw SSE frames (`type=data` with OpenAI chunk JSON in `data`). Alias: `stream_result`. |
Use `events` as the inputs for this operation.
Collapse a stream event list to final answer text.
Accepts semantic events (`delta` / `text` / `done.result` / `error.message`) and
native-plugin raw SSE frames (`type=data` with OpenAI chunk JSON in `data`).
Alias: `stream_result`.
We retain **answer = ""**.
- [ev](遍历 events 为 ev)
We retain **`t` = [Read the type field](json.get(value=`ev`, key="type"))**.
1. `t` == "done"
We retain **`done_r` = [Read the result field](json.get(value=`ev`, key="result"))**.
1. `done_r`
We retain **answer = `done_r`**.
2. *
**_ = 1**
2. `t` == "error"
We retain **`em` = [Read the message field](json.get(value=`ev`, key="message"))**.
1. `em`
We retain **answer = `em`**.
2. *
**_ = 1**
3. `t` == "delta"
4. `t` == "text"
We retain **`chunk` = [Read the text field](json.get(value=`ev`, key="text"))**.
1. `chunk`
We retain **answer = answer + chunk**.
2. *
**_ = 1**
5. `t` == "data"
We retain **`raw` = [Read the data field](json.get(value=`ev`, key="data"))**.
1. `raw`
1. `raw` == "[DONE]"
**_ = 1**
2. *
We retain **`parsed` = [Parse the JSON transport text](json.parse(text=`raw`))**.
1. `parsed`
We retain **`choices` = [Read the choices field](json.get(value=`parsed`, key="choices"))**.
1. `choices`
We retain **`c0` = [Read 1 field](access(`choices`, "1"))**.
We retain **`delta` = [Read the delta field](json.get(value=`c0`, key="delta"))**.
1. `delta`
We retain **`piece` = [Read the content field](json.get(value=`delta`, key="content"))**.
1. `piece`
We retain **answer = answer + piece**.
2. *
**_ = 1**
2. *
We retain **`msg` = [Read the message field](json.get(value=`c0`, key="message"))**.
1. `msg`
We retain **`piece` = [Read the content field](json.get(value=`msg`, key="content"))**.
1. `piece`
We retain **answer = answer + piece**.
2. *
**_ = 1**
2. *
**_ = 1**
2. *
**_ = 1**
2. *
**_ = 1**
2. *
**_ = 1**
6. *
**_ = 1**
1. not `answer`
We retain **answer = ""**.
Return *answer*.
## collect_usage
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| events | any | required | Ordered semantic or provider stream-event records |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Best-effort `total_tokens` from stream frames (requires `stream_options.include_usage`). |
Use `events` as the inputs for this operation.
Best-effort `total_tokens` from stream frames (requires `stream_options.include_usage`).
We retain **tokens = None**.
1. `events`
- [ev](遍历 events 为 ev)
We retain **`t` = [Read the type field](json.get(value=`ev`, key="type"))**.
We retain **raw = None**.
1. `t` == "data"
We retain **`raw` = [Read the data field](json.get(value=`ev`, key="data"))**.
2. *
We retain **`u0` = [Read the usage field](json.get(value=`ev`, key="usage"))**.
1. `u0`
We retain **`tt0` = [Read the total_tokens field](json.get(value=`u0`, key="total_tokens"))**.
1. `tt0` != None
We retain **tokens = `tt0`**.
1. `raw`
1. not `raw` == "[DONE]"
We retain **`parsed` = [Parse the JSON transport text](json.parse(text=`raw`))**.
1. `parsed`
We retain **`u` = [Read the usage field](json.get(value=`parsed`, key="usage"))**.
1. `u`
We retain **`tt` = [Read the total_tokens field](json.get(value=`u`, key="total_tokens"))**.
1. `tt` != None
We retain **tokens = `tt`**.
Return *tokens*.
## stream_result
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| events | any | required | Ordered semantic or provider stream-event records |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Compatibility alias for `collect`. |
Use `events` as the inputs for this operation.
Compatibility alias for `collect`.
Return *[Collect](collect(events=`events`))*.
## usage_from
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| data | any | required | Structured input supplied to this adapter or resource |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Extract `{prompt_tokens,completion_tokens,total_tokens}` from an OpenAI-shaped response map (or empty zeros). |
Use `data` as the inputs for this operation.
Extract `{prompt_tokens,completion_tokens,total_tokens}` from an OpenAI-shaped response map (or empty zeros).
Return *[Usage from](openai.usage_from(data=`data`))*.
## create
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| model | any | None | Model resource or provider model identifier, as required by this operation |
| base_url | any | None | Provider API base URL |
| api_key | any | None | Provider credential from trusted runtime configuration |
| backend | any | "openai-compatible" | Configured execution or provider backend |
| name | any | None | Name registered or looked up by this operation |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Factory for an LLM handle (same as constructing `# llm`). Env fallbacks apply inside the constructor. Optional `name=` tags the handle (`fast` / `reasoning`). |
Use `model`=None, `base_url`=None, `api_key`=None, `backend`="openai-compatible", `name`=None as the inputs for this operation.
Factory for an LLM handle (same as constructing `# llm`). Env fallbacks apply inside the constructor. Optional `name=` tags the handle (`fast` / `reasoning`).
We retain **`h` = [Llm](llm(model=`model`, base_url=`base_url`, api_key=`api_key`, backend=`backend`, name=`name`))**.
Return *h*.
## fast
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| model | any | None | Model resource or provider model identifier, as required by this operation |
| base_url | any | None | Provider API base URL |
| api_key | any | None | Provider credential from trusted runtime configuration |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Named small/fast handle. Model from arg, else `MARQDO_LLM_FAST_MODEL`, else default create model. |
Use `model`=None, `base_url`=None, `api_key`=None as the inputs for this operation.
Named small/fast handle. Model from arg, else `MARQDO_LLM_FAST_MODEL`, else default create model.
1. `model`
We retain **mdl = `model`**.
2. *
We retain **`mdl` = [Env get](sys.env_get(name="MARQDO_LLM_FAST_MODEL"))**.
Return *[Create](create(model=`mdl`, base_url=`base_url`, api_key=`api_key`, name="fast", backend="openai-compatible"))*.
## reasoning
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| model | any | None | Model resource or provider model identifier, as required by this operation |
| base_url | any | None | Provider API base URL |
| api_key | any | None | Provider credential from trusted runtime configuration |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Named strong/reasoning handle. Model from arg, else `MARQDO_LLM_REASONING_MODEL`, else default create model. |
Use `model`=None, `base_url`=None, `api_key`=None as the inputs for this operation.
Named strong/reasoning handle. Model from arg, else `MARQDO_LLM_REASONING_MODEL`, else default create model.
1. `model`
We retain **mdl = `model`**.
2. *
We retain **`mdl` = [Env get](sys.env_get(name="MARQDO_LLM_REASONING_MODEL"))**.
Return *[Create](create(model=`mdl`, base_url=`base_url`, api_key=`api_key`, name="reasoning", backend="openai-compatible"))*.
## prompt_body
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| src | any | required | Prompt source or source-reference value |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | If `src` starts with YAML frontmatter declaring `type: prompt` / `类型: 提示`, return the body after the closing `---`; otherwise return `src` unchanged. |
Use `src` as the inputs for this operation.
If `src` starts with YAML frontmatter declaring `type: prompt` / `类型: 提示`, return the body after the closing `---`; otherwise return `src` unchanged.
We retain **`sw` = [Starts with](text.starts_with(text=`src`, prefix="---"))**.
1. not `sw`
Return *src*.
2. *
We retain **`parts` = [Split](split(value=`src`, sep="\n---\n"))**.
We retain **`n` = [Len](len(value=`parts`))**.
1. `n` < 2
Return *src*.
2. *
We retain **`fm` = [At](at(value=`parts`, index=0))**.
We retain **`is_p` = [Contains](text.contains(text=`fm`, sub="type: prompt"))**.
1. not `is_p`
We retain **`is_p` = [Contains](text.contains(text=`fm`, sub="类型: 提示"))**.
2. *
**_ = 1**
1. `is_p`
We retain **`body` = [At](at(value=`parts`, index=1))**.
Return *[Str trim](text.str_trim(s=`body`))*.
2. *
Return *src*.
## prompt_load
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| path | any | required | Explicit filesystem path; honor the documented filesystem root and operation effects |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Load a prompt artifact (`.mq.md` / `.md`) from disk for `ask`. |
Use `path` as the inputs for this operation.
Load a prompt artifact (`.mq.md` / `.md`) from disk for `ask`.
We retain **`raw` = [Read UTF-8 text from the selected file](fs.read_text(path=`path`))**.
Return *[Prompt body](prompt_body(src=`raw`))*.
## prompt
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| path | any | None | Explicit filesystem path; honor the documented filesystem root and operation effects |
| text | any | None | Text supplied to the transformation or adapter |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Prompt artifact helper: `path=` loads a file; `text=` strips `type: prompt` frontmatter from an in-memory string. |
Use `path`=None, `text`=None as the inputs for this operation.
Prompt artifact helper: `path=` loads a file; `text=` strips `type: prompt` frontmatter from an in-memory string.
1. `path`
Return *[Prompt load](prompt_load(path=`path`))*.
2. `text`
Return *[Prompt body](prompt_body(src=`text`))*.
3. *
We **[Print the prepared message](print(text="ext/ai/llm.prompt: pass", path="or", text=""))**.
We **[End this run with the selected exit status](sys.exit(code=1))**.
## ask
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| prompt | any | None | Prompt text or structured prompt expected by this adapter |
| path | any | None | Explicit filesystem path; honor the documented filesystem root and operation effects |
| model | any | None | Model resource or provider model identifier, as required by this operation |
| base_url | any | None | Provider API base URL |
| api_key | any | None | Provider credential from trusted runtime configuration |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Module convenience: create a default handle and return **answer text**. Pass `path=` to load a prompt document, `prompt=` text, or omit both to use the entry `.mq.md` as a prompt artifact (`type: prompt` body via `sys.module_source`). |
Use `prompt`=None, `path`=None, `model`=None, `base_url`=None, `api_key`=None as the inputs for this operation.
Module convenience: create a default handle and return **answer text**. Pass `path=` to load a prompt document, `prompt=` text, or omit both to use the entry `.mq.md` as a prompt artifact (`type: prompt` body via `sys.module_source`).
We retain **p = `prompt`**.
1. `path`
We retain **`p` = [Prompt load](prompt_load(path=`path`))**.
2. `prompt`
We retain **p = `prompt`**.
3. *
We retain **`raw` = [Module source](sys.module_source())**.
1. not `raw`
We **[Print the prepared message](print(text="ext/ai/llm.ask: pass", prompt="or", path="(or run a prompt document as entry)"))**.
We **[End this run with the selected exit status](sys.exit(code=1))**.
2. *
We retain **`p` = [Prompt body](prompt_body(src=`raw`))**.
We retain **`m` = [Create](create(model=`model`, base_url=`base_url`, api_key=`api_key`))**.
We retain **`r` = [Ask](m.ask(prompt=`p`))**.
We retain **`_ret` = [Read the text field](json.get(value=`r`, key="text"))**.
Return *_ret*.
# llm
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| model | any | None | Model resource or provider model identifier, as required by this operation |
| base_url | any | None | Provider API base URL |
| api_key | any | None | Provider credential from trusted runtime configuration |
| backend | any | "openai-compatible" | Configured execution or provider backend |
| name | any | None | Name registered or looked up by this operation |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | LLM handle — intelligence primitive, not an HTTP client. Resolution: explicit args → entry-scope / Artifact Metadata (`sys.meta_get`) → `sys.env_get` → defaults. Prefer declaring `model` / `api_key` / `base_url` in frontmatter Binding, then use the lifted names. |
Use `model`=None, `base_url`=None, `api_key`=None, `backend`="openai-compatible", `name`=None as the inputs for this operation.
LLM handle — intelligence primitive, not an HTTP client.
Resolution: explicit args → entry-scope / Artifact Metadata (`sys.meta_get`) → `sys.env_get` → defaults.
Prefer declaring `model` / `api_key` / `base_url` in frontmatter Binding, then use the lifted names.
1. `api_key`
We retain **key = `api_key`**.
2. *
We retain **`key` = [Meta get](sys.meta_get(key="api_key"))**.
1. not `key`
We retain **`key` = [Env get](sys.env_get(name="OPENAI_API_KEY"))**.
1. not `key`
We retain **`key` = [Env get](sys.env_get(name="MARQDO_LLM_API_KEY"))**.
2. *
**_ = 1**
2. *
**_ = 1**
1. `backend` == ollama
1. not `key`
We retain **key = "ollama"**.
2. *
**_ = 1**
2. not `key`
We **[Print the prepared message](print(text="ext/ai/llm: set OPENAI_API_KEY or MARQDO_LLM_API_KEY (or pass api_key= / metadata api_key)"))**.
We **[End this run with the selected exit status](sys.exit(code=1))**.
3. *
**_ = 1**
1. `base_url`
We retain **url = `base_url`**.
2. *
We retain **`url` = [Meta get](sys.meta_get(key="base_url"))**.
1. `url`
**_ = 1**
2. `backend` == ollama
We retain **`url` = [Env get](sys.env_get(name="OLLAMA_HOST"))**.
1. not `url`
We retain **url = "http://127.0.0.1:11434/v1"**.
2. *
**_ = 1**
3. *
We retain **`url` = [Env get](sys.env_get(name="OPENAI_BASE_URL"))**.
1. not `url`
We retain **`url` = [Env get](sys.env_get(name="MARQDO_LLM_BASE_URL"))**.
2. *
**_ = 1**
1. not `url`
We retain **url = "https://api.openai.com/v1"**.
2. *
**_ = 1**
1. `model`
We retain **mdl = `model`**.
2. *
We retain **`mdl` = [Meta get](sys.meta_get(key="model"))**.
1. `mdl`
**_ = 1**
2. *
We retain **`mdl` = [Env get](sys.env_get(name="OPENAI_MODEL"))**.
1. not `mdl`
We retain **`mdl` = [Env get](sys.env_get(name="MARQDO_LLM_MODEL"))**.
2. *
**_ = 1**
1. not `mdl`
1. `backend` == ollama
We retain **mdl = "llama3.2"**.
2. *
We retain **mdl = "gpt-4o-mini"**.
2. *
**_ = 1**
1. `name`
We retain **nm = `name`**.
2. *
We retain **nm = None**.
`h` =
| _type | backend | api_key | base_url | model | suffix | bearer | name |
|-------|---------|---------|----------|-------|--------|--------|------|
| llm | `backend` | `key` | `url` | `mdl` | /chat/completions | "Bearer " | `nm` |
Return *h*.
## ask
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| prompt | any | None | Prompt text or structured prompt expected by this adapter |
| path | any | None | Explicit filesystem path; honor the documented filesystem root and operation effects |
| messages | any | None | Ordered chat message records |
| selection | any | None | Explicit runtime/model selection |
| strict_selection | any | False | Whether an unresolved selection is an error |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Semantic ask → **LLMResult** (`text`, `model`, `finish`, `backend`, `usage`, `name`, `tool_calls`). Prefer `[text](result)` for the answer string. Omit `prompt=` / `path=` to use the entry document (`sys.module_source` + `prompt_body`). Pass `messages=` for multi-turn history (M01). `selection=` + `strict_selection=True` freeze request identity without env fallback. |
Use `prompt`=None, `path`=None, `messages`=None, `selection`=None, `strict_selection`=False as the inputs for this operation.
Semantic ask → **LLMResult** (`text`, `model`, `finish`, `backend`, `usage`, `name`, `tool_calls`). Prefer `[text](result)` for the answer string. Omit `prompt=` / `path=` to use the entry document (`sys.module_source` + `prompt_body`). Pass `messages=` for multi-turn history (M01). `selection=` + `strict_selection=True` freeze request identity without env fallback.
We retain **p = `prompt`**.
1. `messages`
We retain **p = None**.
2. `path`
We retain **`p` = [Prompt load](prompt_load(path=`path`))**.
3. `prompt`
We retain **p = `prompt`**.
4. *
We retain **`raw` = [Module source](sys.module_source())**.
1. not `raw`
We retain **p = ""**.
2. *
We retain **`p` = [Prompt body](prompt_body(src=`raw`))**.
We retain **`pack` = [Complete result](self.complete_result(prompt=`p`, messages=`messages`, selection=`selection`, strict_selection=`strict_selection`, stream=False, echo=False))**.
We retain **`text` = [Read the text field](json.get(value=`pack`, key="text"))**.
We retain **`usage` = [Read the usage field](json.get(value=`pack`, key="usage"))**.
We retain **`finish` = [Read the finish field](json.get(value=`pack`, key="finish"))**.
We retain **`err` = [Read the error field](json.get(value=`pack`, key="error"))**.
We retain **`tc` = [Read the tool_calls field](json.get(value=`pack`, key="tool_calls"))**.
1. not `tc`
We retain **`tc` = [Empty list](table.empty_list())**.
2. *
**_ = 1**
1. not `text`
We retain **text = ""**.
2. *
**_ = 1**
1. not `finish`
1. `err`
We retain **finish = "error"**.
2. *
We retain **finish = "stop"**.
2. *
**_ = 1**
Hoist receiver fields before the result table — table cells can shadow `self` /
column names (`model`, `usage`), so `[model](self)` / `[total_tokens](usage)`
inside the table is unsafe.
We retain **`mdl` = [Read the model field](json.get(value=`self`, key="model"))**.
We retain **`b` = [Read the backend field](json.get(value=`self`, key="backend"))**.
We retain **`nm` = [Read the name field](json.get(value=`self`, key="name"))**.
1. `usage`
We retain **`tt` = [Read the total_tokens field](json.get(value=`usage`, key="total_tokens"))**.
We retain **`ustate` = [Read the usage_state field](json.get(value=`usage`, key="usage_state"))**.
2. *
We retain **tt = None**.
We retain **ustate = "unknown"**.
1. `ustate` == "unknown"
Keep null — never coerce missing usage to zero tokens (M02 / F04).
We retain **tt = None**.
2. not `tt`
We retain **tt = None**.
3. *
**_ = 1**
1. `err`
We retain **calls = 0**.
2. *
We retain **calls = 1**.
`result` =
| text | model | finish | backend | usage | name | llm_calls | tokens | tool_calls | error | selection |
|------|-------|--------|---------|-------|------|-----------|--------|------------|-------|-----------|
| `text` | `mdl` | `finish` | `b` | `usage` | `nm` | `calls` | `tt` | `tc` | `err` | `selection` |
Return *result*.
## stream
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| prompt | any | None | Prompt text or structured prompt expected by this adapter |
| path | any | None | Explicit filesystem path; honor the documented filesystem root and operation effects |
| echo | any | False | Whether to print the documented incremental output |
| stream_kind | any | "delta" | Streaming event projection selected by the caller |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Semantic stream: return the event list (use `llm.collect` to reduce to text). Omit `prompt=` / `path=` to use the entry document. |
Use `prompt`=None, `path`=None, `echo`=False, `stream_kind`="delta" as the inputs for this operation.
Semantic stream: return the event list (use `llm.collect` to reduce to text). Omit `prompt=` / `path=` to use the entry document.
`stream_kind=plan` tags EventBus frames for the parent plan protocol (process trail).
1. `path`
We retain **`p` = [Prompt load](prompt_load(path=`path`))**.
2. `prompt`
We retain **p = `prompt`**.
3. *
We retain **`raw` = [Module source](sys.module_source())**.
1. not `raw`
We retain **p = ""**.
2. *
We retain **`p` = [Prompt body](prompt_body(src=`raw`))**.
Return *[Complete](self.complete(prompt=`p`, stream=True, echo=`echo`, stream_kind=`stream_kind`))*.
## complete_result
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| prompt | any | None | Prompt text or structured prompt expected by this adapter |
| messages | any | None | Ordered chat message records |
| selection | any | None | Explicit runtime/model selection |
| strict_selection | any | False | Whether an unresolved selection is an error |
| stream | any | False | Whether to preserve streaming behavior or emit stream events |
| echo | any | False | Whether to print the documented incremental output |
| stream_kind | any | "delta" | Streaming event projection selected by the caller |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Transport pack via `ext/ai/llm/openai` (Ollama uses the same OpenAI-compatible path). Non-stream → `{text,usage,finish}`; stream → `{events}`. Prefer `messages=` for multi-turn; optional `selection=` (ModelSelectionV1) with `strict_selection=True` for request-scoped identity (M01). |
Use `prompt`=None, `messages`=None, `selection`=None, `strict_selection`=False, `stream`=False, `echo`=False, `stream_kind`="delta" as the inputs for this operation.
Transport pack via `ext/ai/llm/openai` (Ollama uses the same OpenAI-compatible path). Non-stream → `{text,usage,finish}`; stream → `{events}`. Prefer `messages=` for multi-turn; optional `selection=` (ModelSelectionV1) with `strict_selection=True` for request-scoped identity (M01).
Return *[Chat completions](openai.chat_completions(base_url=[base_url](access(`self`, "base_url")), api_key=[api_key](access(`self`, "api_key")), model=[model](access(`self`, "model")), prompt=`prompt`, messages=`messages`, selection=`selection`, strict_selection=`strict_selection`, stream=`stream`, echo=`echo`, stream_kind=`stream_kind`, suffix=[suffix](access(`self`, "suffix")), bearer=[bearer](access(`self`, "bearer"))))*.
## complete
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| prompt | any | required | Prompt text or structured prompt expected by this adapter |
| stream | any | False | Whether to preserve streaming behavior or emit stream events |
| echo | any | False | Whether to print the documented incremental output |
| stream_kind | any | "delta" | Streaming event projection selected by the caller |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Internal / compatibility primitive. Prefer `ask` / `stream` in new code. |
Use `prompt`, `stream`=False, `echo`=False, `stream_kind`="delta" as the inputs for this operation.
Internal / compatibility primitive. Prefer `ask` / `stream` in new code.
1. `stream`
We retain **`pack` = [Complete result](self.complete_result(prompt=`prompt`, stream=True, echo=`echo`, stream_kind=`stream_kind`))**.
We retain **`_ret` = [Read the events field](json.get(value=`pack`, key="events"))**.
Return *_ret*.
2. *
We retain **`pack` = [Complete result](self.complete_result(prompt=`prompt`, stream=False, echo=`echo`, stream_kind=`stream_kind`))**.
We retain **`_ret` = [Read the text field](json.get(value=`pack`, key="text"))**.
Return *_ret*.
## chat
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| prompt | any | required | Prompt text or structured prompt expected by this adapter |
| stream | any | False | Whether to preserve streaming behavior or emit stream events |
| echo | any | False | Whether to print the documented incremental output |
| stream_kind | any | "delta" | Streaming event projection selected by the caller |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | Alias for `complete` (compat). |
Use `prompt`, `stream`=False, `echo`=False, `stream_kind`="delta" as the inputs for this operation.
Alias for `complete` (compat).
Return *[Complete](self.complete(prompt=`prompt`, stream=`stream`, echo=`echo`, stream_kind=`stream_kind`))*.