Skip to content

Commit

Permalink
[EDU-5792] feature: add Agent AI Copilot architecture (#1411)
Browse files Browse the repository at this point in the history
* feature: add file - EN

* feature: add react agent and copilot diagrams

* fix: add copilot diagram

* fix: delete old diagram - rename current diagram

* feature: add file - PT

* feature: add card to archs page - EN/PT
  • Loading branch information
MarianaAguilera authored Dec 23, 2024
1 parent 5c533a3 commit 0822f49
Show file tree
Hide file tree
Showing 6 changed files with 133 additions and 0 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 6 additions & 0 deletions src/content/docs/en/homes/architectures.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,12 @@ namespace: documentation_architectures
product_cards:
- title: Architectures for main use cases
cards:
- icon: /assets/docs/images/uploads/icon-guides.svg
title: AI Agent Copilot
description: >-
By integrating edge computing with AI, AI agents can deliver fast, personalized support and real-time intelligence at the edge.
link: >-
/en/documentation/architectures/artificial-intelligence/ai-agent-copilot-assistant/
- icon: /assets/docs/images/uploads/icon-guides.svg
title: API Gateway Security
description: >-
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
---
title: Implement a Copilot assistant based on a ReAct AI agent
description: >-
By integrating edge computing with AI, AI agents like Copilot can deliver fast, personalized support and real-time intelligence directly at the edge.
permalink: /documentation/architectures/artificial-intelligence/ai-agent-copilot-assistant/
meta_tags: >-
artificial intelligence, edge computing, vector search, AI agent
namespace: docs_arch_AI_agent_copilot
---

Integrating edge computing with artificial intelligence enables innovative use cases. It allows the deployment of AI algorithms and models directly through edge applications, making real-time data processing and analysis possible. In this context, AI agents are a relevant concept, acting as autonomous systems capable of analyzing data, making decisions, and taking action. This approach delivers intelligence right where data is generated and consumed, ensuring faster decision-making, reduced latency, and enhanced efficiency.

One practical application of AI agents is a Copilot implementation. A Copilot is a smart assistant designed to simplify user interactions with a platform or service. By leveraging the edge, the Copilot can provide real-time guidance and personalized user support, helping users navigate the platform and complete complex tasks more efficiently and effectively, all while minimizing latency and maximizing performance.

---

## Copilot Assistant Architecture Diagram

This example uses the **ReAct (Reasoning + Acting) Agent** architecture, which combines logical reasoning and decision-making with action execution, enabling AI agents to process information, plan, and take action.

When a user sends a question or request, the agent retrieves data from the functions and tools containing the logic and knowledge base. If the agent finds an adequate response, return the response. Otherwise, the process is finished.

![ReAct (Reasoning + Acting) AI Agent diagram](/assets/docs/images/uploads/react-agent-architecture-diagram.png)

Considering the implementation of a ReAct agent in an Edge Computing Platform, the general architecture looks similar to this:

![Azion Copilot Assistant Architecture Diagram](/assets/docs/images/uploads/azion-copilot-assistant-architecture-diagram.png)

### Copilot Assistant Dataflow

1. The user sends a request.
2. The healthiest node in the network attends to the request.
3. Edge Application processes it adequately, executing any implemented rule.
4. Edge Functions executes the AI Agent's logic.
5. The AI Agent consults various external tools and resources, such as semantic or vector search engines, databases, and documents, while analyzing the context of the user's query to ensure relevant results.
6. If a suitable response is found, it's sent back to the user. Otherwise, the process concludes with an error message, informing the user of the issue.

### Components

- [Edge Application](/en/documentation/products/build/edge-application/): allows you to build applications that run in Azion Edge Network.
- [Edge Functions for Edge Application](/en/documentation/products/build/edge-application/edge-functions/): executes code closer to the end user, enhancing performance and enabling custom logic for handling requests and responses.
- [Edge SQL](/en/documentation/products/store/edge-sql/): an edge-native SQL solution designed for serverless applications.
- [Vector Search](/en/documentation/products/store/edge-sql/vector-search/): enables customers to implement semantic search engines.
- [Edge Network](https://www.azion.com/en/products/our-network/): a highly distributed architecture that includes strategically located edge nodes.

---

## Implementation

1. Create an [edge application](/en/documentation/products/guides/build/build-an-application/).
2. Create the [Edge SQL database](/en/documentation/products/store/sql/create-database/) that will be consulted.
3. [Create an edge function](/en/documentation/products/build/edge-application/edge-functions/#implementation) with your AI Agent's logic and [instantiate](/en/documentation/products/guides/build/instantiate-edge-functions/) it in the application.
4. Implement [Vector Search](/en/documentation/products/guides/edge-sql-vector-search/).
5. You can monitor your AI Agent through [Azion Observe products](/en/documentation/products/observe/overview/) and specialized tools such as LangGraph.

---

## Related docs

- [Store journey](/en/documentation/products/store/overview/)
- [Azion Edge SQL: enabling access and analysis of structured data at the edge](https://www.azion.com/en/blog/azion-edge-sql/)
5 changes: 5 additions & 0 deletions src/content/docs/pt-br/homes/arquiteturas.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,11 @@ product_cards:
Alcance a conformidade enquanto garante a segurança e o desempenho de suas edge applications.
link: >-
/pt-br/documentacao/arquiteturas/compliance/governanca-risco-conformidade/
- icon: /assets/docs/images/uploads/icon-guides.svg
title: Copilot com Agente de IA
description: >-
Ao integrar edge computing com IA, os agentes de IA podem fornecer suporte personalizado rápido e inteligência em tempo real no edge.
link: /pt-br/documentacao/arquiteturas/inteligencia-artificial/agente-ai-assistente-copilot/
- icon: /assets/docs/images/uploads/icon-guides.svg
title: Entrega de conteúdo no edge
description: >-
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
---
title: Implemente um assistente Copilot baseado em um agente de IA ReAct
description: >-
Ao integrar edge computing com IA, agentes de IA como o Copilot podem fornecer suporte personalizado rápido e inteligência em tempo real diretamente no edge.
permalink: /documentacao/arquiteturas/inteligencia-artificial/agente-ai-assistente-copilot/
meta_tags: >-
inteligência artificial, edge computing, busca vetorial, agente de IA
namespace: docs_arch_AI_agent_copilot
---

A integração de edge computing com inteligência artificial possibilita casos de uso inovadores. Isto, permite a implantação de algoritmos e modelos de IA diretamente através de edge applications, tornando possível o processamento e análise de dados em tempo real. Neste contexto, agentes de IA são um conceito relevante, atuando como sistemas autônomos capazes de analisar dados, tomar decisões e executar ações. Essa abordagem entrega inteligência exatamente onde os dados são gerados e consumidos, garantindo tomada de decisão mais rápida, latência reduzida e eficiência aprimorada.

Uma aplicação prática de agentes de IA é a implementação de um Copilot. Um Copilot é um assistente inteligente projetado para simplificar as interações do usuário com uma plataforma ou serviço. Ao aproveitar o edge, o Copilot pode fornecer orientação em tempo real e suporte personalizado ao usuário, ajudando-os a navegar na plataforma e completar tarefas complexas de forma mais eficiente e eficaz, tudo isso minimizando a latência e maximizando o desempenho.

---

## Diagrama da arquitetura do Assistente Copilot

Este exemplo usa a arquitetura de um **ReAct (Reasoning + Acting) Agent**, que combina raciocínio lógico e tomada de decisão com execução de ações, permitindo que agentes de IA processem informações, planejem e tomem ações.

Quando um usuário envia uma pergunta ou requisição, o agente recupera dados das funções e ferramentas que contêm a lógica e a base de conhecimento. Se o agente encontrar uma resposta adequada, retorna a resposta. Caso contrário, o processo é finalizado.

![Diagrama do Agente de IA ReAct (Reasoning + Acting)](/assets/docs/images/uploads/react-agent-architecture-diagram.png)

Considerando a implementação de um agente ReAct em uma Plataforma de Edge Computing, a arquitetura geral pode ser desenhada assim:

![Diagrama da Arquitetura do Assistente Copilot da Azion](/assets/docs/images/uploads/azion-copilot-assistant-architecture-diagram.png)

### Fluxo de dados do Assistente Copilot

1. O usuário envia uma requisição.
2. O edge node mais saudável da rede atende à requisição.
3. O Edge Application processa adequadamente, executando qualquer regra implementada.
4. O Edge Functions executa a lógica do Agente de IA.
5. O Agente de IA consulta várias ferramentas e recursos externos, como mecanismos de busca semântica ou vetorial, bancos de dados e documentos, enquanto analisa o contexto da consulta do usuário para garantir resultados relevantes.
6. Se uma resposta adequada for encontrada, ela é enviada de volta ao usuário. Caso contrário, o processo é concluído com uma mensagem de erro, informando o usuário sobre o problema.

### Componentes

- [Edge Application](/pt-br/documentacao/produtos/build/edge-application/): permite construir aplicações que rodam na Edge Network da Azion.
- [Edge Functions for Edge Application](/pt-br/documentacao/produtos/build/edge-application/edge-functions/): executa código mais próximo do usuário final, melhorando o desempenho e permitindo lógica personalizada para manipulação de requisições e respostas.
- [Edge SQL](/pt-br/documentacao/produtos/store/edge-sql/): uma solução SQL nativa para edge projetada para aplicações serverless.
- [Vector Search](/pt-br/documentacao/produtos/store/edge-sql/vector-search/): permite que clientes implementem mecanismos de busca semântica.
- [Edge Network](https://www.azion.com/pt-br/produtos/nossa-rede/): uma arquitetura altamente distribuída que inclui edge nodes estrategicamente localizados.

---

## Implementação

1. Crie uma [edge application](/pt-br/documentacao/produtos/guias/build/criar-uma-aplicacao/).
2. Crie o [banco de dados Edge SQL](/pt-br/documentacao/produtos/store/sql/criar-banco-de-dados/) que será consultado.
3. [Crie uma edge function](/pt-br/documentacao/produtos/build/edge-application/edge-functions/) com a lógica do seu Agente de IA e [instancie](/en/documentation/products/guides/build/instantiate-edge-functions/) na aplicação.
4. Implemente [Vector Search](/pt-br/documentacao/produtos/guias/edge-sql-vector-search/).
5. Você pode monitorar seu Agente de IA através dos [produtos Observe da Azion](/pt-br/documentacao/produtos/observe/visao-geral/) e ferramentas especializadas como LangGraph.

---

## Documentação relacionada

- [Jornada Store](/pt-br/documentacao/produtos/store/visao-geral/)
- [Azion Edge SQL: habilitando acesso e análise de dados estruturados na edge](https://www.azion.com/pt-br/blog/azion-edge-sql/)

0 comments on commit 0822f49

Please sign in to comment.