Motia: uma estrutura de desenvolvimento para a criação rápida de inteligências em código

Introdução geral

O Motia é uma estrutura de agente de IA de código aberto para engenheiros de software, hospedada no GitHub e desenvolvida pela equipe do MotiaDev. Ele permite que os desenvolvedores escrevam, testem e implantem rapidamente agentes inteligentes em linguagens de programação conhecidas (por exemplo, Python, TypeScript, Ruby). O Motia é "code-first" e "event-driven" em sua essência, permitindo que os desenvolvedores criem sistemas de automação prontos para produção sem precisar aprender uma nova sintaxe ou configurações complexas. Ele também oferece o Motia Workbench, uma ferramenta de visualização baseada em navegador para ver os agentes em ação em tempo real. A partir de março de 2025, as versões mais recentes são v0.1.0-beta.8com feedback positivo da comunidade, é adequado para equipes que precisam desenvolver tarefas complexas com eficiência.

Lista de funções

• Desenvolvimento com código em primeiro lugar: escreva a lógica do agente diretamente em Python, TypeScript, Ruby e outras linguagens.
• Suporte a vários idiomas: você pode combinar diferentes idiomas no mesmo agente, por exemplo, Python para processamento de dados e TypeScript para verificação de tipos.
• Arquitetura orientada a eventos: aciona tarefas por meio de eventos, adequada para cenários de resposta em tempo real.
• Visualização em tempo real: o Motia Workbench exibe o fluxo e os registros de execução do agente.
• Etapas modulares: o agente consiste em etapas reutilizáveis que dão suporte à validação de entrada e saída.
• Implantação com um clique: implante agentes com um único comando, sem necessidade de experiência em administração de servidores.
• API e Webhook: gere automaticamente pontos de extremidade HTTP para chamadas externas.
• Ferramentas de depuração integradas: registros em tempo real e gráficos de execução para ajudar a solucionar problemas.
• Integração flexível de IA: suporta qualquer modelo grande ou banco de dados vetorial sem limitações.

Usando a Ajuda

O uso do Motia é dividido em três etapas principais: instalação, desenvolvimento e implantação. Abaixo está um guia detalhado para ajudar os usuários a começar rapidamente.

Processo de instalação

1. Preparação do ambiente
   Requer o Node.js (versão recomendada 16 ou superior) e o pnpm. Verifique se ele está instalado:

node -v
pnpm -v

Se você não o tiver, visite o site oficial do Node.js para fazer o download e instalá-lo e, em seguida, executá-lo:

npm install -g pnpm

2. Criar um projeto
   Inicialize o projeto com a CLI do Motia:

npx motia create -n my-first-agent

Isso gera um my-first-agent com etapas e dependências de amostra.

3. Entre no catálogo e inicie
   Em execução:

cd my-first-agent
pnpm run dev

Após a inicialização, o navegador é aberto http://localhost:3000Se quiser ver o Motia Workbench, você pode fazer isso por padrão. default Processo.

Como usar os principais recursos

O núcleo do Motia é escrever a lógica do agente e a depuração em tempo real. Veja como ele funciona.

Escrevendo lógica de proxy

1. etapa de definição
   existir steps Crie uma pasta no diretório reply.js::

export default async function handler({ input }) {
return { reply: `你好，${input.name}！有什么我可以帮你的吗？` };
}

2. Processo de criação
   existir flows Crie uma pasta no diretório support.js::

   export default {
   name: "support",
   steps: ["reply"],
   triggers: { api: true }
   };
   

3. API de teste
   Reinicie o serviço (pnpm run dev) e, em seguida, teste-o com o curl:

   curl -X POST http://localhost:3000/support -H "Content-Type: application/json" -d '{"name": "李明"}'
   

   Retorna o resultado como:

   {"reply": "你好，李明！有什么我可以帮你的吗？"}
   

Usando o Motia Workbench

1. Exibir processo
   existir http://localhost:3000 Abra o Workbench e selecione supportA interface exibe o diagrama de conexão passo a passo.
2. testes em tempo real
   Clique no botão "Test" e digite {"name": "张伟"}Após a execução, o gráfico é atualizado e a janela de registro mostra os detalhes da execução.
3. Registro de depuração
   Os registros são atualizados em tempo real. Se houver erros, eles serão destacados em vermelho, e você poderá clicar nas etapas para ver o problema específico.

desenvolvimento multilíngue

1. Adição de etapas Python
   existir steps Criação de pastas calc.py::

   def handler(input):
   return {"result": input["number"] + 10}
   

2. Processo de atualização
   modificações support.js::

   export default {
   name: "support",
   steps: ["reply", "calc"],
   triggers: { api: true }
   };
   

3. Teste de idiomas híbridos
   Teste com curl:

   curl -X POST http://localhost:3000/support -H "Content-Type: application/json" -d '{"name": "王芳", "number": 5}'
   

   Retorno:

   {"reply": "你好，王芳！有什么我可以帮你的吗？", "result": 15}
   

tarefa orientada por eventos

1. Configuração de eventos
   modificações support.js::

   export default {
   name: "support",
   steps: ["reply"],
   triggers: { event: "messageReceived" }
   };
   

2. evento de acionamento
   Enviar eventos usando a CLI:

   npx motia emit --topic messageReceived --message '{"name": "赵强"}'
   

   O Workbench exibe os resultados da execução.

Agente de implementação

1. Projeto de embalagem
   Em execução:

   pnpm build
   

2. implementações
   Faça upload do arquivo para o servidor e execute-o:

   pnpm run start
   

   Depois de implantado, o agente pode ser chamado por meio de APIs ou eventos.

Operação da função em destaque

Integração com APIs externas

1. Adicionar OpenAI
   existir steps estabelecer analyze.js::

   import { OpenAI } from 'openai';
   const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
   export default async function handler({ input }) {
   const response = await openai.chat.completions.create({
   model: "gpt-4o",
   messages: [{ role: "user", content: input.text }]
   });
   return { result: response.choices[0].message.content };
   }
   

2. Processo de atualização e teste
   Adicionar ao processo analyzeO texto de entrada é analisado usando o teste de API.

Personalização visual

existir steps Adicione configurações de IU às etapas no Workbench, e o Workbench exibirá uma interface personalizada para aprimorar a experiência de visualização.

cenário do aplicativo

1. Agente de análise financeira
   Ouça as atualizações dos dados de mercado e combine a pesquisa na Web e a análise de IA para gerar recomendações de investimento. Ideal para a tomada de decisões em tempo real por equipes financeiras.
2. Agente de gerenciamento do GitHub
   Categorize automaticamente problemas e pull requests do GitHub, atribua tags e revisores e melhore a colaboração da equipe.
3. Automação da caixa de correio
   Monitore sua caixa de entrada do Gmail, analise o conteúdo de seus e-mails e responda automaticamente a eles, o que é perfeito para o atendimento ao cliente ou para a eficiência pessoal.
4. Otimização do gerenciamento de tarefas
   Mova automaticamente cartões de tarefas no Trello, gere resumos e notifique o Slack para simplificar o gerenciamento de projetos.
5. Sistema de teste de conhecimento
   despesa ou gasto RAG A tecnologia extrai o conteúdo da Web e cria um agente de perguntas e respostas, adequado para cenários de educação ou atendimento ao cliente.

QA

1. Que problema o Motia resolve?
   Ele simplifica o processo de criação de agentes de IA complexos, fornecendo ferramentas de controle de código e visualização que evitam as limitações das ferramentas tradicionais.
2. Quais modelos de IA são suportados?
   O Motia não limita os modelos e pode ser usado com OpenAI, Hugging Face ou outros serviços.
3. Como faço para ampliar a funcionalidade?
   Ofereça suporte a qualquer idioma e integração de API externa, adicionando novas etapas e processos.