OAK: projeto de código aberto para a criação visual de aplicativos corporais inteligentes

Introdução geral

O OAK (Open Agent Kit) é uma ferramenta de código aberto que ajuda os desenvolvedores a criar, personalizar e implantar rapidamente inteligências de IA. Ele pode se conectar a qualquer Modelo de Linguagem Grande (LLM), como os da OpenAI, Google ou Anthropic, e também suporta a adição de funcionalidades por meio de plug-ins. O OAK foi projetado com um objetivo claro em mente: facilitar a integração da IA. Ele oferece uma estrutura modular, APIs intuitivas e componentes de interface fáceis de usar que permitem que os desenvolvedores passem rapidamente da ideia ao ambiente de produção. Não importa se você está criando um assistente inteligente ou desenvolvendo serviços de atendimento ao cliente com tecnologia de IA, o OAK oferece flexibilidade e escalabilidade. O site é orientado pela comunidade de desenvolvedores, o código é público e os usuários podem modificá-lo livremente, o que o torna adequado para projetos de todos os tamanhos.

Lista de funções

• Oferece suporte a conexões LLM arbitrárias: compatível com OpenAI, Google, Anthropic e outros modelos; também oferece suporte a modelos auto-hospedados.
• Extensões de plug-in: adicionam funcionalidade por meio de plug-ins, como processamento de dados ou pesquisa em tempo real.
• Design modular: fornece componentes ajustáveis para facilitar a personalização das funções de IA.
• Execução com um clique: inicie rapidamente aplicativos nativos com comandos sem configurações complexas.
• Componente de interface: interface de bate-papo integrada que pode ser incorporada em um site ou aplicativo.
• Código aberto e transparente: o código está disponível publicamente no GitHub e pode ser modificado ou receber contribuições dos usuários.
• Suporte a banco de dados: configuração opcional no PostgreSQL, armazenamento de dados mais conveniente.
• Orientado pela comunidade: obtenha suporte ou compartilhe experiências pelo Discord.

Usando a Ajuda

O OAK é simples e direto, e é adequado tanto para uma inicialização rápida quanto para um suporte de desenvolvimento aprofundado. Veja a seguir instruções detalhadas de instalação e uso.

Processo básico de instalação

Se você quiser executar o OAK diretamente sem alterar o código ou desenvolver plug-ins, siga as etapas abaixo:

1. iniciar um aplicativo
   Abra um terminal e digite o comando:

npx @open-agent-kit/cli run docker

Isso fará o download automático e iniciará o OAK.

2. modelo de configuração
   A linha de comando solicitará a seleção de um modelo (por exemplo, GPT-4o da OpenAI) e a inserção da chave de API. Preencha a chave conforme solicitado, por exemploOPENAI_API_KEY=你的密钥e, em seguida, digite.
3. Acesso a aplicativos
   Após o lançamento bem-sucedido, abra seu navegador e digite:

http://localhost:3000

Você verá a tela de bate-papo do OAK.

4. execução de teste
   Digite "What day of the week is today" na interface; se a resposta correta for retornada, a instalação foi bem-sucedida.

Processo de instalação avançado

Se você quiser alterar o modelo padrão, adicionar plug-ins ou desenvolver novos recursos, siga as etapas abaixo:

Criar um projeto

1. Gerar projeto
   Digite-o no terminal:

npx @open-agent-kit/cli create project

Isso criará uma pasta de projeto com uma configuração padrão.

2. Acesso ao catálogo
   importaçãocd 项目名Entre no catálogo de projetos.

Configuração do banco de dados (opcional)

1. Executando o PostgreSQL
   Inicie o banco de dados com o Docker e digite:

docker run --name oak-db 
-e POSTGRES_USER=你的用户名 
-e POSTGRES_PASSWORD=你的密码 
-e POSTGRES_DB=oak 
-p 5432:5432 -d pgvector/pgvector:pg17

intercambialidade你的用户名responder cantando你的密码.

2. Configuração de conexões
   Copie o arquivo.env.examplepor causa de.envedite o arquivo e preencha as informações do banco de dados, por exemplo:

DATABASE_URL=postgresql://你的用户名:你的密码@localhost:5432/oak?schema=public

Ambiente de configuração

1. Obter chave de API

• OpenAI: AcessoSite oficial da OpenAI, crie a chave.
• Google: referênciaDocumentação sobre Gêmeos.
• Antrópico: VisãoDocumentação antrópica.
• XAI: VejaDocumento XAI.

2. Gerar a chave do aplicativo
   entrevistashttps://api.open-agent-kit.com/generate-secret.htmlGerarAPP_SECRETPor exemplo:

APP_SECRET=生成的32位密钥

3. Definição de variáveis de ambiente
   existir.envPreencha a chave e outras configurações, por exemplo:

APP_URL=http://localhost:5173
OPENAI_API_KEY=你的密钥
APP_SECRET=你的应用密钥

desenvolvimento local

1. Instalação de dependências
   Entrada:

npm install

2. migração operacional
   Se um banco de dados for usado, execute:

npm run generate
npm run migrate:deploy

3. iniciar um aplicativo
   Entrada:

npm run dev

entrevistashttp://localhost:5173, entre na interface de administração.

Funções principais

Conectando o LLM

• Clique em "Settings" (Configurações) na interface e selecione um modelo (por exemplo, Google Gemini).
• Digite a chave da API e salve.
• Faça o teste digitando uma pergunta na caixa de bate-papo, por exemplo, "How many times does 1+1 equal?" (Quantas vezes 1+1 é igual a 1).

Adição de plug-ins

• Na pasta do projeto dopluginsadicione o código do plug-in (consulteArquivo (de computador)).
• estar em movimentonpm run buildEmbalagem.
• Reinicie o aplicativo e o plug-in entrará em vigor automaticamente.

Personalização da interface

• Na interface de administração, ajuste as cores e as fontes.
• fazer uma cópia de<iframe>Código para incorporar em seu site.

Operação da função em destaque

Desenvolvimento modular

• O design modular do OAK permite que você ajuste os recursos individualmente, como a alteração da lógica do chat.
• Localizar no códigosrc/modulesmodificado conforme necessário.

Implementação na nuvem

• Implementação com o Vercel: no terminal, digitevercel deploySiga as instruções.
• Acesse a URL retornada após a implantação.

Essas etapas tornam o OAK claro e operável desde a instalação até o uso. Para obter mais detalhes, consultedocumento oficial.

cenário do aplicativo

1. assistente inteligente
   Os usuários podem criar assistentes pessoais com o OAK para responder a perguntas ou lidar com tarefas quando conectados ao LLM.
2. atendimento ao cliente
   As empresas incorporam o OAK em seus sites para automatizar as respostas a consultas comuns e aumentar a eficiência.
3. Suporte educacional
   Os professores usam o OAK para criar ferramentas de resposta a perguntas em que os alunos inserem perguntas e o sistema retorna as respostas.
4. análise de dados
   Desenvolvedor e plugin de dados para analisar dados comerciais e gerar relatórios.

QA

1. Quais modelos são compatíveis com o OAK?
   Oferece suporte aos principais LLMs, como OpenAI, Google, Anthropic, etc., e também a modelos criados pelo próprio usuário.
2. Precisa saber sobre programação?
   O uso básico não é necessário, basta configurar a interface. A base JavaScript é necessária para desenvolver plug-ins ou alterar o código.
3. Há algum custo para executá-lo localmente?
   Totalmente gratuito, apenas implementações na nuvem ou chamadas de API podem ser cobradas.
4. Como atualizar o OAK?
   Basta obter o código mais recente do GitHub e executar novamente o comando de instalação.