Coze Studio (Coze Open Source Edition): uma plataforma de código baixo de código aberto para criar rapidamente inteligências de IA

Coze O Studio é a plataforma de desenvolvimento de inteligência de IA de código aberto da ByteDance, baseada na licença Apache 2.0, que permite o uso comercial gratuito. Ela fornece ferramentas visuais para dar suporte à rápida construção, depuração e implantação de inteligências e aplicativos de IA sem código ou com pouco código. O back-end é desenvolvido usando Golang, e o front-end é baseado no Reagir e TypeScript, seguindo o design orientado por domínio (DDD) e a arquitetura de microsserviços para garantir alto desempenho e escalabilidade. Os usuários podem criar fluxos de trabalho complexos arrastando e soltando nós, integrar plug-ins, bases de conhecimento e bancos de dados e implementar rapidamente a lógica de negócios. A plataforma oferece suporte a APIs e SDKs multilíngues para facilitar a integração com sistemas locais, e o Coze Studio reduz o limite para o desenvolvimento de IA e incentiva as contribuições da comunidade, tornando-o adequado para desenvolvedores e empresas criarem aplicativos de IA personalizados.

Lista de funções

• Organização visual do fluxo de trabalhoCrie rapidamente fluxos de trabalho complexos arrastando e soltando nós para dar suporte ao design da lógica comercial e ao processamento do fluxo de dados.
• Gerenciamento de plug-insCrie, configure e gerencie plug-ins que ofereçam suporte ao encapsulamento de APIs de terceiros ou de funcionalidades privadas.
• Gerenciamento da base de conhecimentoCarregar documentos ou dados e as inteligências geram respostas precisas com base na base de conhecimento.
• Suporte a banco de dadosIntegração de recursos de banco de dados: integre recursos de banco de dados para dar suporte ao armazenamento e à consulta de dados e aprimorar as funções inteligentes do corpo.
• Modelo de gerenciamento de serviçosSuporte à integração de OpenAI, Volcano Engine e outros serviços de modelo, seleção flexível de modelos grandes.
• Integração de API e SDKAPIs relacionadas a bate-papo e fluxo de trabalho: forneça APIs relacionadas a bate-papo e fluxo de trabalho, suporte a Python, JavaScript, Java e outros SDKs, para facilitar o desenvolvimento secundário.
• Corpo inteligente e construção de aplicativosInteligência de IA: crie, publique e gerencie rapidamente inteligências ou aplicativos de IA com suporte para implementações em várias plataformas.
• interação em tempo realSuporte para bate-papo em tempo real, síntese e transcrição de voz via WebSocket.
• Suporte à comunidade de código abertoBaseado na licença Apache 2.0, as contribuições da comunidade com código e feedback são incentivadas.

Usando a Ajuda

Instalação e implementação

O Coze Studio é um projeto de código aberto, você precisa clonar o código do repositório do GitHub e implantá-lo localmente. Aqui estão as etapas detalhadas:

1. Preparação ambiental::
   • Requisitos de hardwareCPU mínima de 2 núcleos, 4 GB de RAM.
   • dependência de software::
     • Docker e Docker ComposeVerifique se o serviço Docker está instalado e iniciado.
     • GolangO desenvolvimento do back-end requer a versão 1.18 ou superior, configure as variáveis de ambiente.
     • Node.jsA versão LTS é recomendada para o desenvolvimento de front-end.
     • pnpmInstale o pnpm globalmente (versão recomendada 9.12.0):

       npm i -g pnpm@9.12.0
       

2. armazém de clones::
   Execute o seguinte comando para obter o código-fonte:

   git clone https://github.com/coze-dev/coze-studio.git
   cd coze-studio
   

3. Serviço de modelo de configuração::
   • Copie o modelo de perfil do modelo (por exemplo, motor de vulcão doubao-seed-1.6):

     cp backend/conf/model/template/model_template_ark_doubao-seed-1.6.yaml backend/conf/model/ark_doubao-seed-1.6.yaml
     

   • compilador backend/conf/model/ark_doubao-seed-1.6.yamlConfigure os seguintes campos:
     • idIDs de modelo personalizados, que precisam ser inteiros diferentes de zero, globalmente exclusivos e não modificáveis após a implantação.
     • meta.conn_config.api_keyChave da API do serviço de modelo, por exemplo, chave da API do Volcano Engine Ark (para saber como obtê-la, consulte https://www.volcengine.com/docs/82379/1541594).
     • meta.conn_config.modelID do ponto de extremidade do serviço de modelo, por exemplo, ID do ponto de extremidade para doubao-seed-1.6 (consulte o https://www.volcengine.com/docs/82379/1099522).
4. Instalação de dependências::
   Instale as dependências do front-end:

   pnpm install
   

   As dependências de back-end são gerenciadas automaticamente pela Golang, executando o comando go build Faz o download automaticamente ao mesmo tempo.

5. Construir e executar::
   • Construir projeto:

     pnpm build
     go build
     

   • Serviços de implantação:

     cd docker
     cp .env.example .env
     docker compose --profile '*' up -d
     

     A primeira implementação requer a extração da imagem, o que pode levar muito tempo. Após a inicialização bem-sucedida, o registro mostra Container coze-server StartedA seguir, um exemplo do tipo de trabalho que pode ser realizado pelo http://localhost:3000 Acesso.

6. Configuração de variáveis de ambiente::
   estabelecer .env adicione a chave de API e o URL de base:

   COZE_API_TOKEN=your_api_token
   COZE_API_BASE=https://api.coze.com
   

   entrevistas https://www.coze.com/open/oauth/pats ganho COZE_API_TOKEN.

Uso de funções essenciais

1. criação de inteligências de IA

• Acesso ao espaço de trabalho: Faça login no Coze Studio e visite https://www.coze.com/space/<workspace_id>/developRegistros workspace_id.
• Novo corpo inteligenteClique em "New Intelligence" (Nova inteligência) na interface e selecione um modelo (por exemplo, doubao-seed-1.6). Arraste e solte para adicionar nós de função, como diálogo, base de conhecimento ou plug-in.
• Configuração da base de conhecimentoFaça upload de um documento (por exemplo, PDF ou TXT) para a Base de Conhecimento e as inteligências poderão responder a perguntas com base no documento. Por exemplo, ao fazer upload de um manual de produto, um corpo inteligente pode responder a perguntas relacionadas.
• Liberação de corpos inteligentesQuando a configuração estiver concluída, clique em "Publish" (Publicar) e selecione a plataforma de destino (por exemplo, Discord). Digite COZE_BOT_TOKEN A implantação está concluída e o acesso está disponível em https://www.coze.com/docs.

2. organização do fluxo de trabalho

• Abra o editorSelecione "Workflow" (Fluxo de trabalho) no Coze Studio para acessar a tela de visualização.
• Criação de fluxos de trabalhoNó: arraste e solte nós (por exemplo, "Input", "API Call", "Output") da biblioteca de nós e defina a lógica conectando-os. Por exemplo, conecte "entrada do usuário" a "consultar banco de dados" para "gerar resposta".
• Depuração e otimizaçãoClique em "Debug" para inserir dados de teste, verificar o status de execução dos nós e otimizar o fluxo lógico.
• Fluxos de trabalho de publicaçãoQuando a depuração estiver concluída, clique em "Publicar" para vincular o fluxo de trabalho ao smartbody ou ao aplicativo.

3. desenvolvimento e integração de plug-ins

• Criação de plug-insAPI de terceiros: No módulo Plugins, adicione uma API de terceiros (por exemplo, consulta meteorológica). Insira o URL e os parâmetros da API, salve-a e use-a em seu fluxo de trabalho.
• Chamada de plug-insAdicionar nós de plug-in ao fluxo de trabalho para configurar parâmetros. Por exemplo, o plug-in de clima retorna dados meteorológicos em tempo real.
• desenvolvimento localExemplo de Python:

  from cozepy import Coze, TokenAuth
  coze = Coze(auth=TokenAuth(os.getenv("COZE_API_TOKEN")))
  bot = coze.bots.create(space_id="your_workspace_id", name="TestBot")
  print(f"Created bot: {bot.name}")
  

4. interação em tempo real

• Suporte a WebSocketPermite o bate-papo em tempo real ou a interação por voz:

  WebsocketChatClient client = coze.websocket().chat().create(new WebsocketChatCreateReq(botID, new CallbackHandler()));
  client.inputAudioBufferAppend("base64_audio_data");
  

• processamento de respostasSaída de texto ou áudio em tempo real por meio de funções de retorno de chamada.

5. banco de dados e gerenciamento de recursos

• Configuração do banco de dadosNo módulo Recursos, adicione uma conexão de banco de dados (por exemplo, MySQL). Uma vez configurado, o fluxo de trabalho pode consultar os dados diretamente.
• Gerenciamento de recursosSuporte ao gerenciamento de plug-ins, bases de conhecimento, variáveis e outros recursos, unificados na operação da interface visual.

triagem de problemas

• Ver registroExecute o seguinte comando para verificar o status e os registros do contêiner:

  docker ps
  docker logs <container_id>
  

• problemas comunsSe o serviço não for iniciado, verifique o .env está correta, ou verifique se a conexão de rede do Docker está funcionando.

Contribuições da comunidade

• consulta CONTRIBUTING.md Enviar código. Os problemas de segurança são tratados por meio do https://security.bytedance.com/src ou por e-mail sec@bytedance.com Informe, não divulgue no GitHub.

cenário do aplicativo

1. Atendimento ao cliente on-line
   Crie um atendimento inteligente ao cliente, uma base de conhecimento integrada para responder a perguntas comuns e perguntas complexas no manual para aumentar a eficiência.
2. Processamento automatizado de dados
   Use fluxos de trabalho para processar dados de formulários e chamar APIs para gerar relatórios. Por exemplo, colete automaticamente o feedback do cliente e gere análises.
3. Assistente de Educação
   Crie inteligências para responder às perguntas dos alunos com base no conhecimento do livro didático e ofereça suporte à orientação de aprendizado personalizado.
4. Controle de casa inteligente
   Desenvolvimento de inteligências para controlar dispositivos de IoT por meio de APIs, por exemplo, comandos de voz para "ligar o ar-condicionado" acionam a operação do dispositivo.

QA

1. Coze Studio Open Source Edition vs. Commercial Edition?
   A versão de código aberto oferece suporte aos principais recursos de desenvolvimento e é gratuita para uso comercial, mas não inclui recursos avançados, como a personalização de tons. A versão comercial requer uma assinatura, consulte https://www.coze.com/docs/guides/subscription.
2. Como faço para obter uma chave de API?
   entrevistas https://www.coze.com/open/oauth/patspara gerar um token de acesso pessoal, salve-o no arquivo .env Documentação.
3. Quais são os modelos suportados?
   Suporte a OpenAI, Volcano Engine e outros modelos, é necessário configurar manualmente o serviço de modelo, consulte https://github.com/coze-dev/coze-studio/wiki/3.-Model-configuration.
4. Ele é adequado para usuários sem experiência em programação?
   Os usuários sem código podem criar inteligências por meio de uma interface visual, e os usuários de programação podem personalizar os recursos usando o SDK.
5. Como faço para participar da comunidade?
   Digitalize o código QR oficial com o Flying Book (consulte README.md) Participe do grupo de intercâmbio técnico do Coze Studio.