# AI APIs
 #### ai_generate(prompt, on, as_col, model_name, model_parameters=None)
描述： 使用大语言模型生成文本，并将生成结果作为新列添加到Dataset中。model_name需已注册。
输入参数：
- prompt (str)：文本生成的提示词模板。输入列的内容将被追加到此提示词后。
- on (ir.Column)：包含待处理输入数据的Dataset列。
- as_col (str)：存储生成文本的新列名称。
- model_name (str)：用于文本生成的大语言模型名称。
- model_parameters (Optional\[str\])：大语言模型的额外参数，以JSON格式字符串提供。默认为None。
返回值类型： 包含新生成列的Dataset。
示例：
```
>>> from aura_frame.multimodal import ai_lake
>>> con = ai_lake.connect(
...     aura_endpoint='*',
...     access_key='*',
...     secret_key='*'
...     ...
... )
>>> ds = con.load_dataset("demo_table_text", database='my_schema')
>>> ds
| id | text_content          |
| -- | --------------------- |
| int| string                |
| -- | --------------------- |
| 1  | You're a good man.   |
| 2  | You're a bad man.     |
# 使用带模型参数的AI生成
>>> ds.ai_generate(
...     prompt="Is this a positive review? Just reply with 'Yes' or 'No'.",
...     on=ds.text_content,
...     as_col="judgement",
...     model_name="gpt-4",
...     model_parameters='{"temperature": 0.7, "max_tokens": 100}'
... )
| id | text_content          | judgement        |
| -- | --------------------- | --------------- |
| int| string                | string          |
| -- | --------------------- | --------------- |
| 1  | You're a good man.    | Yes             |
| 2  | You're a bad man.     | No              |
```
 #### create_model(model_name, base_url, api_key, remote_model_name, description=None, database=None)
描述：创建一个抽象本地模型，用于绑定到远程LLM服务。
输入参数：
- model_name (str)：抽象本地模型的名称。
- base_url (str)：远程LLM服务的基础URL。
- api_key (str)：连接远程LLM服务所需的API密钥。
- remote_model_name (str)：远程LLM服务的模型名称。
- description (Optional\[str\])：可选参数，抽象本地模型的描述信息。
- database (Optional\[str\]) ：可选参数，模型所属的数据库名称。
返回值类型：无
 #### list_models(database=None)
描述：查看指定数据库或默认数据库中的所有模型。
输入参数：
database (Optional\[str\]) ：要查看的模型所在的数据库名称。如果为None，则使用默认数据库。
返回值类型：list\[tuple\] ，为包含模型名称元组的列表。
 #### drop_model(model_name)
描述：删除与模型名称对应的抽象本地模型。
输入参数：
model_name (str) ：抽象本地模型的名称。
返回值类型：无
 #### describe_model(model_name, database=None)
描述：查看指定的模型的详细信息。
输入参数：
- model_name (str) ：要查看的模型名称。
- database (Optional\[str\]) ：预留参数，模型所在的数据库名称，默认为None。
返回值类型：查看的模型的详细信息。