开始使用

安全组规则修改（可选）

安全组实际是网络流量访问策略，包括网络流量入方向规则和出方向规则，通过这些规则为安全组内具有相同保护需求并且相互信任的云服务器、云容器、云数据库等实例提供安全保护。

如果您的实例关联的安全组策略无法满足使用需求，比如需要添加、修改、删除某个TCP端口，请参考以下内容进行修改。

• 添加安全组规则：根据业务使用需求需要开放某个TCP端口，请参考添加安全组规则添加入方向规则，打开指定的TCP端口。
• 修改安全组规则：安全组规则设置不当会造成严重的安全隐患。您可以参考修改安全组规则，来修改安全组中不合理的规则，保证云服务器等实例的网络安全。
• 删除安全组规则：当安全组规则入方向、出方向源地址/目的地址有变化时，或者不需要开放某个端口时，您可以参考删除安全组规则进行安全组规则删除。

opencode使用配置

opencode部署完成后支持两种使用方式：1.Web网页使用；2.命令行使用。下面分别演示两种使用方式的使用配置：

Web网页使用配置：

1. 在部署完成后的输出页查看并访问opencode网址，登录时用户名默认为opencode，密码为用户在部署资源时设置的opencode_webe_password密码。
   图1 opencode登录网址
   
   图2 opencode网页登录界面
   

2. 了解使用opencode的相关内容。1、根据需求配置通用设置，这里以打开显示智能体为例；2、了解快捷键，方便快捷使用 ；3、根据需求进行服务器信息修改。
   图3 通用设置页
   
   图4 显示两种智能体选择
   
   图5 快捷键总览页
   
   图6 服务器信息修改页
   

3. 获取模型API Key。登录MaaS平台，在左侧导航栏，单击“API Key管理”（最多可创建30个密钥。每个密钥仅在创建时显示一次，请确保妥善保存。如果密钥丢失，无法找回，需要重新创建API Key以获取新的访问密钥）。如已有apikey或仅使用opencode免费模型请下拉到步骤5继续模型配置。
   图7 API Key管理
   

4. 在“API Key管理”页面，单击右上角“创建API Key”，填写标签（自定义API Key的标签，标签具有唯一性，不可重复。仅支持大小写英文字母、数字、下划线、中划线，长度范围为1~100个字符）和描述（自定义API Key的描述，长度范围为1~100个字符）信息后，单击“确定”。标签和描述信息在创建完成后，不支持修改。
   图8 创建API Key
   

5. opencode内置免费模型，同时也支持用户自主添加模型。
   图9 免费模型
   
   图10 用户自主添加模型
   
   图11 用户可选提供商
   

6. 自主添加模型详细演示，这里以通过华为云MaaS模型API Key添加自定义openAI兼容提供商模型为例。单击箭头所指位置开始配置模型。
   图12 自定义openAI兼容提供商入口
   

7. 按照提示依次填写相关信息，API base URL、API key的填写详见说明。其中提供商ID和显示名称的填写仅用于用户区分添加的模型，不影响添加模型的使用，可以根据需求填写。model-id填写请正确填写模型官方id，显示名称字段填写无强制要求。单击model-id字段下的添加模型可一次性添加多个API key支持的模型。
   图13 自定义提供商信息填写页
   
   图14 续自定义提供商信息填写页
   
   

   模型配置华为云MaaS为样例：API base URL固定填写："https://api.modelarts-maas.com/v1”,API key填写：参考步骤3创建apikey或使用已有apikey；

   选择模型需要注意：模型已经开通，查询地址：华为云MaaS平台模型列表

8. 在填写好相关信息后单击提交完成模型配置。
   图15 提交模型配置
   

9. 在模型栏目查看已添加的模型。
   图16 已添加模型列表
   

10. 单击添加项目，打开projects文件，新建对话验证已添加模型，到此模型配置完毕。
    图17 新建项目
    
    图18 对话模型选择
    
    图19 对话验证
    

命令行使用配置：

1. 在RFS资源栏单击opencode-ecs进入控制台，单击远程登录，选择CloudShell登录，填写ecs_password完成登录。
   图20 跳转ecs
   
   图21 CloudShell登录（默认使用22端口）
   
   图22 填写ecs_password
   

2. 在ecs中一次运行以下代码完成模型配置。其中baseURL，apikey，model_id需要替换为实际值。
   图23 配置代码
   

3. 在进行完以上操作后，在命令行输入opencode，进入对话界面，在对话框中输入/model回车，选中添加的模型就可以开始使用添加的模型了，到此模型配置结束。
   图24 选择模型
   
   图25 对话验证
   

opencode基础使用指南

Web网页使用：

1. 单击图25所示位置打开文件，选择projects文件夹。
   图26 打开文件
   
   图27 文件夹选择
   

2. 单击新建对话，选择对话模式和模型开始使用。其中Plan模式是任务规划模式，在此模式下opencode对用户的指令不会直接执行，只会列出计划；Build模式下用户指令会直接执行。
   图28 新建对话
   
   图29 选择对话模式
   
   图30 选择模型
   
   图31 使用示例
   

3. 单击箭头所示位置打开对话侧边栏查看对话信息。关于对话相关功能，需要注意归档功能单击后对话会在web页面消失，但是仍然在存储中存在。如果要在web页面恢复对话则需要使用shell指令。
   图32 对话侧边栏
   
   图33 对话相关功能
   
   图34 归档文档恢复指令
   

命令行使用：

1. 使用CloudShell登录ecs，输入opencode进入使用界面。如果需要退出
   图35 ecs使用界面
   

2. Ctrl+P打开opencode命令查看，根据需求选择命令。
   图36 查看命令
   

3. 单击tab键切换opencode运行模式，选择需要的模式开启使用。
   图37 Plan模式
   
   图38 Build模式