智能助手OS Copilot使用说明

支持的操作系统

产品优势

• 智能

  OS Copilot通过不断学习您的使用习惯，提高准确性并作出预测。

• 专业

  OS Copilot可以专业地帮助您回答操作系统相关问题。

• 高效

  OS Copilot可以帮助您在系统诊断、调优、编程等场景进行相关问题处理。

• 协作

  通过OS Copilot管理您在阿里云上的资源，享受到阿里云上一体化的服务。

功能介绍

• 命令行自然语言问答

  通过命令行自然语言问答，OS Copilot能够使用户在操作系统的命令行中直接输入自然语言表述的问题，从而提供与日常使用及操作系统领域相关的专业解答，提高用户的操作效率和整体体验。

• 辅助命令执行

  Linux操作系统主要通过命令行进行日常使用和维护等操作。OS Copilot提供了辅助命令执行功能，帮助Linux的新手用户迅速掌握基本的使用技能。

• 阿里云CLI调用

  阿里云CLI（Command Line Interface）是基于阿里云开放API建立的管理工具。借助此工具，您可以通过调用阿里云开放API来管理阿里云产品。OS Copilot支持用户在操作系统内便捷地调用阿里云CLI，能够通过命令行简单地查询ECS信息。

• 系统运维和调优

  在操作系统使用中的重要场景是系统的运维和调优，操作系统的表现对于业务有着非常大的影响。OS Copilot可以通过自然语言调用相关系统运维及调优工具（特别是阿里云自研的系统工具），帮助用户轻松使用系统工具定位系统问题，提升系统性能。

前提条件

如果您使用RAM用户，请确保阿里云账号（主账号）已将系统策略AliyunSysOMOSCopilotAccess授予RAM用户。具体操作，请参见为RAM用户授权。

安装OS Copilot

1. 远程连接已创建的实例。

   具体操作，请参见使用Workbench工具以SSH协议登录Linux实例。

2. 安装最新版OS Copilot。

   Alibaba Cloud Linux

   确认系统是否安装OS Copilot。

   rpm -q os-copilot

   • 如果未安装，则运行如下命令安装OS Copilot。

     sudo yum install -y os-copilot

   • 如果已安装，则运行如下命令升级到最新版本。

     sudo yum update os-copilot

   Ubuntu/Anolis OS/CentOS

   重要

   操作以下命令仅使用root用户。

   • x86_64

     curl -#S https://mirrors.aliyun.com/os-copilot/os-copilot-all-in-one-latest.sh | bash

   • aarch64

     curl -#S https://mirrors.aliyun.com/os-copilot/os-copilot-all-in-one-arm-latest.sh | bash

3. 运行如下命令，配置环境变量。

   export ALIBABA_CLOUD_ACCESS_KEY_ID=<AccessKey ID>
   export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<AccessKey Secret>

   说明

   请将<AccessKey ID>和<AccessKey Secret>替换为您实际的AccessKey ID和AccessKey Secret。

   • 查询AccessKey ID的具体操作，请参见查看RAM用户的AccessKey信息。

   • AccessKey Secret只在创建时显示，不支持查询。更多信息，请参见创建AccessKey。

升级/卸载OS Copilot

sudo yum remove -y os-copilot

sudo rm -f /bin/co /bin/copilot /etc/profile.d/os-copilot_fix_command_tool_config.sh

使用OS Copilot

单命令模式

单命令模式是指copilot或者co命令后面直接跟问题描述，命令执行完成即退出，如下图所示。

单命令模式支持的参数

# co --help
usage: co [-h] [-v] [-t] [-f FILE] [--notool] [prompt]

OS Copilot: An OS assistant using LLM technique

positional arguments:
  prompt                input the prompt (i.e., your query about Linux OS), or keep it empty to enter interactive mode

optional arguments:
  -h, --help            show this help message and exit
  -v, -V, --version     show version info and exit
  -t, -T, --tool        activate this option to let llm use tools on demand
  -f FILE, --file FILE  prompt from a file
  --notool              activate this option to get raw llm response without tools, note that --notool will not take effect if --tool is set as well

• 重点参数说明

  参数	参数说明	示例
  -t	指定进入agent模式，使得OS Copilot自动调用注册工具完成任务；否则，将由大模型判断是否使用agent模式。	co 当前系统健康度 -t
  -f	从文件中读取复杂任务进行处理。	co -f task -t。详见视频操作使用文件定义复杂的任务。
  |	使用管道	cat /etc/sysctl.conf | co 解释下这些参数的含义

• 重点工具及功能说明

  OS Copilot已集成软件管理、命令检查与执行、Keentune性能优化、文件读写以及阿里云 (Aliyun) CLI等插件工具，将通过以下示例进行说明。

  • 知识问答

    

  • 简单命令/脚本生成与执行

    

  • 软件管理

    

  • 多步骤任务执行

    

  • keentune性能优化

    能够自动安装keentuned和keentune-target，启动keentune服务，并通过调用keentune命令设置与MySQL相关的profile。

    说明

    目前keentune插件只支持在Alibaba Cloud Linux 3上使用。

    

  • 文件读写

    说明

    分析的日志不要超过100行，容易超出最长token限制。

    

  • 阿里云 (Aliyun) CLI

    1. 安装aliyun-cli软件。

       说明

       本文以Alibaba Cloud Linux 3系统安装阿里云CLI为例，其他系统若需要安装阿里云CLI，具体操作，请参见在Linux上安装阿里云CLI。

       sudo dnf install aliyun-cli -y

    2. 使用AK/SK配置aliyun权限。

       aliyun configure

       如下图所示，配置相关信息。

       

    3. 使用Copilot调用aliyun示例如下。

       #co 查看下xxxxxxxxxxxx这个阿里云账号有哪些资源？ -t
       
       [Copilot]:
       我需要使用阿里云CLI API来查询该账号下的资源。
       aliyun ecs DescribeInstances --RegionId cn-hangzhou --PageSize 10 --PageNumber 1
       {
       	"Instances": {
       		"Instance": [
       			{
       				"AutoReleaseTime": "",
       				"ClusterId": "",
       				"Cpu": 8,
       				"CpuOptions": {
                       ......

问号指令

问号指令是指在用户遇到命令执行错误的情况下，可以通过输入?或why命令来唤醒OS Copilot，以对错误进行解释并尝试修复，从而提供正确的命令。

# growpart 3 /dev/vda
FAILED: 3: does not exist

# ?

[Copilot]:
用户提供的命令growpart 3 /dev/vda存在错误，需要使用命令修正工具API来分析并提供正确的命令。

[Copilot]:
看来命令修正工具没有能够直接给出答案。根据我的经验，growpart命令用于调整分区大小，正确的语法应该是growpart 设备名 分区号。所以，用户提供的命令中的参数顺序是错误的。

[Copilot]:
您提供的命令 growpart 3 /dev/vda 中的参数顺序不正确。正确的命令应该是 growpart /dev/vda 3。这会将 /dev/vda 设备上的第 3 个分区扩展到最大可用空间。如果您遇到任何问题或需要进一步的帮助，请告诉我。

交互模式

• 执行copilot或co命令进入交互模式，默认进入Chat模式。可执行多轮交互。

• 执行exit、quit指令或ctrl + d、ctrl + c快捷键退出交互模式。

返回参数解释如下：

• CHAT：默认的聊天模式，可以使用newchat命令切换到此模式，重复执行newchat可切换到新一轮对话。

• CODEGEN：按照指示自动生成代码，可以使用newcodegen命令切换到此模式，重复执行newcodegen可切换到新一轮对话。

• CODESUM：读取本地代码片段文件，自动分析代码摘要，可以使用newcodesum命令切换到此模式，重复执行newcodesum可切换到新一轮的对话。

  说明

  在代码摘要模式下，请先输入目标编程语言，再输入代码文件路径，例如python#demo.py。

  

实操体验

为了更好地了解和使用OS Copilot，OS Copilot提供了包括问题咨询、辅助运维、编程学习等功能的实验场景供您体验，帮助您高效解决系统问题、提升编程效率。实验地址：【实践】使用操作系统智能助手OS Copilot解锁操作系统运维与编程。

产品视频

技术支持

如果在使用OS Copilot的过程中，有任何疑问和建议，您可以通过以下方式反馈并获取技术支持，以获得更优质的服务和更好的产品体验。

• 钉钉群（推荐）：加入技术支持钉钉群：71050008820，联系技术支持获取帮助。

• 提交工单：您也可以通过提交工单获得更多的免费支持。

• 文档反馈：如果发现产品文档的问题，如链接、内容和API错误等，您可以在文档页右侧的悬浮菜单中单击反馈或直接选中存在问题的内容单击文档反馈。

• 为了进一步了解您对OS Copilot的使用诉求，我们诚挚邀请您参与问卷调研：填写问卷。