diff --git a/next.config.js b/next.config.js index a9fa12993..754629912 100644 --- a/next.config.js +++ b/next.config.js @@ -449,6 +449,193 @@ module.exports = withNextra({ "/guides/fetch-network/asi-wallet/mobile-wallet/gov-proposal", permanent: true, }, + { + source: "/examples/easy/first-agent", + destination: "/examples/agent/first-agent", + permanent: true, + }, + { + source: "/examples/easy/agents-interval-task", + destination: "/examples/agent/agents-interval-task", + permanent: true, + }, + { + source: "/examples/easy/local-communication", + destination: "/examples/agent/local-communication", + permanent: true, + }, + { + source: "/examples/easy/simple-agent-communication-with-bureau", + destination: "/examples/agent/simple-agent-communication-with-bureau", + permanent: true, + }, + { + source: "/examples/easy/storage", + destination: "/examples/agent/storage", + permanent: true, + }, + { + source: "/examples/intermediate/broadcast", + destination: "/examples/agent/broadcast", + permanent: true, + }, + { + source: "/examples/intermediate/multiple-agents", + destination: "/examples/agent/multiple-agents", + permanent: true, + }, + { + source: "/examples/intermediate/mailbox-agents", + destination: "/examples/agentverse/mailbox-agents", + permanent: true, + }, + { + source: "/examples/intermediate/on-query-proxy", + destination: "/examples/agentverse/on-query-proxy", + permanent: true, + }, + { + source: "/examples/intermediate/dice-roll", + destination: "/examples/DeltaV/dice-roll", + permanent: true, + }, + { + source: "/examples/intermediate/coin-toss", + destination: "/examples/DeltaV/coin-toss", + permanent: true, + }, + { + source: "/examples/intermediate/on_query_example", + destination: "/examples/agent/on_query_example", + permanent: true, + }, + { + source: "/examples/intermediate/agents-with-docker", + destination: "/examples/agent/agents-with-docker", + permanent: true, + }, + { + source: "/examples/intermediate/local-agent-registration", + destination: "/examples/DeltaV/local-agent-registration", + permanent: true, + }, + { + source: "/examples/intermediate/table-booking-demo", + destination: "/examples/agent/table-booking-demo", + permanent: true, + }, + { + source: "/examples/intermediate/agents-cleaning-demo", + destination: "/examples/agent/agents-cleaning-demo", + permanent: true, + }, + { + source: "/examples/intermediate/send-tokens-agents", + destination: "/examples/agent/send-tokens-agents", + permanent: true, + }, + { + source: "/examples/intermediate/verify-messages", + destination: "/examples/agent/verify-messages", + permanent: true, + }, + { + source: "/examples/intermediate/wallet-messaging", + destination: "/examples/agent/wallet-messaging", + permanent: true, + }, + { + source: "/examples/intermediate/name-service", + destination: "/examples/agentverse/name-service", + permanent: true, + }, + { + source: "/examples/intermediate/news-reading-system", + destination: "/examples/DeltaV/news-reading-system", + permanent: true, + }, + { + source: "/examples/intermediate/local-agent-langchain", + destination: "/examples/DeltaV/local-agent-langchain", + permanent: true, + }, + { + source: "/examples/intermediate/on-query", + destination: "/examples/agent/on-query", + permanent: true, + }, + { + source: "/examples/intermediate/agent-and-function-api", + destination: "/examples/agentverse-api/agent-and-function-api", + permanent: true, + }, + { + source: "/examples/intermediate/running-an-agent-on-agentverse", + destination: "/examples/agentverse/running-an-agent-on-agentverse", + permanent: true, + }, + { + source: "/examples/intermediate/agent-secret-api", + destination: "/examples/agentverse-api/agent-secret-api", + permanent: true, + }, + { + source: "/examples/intermediate/langchain-rag", + destination: "/examples/rag/langchain-rag", + permanent: true, + }, + { + source: + "/examples/intermediate/sending-and-verifying-token-transactions-with-agent", + destination: + "/examples/agent/sending-and-verifying-token-transactions-with-agent", + permanent: true, + }, + { + source: "/examples/advanced/open-dialogue-chitchat", + destination: "/examples/dialogues/open-dialogue-chitchat", + permanent: true, + }, + { + source: "/examples/advanced/predefined-dialogue-chitchat", + destination: "/examples/dialogues/predefined-dialogue-chitchat", + permanent: true, + }, + { + source: "/examples/advanced/async-loops", + destination: "/examples/agent/async-loops", + permanent: true, + }, + { + source: "/examples/advanced/chat_api_example", + destination: "/examples/ai-engine-api/chat_api_example", + permanent: true, + }, + { + source: "/examples/advanced/deltaV-dialogues", + destination: "/examples/dialogues/deltaV-dialogues", + permanent: true, + }, + { + source: "/examples/postgres-database-with-an-agent", + destination: "/examples/examplestech/postgres-database-with-an-agent", + permanent: true, + }, + { + source: "/examples/react-example", + destination: "/examples/examplestech/react-example", + permanent: true, + }, + { + source: "/examples/hugging-face-agent", + destination: "/examples/examplestech/hugging-face-agent", + permanent: true, + }, + { + source: "/examples/jupyter-agent", + destination: "/examples/examplestech/jupyter-agent", + permanent: true, + }, ]; }, }); diff --git a/pages/examples/DeltaV/_meta.json b/pages/examples/DeltaV/_meta.json new file mode 100644 index 000000000..7b88a9f6f --- /dev/null +++ b/pages/examples/DeltaV/_meta.json @@ -0,0 +1,28 @@ +{ + "dice-roll": { + "title": "Register a dice roll agent as a Function [intermediate]", + "tags": ["Intermediate", "Python", "Functions", "DeltaV"], + "timestamp": true + }, + "coin-toss": { + "title": "Register a coin toss agent as a Function [intermediate]", + "tags": ["Intermediate", "Python", "Functions", "DeltaV"], + "timestamp": true + }, + + "local-agent-registration": { + "title": "Register a local agent as a Function [intermediate]", + "tags": ["Intermediate", "Python", "Functions", "Agentverse"], + "timestamp": true + }, + "local-agent-langchain": { + "title": "Locally Hosted Agent with LangChain Integration [intermediate]", + "tags": ["Intermediate", "Python", "Functions", "LangChain", "Agentverse"], + "timestamp": true + }, + "news-reading-system": { + "title": "Using News API to build network of Primary and Secondary functions [Advanced]", + "tags": ["Intermediate", "Python", "Functions", "AI Engine"], + "timestamp": true + } +} diff --git a/pages/examples/intermediate/coin-toss.mdx b/pages/examples/DeltaV/coin-toss.mdx similarity index 100% rename from pages/examples/intermediate/coin-toss.mdx rename to pages/examples/DeltaV/coin-toss.mdx diff --git a/pages/examples/DeltaV/dice-roll.mdx b/pages/examples/DeltaV/dice-roll.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/pages/examples/DeltaV/local-agent-langchain.mdx b/pages/examples/DeltaV/local-agent-langchain.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/pages/examples/DeltaV/local-agent-registration.mdx b/pages/examples/DeltaV/local-agent-registration.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/pages/examples/intermediate/news-reading-system.mdx b/pages/examples/DeltaV/news-reading-system.mdx similarity index 100% rename from pages/examples/intermediate/news-reading-system.mdx rename to pages/examples/DeltaV/news-reading-system.mdx diff --git a/pages/examples/_meta.json b/pages/examples/_meta.json index 4e183fc3b..3d3d9dea9 100644 --- a/pages/examples/_meta.json +++ b/pages/examples/_meta.json @@ -1,39 +1,50 @@ { - "easy": { - "title": "Easy Topics", + "agent": { + "title": "Agents", "theme": { "collapsed": false } }, - "intermediate": { - "title": "Intermediate Topics", + "rag": { + "title": "RAG examples", "theme": { "collapsed": false } }, - "advanced": { - "title": "Advanced Topics", + "examplestech": { + "title": "Examples with other Tech", "theme": { "collapsed": false } }, - "postgres-database-with-an-agent": { - "title": "Postgres Database with an Agent", - "tags": ["Intermediate", "Python", "Docker", "PostgreSQL", "Use Cases"], - "timestamp": true + "agentverse": { + "title": "Agentverse", + "theme": { + "collapsed": false + } + }, + "dialogues": { + "title": "Dialogues", + "theme": { + "collapsed": false + } }, - "react-example": { - "title": "React Example", - "tags": ["Intermediate", "Python", "Use Cases"], - "timestamp": true + "agentverse-api": { + "title": "Agentverse API", + "theme": { + "collapsed": false + } }, - "hugging-face-agent": { - "title": "Hugging Face Agent", - "tags": ["Intermediate", "Python", "Functions", "Agentverse"], - "timestamp": true + "DeltaV": { + "title": "DeltaV", + "theme": { + "collapsed": false + } }, - "jupyter-agent": { - "title": "Jupyter Agent", - "timestamp": true + "ai-engine-api": { + "title": "AI-Engine API", + "theme": { + "collapsed": false + } } } diff --git a/pages/examples/advanced/_meta.json b/pages/examples/advanced/_meta.json deleted file mode 100644 index 5e29abab6..000000000 --- a/pages/examples/advanced/_meta.json +++ /dev/null @@ -1,27 +0,0 @@ -{ - "open-dialogue-chitchat": { - "title": "Open Dialogue Chit-Chat", - "tags": ["Advanced", "Python", "Dialogues", "Use cases", "Local"], - "timestamp": true - }, - "predefined-dialogue-chitchat": { - "title": "Predefined Dialogue Chit-Chat", - "tags": ["Advanced", "Python", "Dialogues", "Use cases", "Local"], - "timestamp": true - }, - "async-loops": { - "title": "Asynchronous Loops", - "tags": ["Advanced", "Python", "Communication", "Use Cases", "Local"], - "timestamp": true - }, - "chat_api_example": { - "title": "Chat API example", - "tags": ["Advanced", "Python", "Dialogues", "Use cases", "Hosted"], - "timestamp": true - }, - "deltaV-dialogues": { - "title": "DeltaV Dialogue Chit-Chat", - "tags": ["Advanced", "Python", "Dialogues", "DeltaV", "Hosted"], - "timestamp": true - } -} diff --git a/pages/examples/agent/_meta.json b/pages/examples/agent/_meta.json new file mode 100644 index 000000000..0154a6e4d --- /dev/null +++ b/pages/examples/agent/_meta.json @@ -0,0 +1,99 @@ +{ + "first-agent": { + "title": "Create your first agent [easy]", + "tags": ["Agents", "Beginner", "Installation"], + "timestamp": true + }, + "agents-interval-task": { + "title": "Interval task with Agents [easy]", + "tags": ["Intermediate", "Python", "Handlers", "Use Cases"], + "timestamp": true + }, + "local-communication": { + "title": "Local Network communication [easy]", + "tags": ["Intermediate", "Python", "Communication", "Use Cases"], + "timestamp": true + }, + "simple-agent-communication-with-bureau": { + "title": "Bureau Agents communication [easy]", + "tags": ["Intermediate", "Python", "Communication", "Use Cases"], + "timestamp": true + }, + "storage": { + "title": "Agents storage [easy]", + "tags": ["Intermediate", "Python", "Storage", "Use Cases"], + "timestamp": true + }, + "broadcast": { + "title": "Agents Broadcast [intermediate]", + "tags": ["Intermediate", "Python", "Communication", "Use Cases"], + "timestamp": true + }, + "multiple-agents": { + "title": "Multiple agents communication [intermediate]", + "tags": ["Intermediate", "Python", "Communication", "Use Cases"], + "timestamp": true + }, + "on-query": { + "title": "Query an agent using a proxy API [intermediate]", + "tags": ["Intermediate", "Python", "Communication", "FastAPI", "Proxy"], + "timestamp": true + }, + "on_query_example": { + "title": "Shopping Assistance Agent using on_query [intermediate]", + "tags": ["Intermediate", "Python", "Functions", "OpenAI", "Use Cases"], + "timestamp": true + }, + "table-booking-demo": { + "title": "Table booking service with Agents [intermediate]", + "tags": ["Intermediate", "Python", "Use Cases"], + "timestamp": true + }, + "agents-cleaning-demo": { + "title": "Cleaning service with Agents [intermediate]", + "tags": ["Intermediate", "Python", "Use Cases"], + "timestamp": true + }, + "send-tokens-agents": { + "title": "Send tokens with Agents [intermediate]", + "tags": ["Intermediate", "Python", "Use Cases"], + "timestamp": true + }, + "verify-messages": { + "title": "Verify messages with Agents [intermediate]", + "tags": ["Intermediate", "Python", "Communication", "Use Cases"], + "timestamp": true + }, + "wallet-messaging": { + "title": "Communicating with other agents wallet [intermediate]", + "tags": ["Intermediate", "Python", "Communication", "Wallet"], + "timestamp": true + }, + "on-query": { + "title": "On Query decorator example [intermediate]", + "tags": ["Intermediate", "Python", "Handlers", "Use Cases"], + "timestamp": true + }, + "sending-and-verifying-token-transactions-with-agent": { + "title": "Sending and verifying token transactions with agent [intermediate]", + "tags": [ + "Intermediate", + "Python", + "Web3", + "Token", + "Blockchain", + "Use Cases" + ], + "timestamp": true + }, + "async-loops": { + "title": "Asynchronous Loops [Advanced]", + "tags": ["Advanced", "Python", "Communication", "Use Cases"], + "timestamp": true + }, + "agents-with-docker": { + "title": "Running an Agent with Docker [Intermediate]", + "tags": ["Intermediate", "Python", "Docker", "Use Cases"], + "timestamp": true + } +} diff --git a/pages/examples/intermediate/agents-cleaning-demo.mdx b/pages/examples/agent/agents-cleaning-demo.mdx similarity index 100% rename from pages/examples/intermediate/agents-cleaning-demo.mdx rename to pages/examples/agent/agents-cleaning-demo.mdx diff --git a/pages/examples/easy/agents-interval-task.mdx b/pages/examples/agent/agents-interval-task.mdx similarity index 100% rename from pages/examples/easy/agents-interval-task.mdx rename to pages/examples/agent/agents-interval-task.mdx diff --git a/pages/examples/intermediate/agents-with-docker.mdx b/pages/examples/agent/agents-with-docker.mdx similarity index 99% rename from pages/examples/intermediate/agents-with-docker.mdx rename to pages/examples/agent/agents-with-docker.mdx index 11ef3af11..d785fea84 100644 --- a/pages/examples/intermediate/agents-with-docker.mdx +++ b/pages/examples/agent/agents-with-docker.mdx @@ -222,4 +222,4 @@ poetry_app | INFO: [data_receiver]: Data Receiver received a message from ag poetry_app | INFO: [bureau]: Starting server on http://0.0.0.0:8000 (Press CTRL+C to quit) poetry_app | INFO: [data_sender]: Data Sender received a message from agent1qg0ejev64auhjg7c7xsd32v7npflvhvs5afe43r4gzm4eqmhqgxs7mlfss0: Acknowledging data transfer poetry_app | INFO: [data_receiver]: Data Receiver received a message from agent1qdccxu8z03y3m27p22emtuffjxng8ks3pm69yn703eec6pk5a8p5vzf97qz: Initiating data transfer -``` +``` \ No newline at end of file diff --git a/pages/examples/advanced/async-loops.mdx b/pages/examples/agent/async-loops.mdx similarity index 100% rename from pages/examples/advanced/async-loops.mdx rename to pages/examples/agent/async-loops.mdx diff --git a/pages/examples/intermediate/broadcast.mdx b/pages/examples/agent/broadcast.mdx similarity index 100% rename from pages/examples/intermediate/broadcast.mdx rename to pages/examples/agent/broadcast.mdx diff --git a/pages/examples/easy/first-agent.mdx b/pages/examples/agent/first-agent.mdx similarity index 100% rename from pages/examples/easy/first-agent.mdx rename to pages/examples/agent/first-agent.mdx diff --git a/pages/examples/easy/local-communication.mdx b/pages/examples/agent/local-communication.mdx similarity index 100% rename from pages/examples/easy/local-communication.mdx rename to pages/examples/agent/local-communication.mdx diff --git a/pages/examples/intermediate/multiple-agents.mdx b/pages/examples/agent/multiple-agents.mdx similarity index 100% rename from pages/examples/intermediate/multiple-agents.mdx rename to pages/examples/agent/multiple-agents.mdx diff --git a/pages/examples/intermediate/on-query.mdx b/pages/examples/agent/on-query.mdx similarity index 100% rename from pages/examples/intermediate/on-query.mdx rename to pages/examples/agent/on-query.mdx diff --git a/pages/examples/intermediate/on_query_example.mdx b/pages/examples/agent/on_query_example.mdx similarity index 100% rename from pages/examples/intermediate/on_query_example.mdx rename to pages/examples/agent/on_query_example.mdx diff --git a/pages/examples/intermediate/send-tokens-agents.mdx b/pages/examples/agent/send-tokens-agents.mdx similarity index 100% rename from pages/examples/intermediate/send-tokens-agents.mdx rename to pages/examples/agent/send-tokens-agents.mdx diff --git a/pages/examples/intermediate/sending-and-verifying-token-transactions-with-agent.mdx b/pages/examples/agent/sending-and-verifying-token-transactions-with-agent.mdx similarity index 100% rename from pages/examples/intermediate/sending-and-verifying-token-transactions-with-agent.mdx rename to pages/examples/agent/sending-and-verifying-token-transactions-with-agent.mdx diff --git a/pages/examples/easy/simple-agent-communication-with-bureau.mdx b/pages/examples/agent/simple-agent-communication-with-bureau.mdx similarity index 100% rename from pages/examples/easy/simple-agent-communication-with-bureau.mdx rename to pages/examples/agent/simple-agent-communication-with-bureau.mdx diff --git a/pages/examples/easy/storage.mdx b/pages/examples/agent/storage.mdx similarity index 100% rename from pages/examples/easy/storage.mdx rename to pages/examples/agent/storage.mdx diff --git a/pages/examples/intermediate/table-booking-demo.mdx b/pages/examples/agent/table-booking-demo.mdx similarity index 100% rename from pages/examples/intermediate/table-booking-demo.mdx rename to pages/examples/agent/table-booking-demo.mdx diff --git a/pages/examples/intermediate/verify-messages.mdx b/pages/examples/agent/verify-messages.mdx similarity index 100% rename from pages/examples/intermediate/verify-messages.mdx rename to pages/examples/agent/verify-messages.mdx diff --git a/pages/examples/intermediate/wallet-messaging.mdx b/pages/examples/agent/wallet-messaging.mdx similarity index 100% rename from pages/examples/intermediate/wallet-messaging.mdx rename to pages/examples/agent/wallet-messaging.mdx diff --git a/pages/examples/agentverse-api/_meta.json b/pages/examples/agentverse-api/_meta.json new file mode 100644 index 000000000..750a2194c --- /dev/null +++ b/pages/examples/agentverse-api/_meta.json @@ -0,0 +1,12 @@ +{ + "agent-and-function-api": { + "title": "Agents and Functions Creation using APIs [intermediate]", + "tags": ["Intermediate", "Python", "Functions", "Agentverse"], + "timestamp": true + }, + "agent-secret-api": { + "title": "Adding Secret to agent using Agentverse API [intermediate]", + "tags": ["Intermediate", "Python", "Secrets", "Agentverse"], + "timestamp": true + } +} diff --git a/pages/examples/intermediate/agent-and-function-api.mdx b/pages/examples/agentverse-api/agent-and-function-api.mdx similarity index 100% rename from pages/examples/intermediate/agent-and-function-api.mdx rename to pages/examples/agentverse-api/agent-and-function-api.mdx diff --git a/pages/examples/intermediate/agent-secret-api.mdx b/pages/examples/agentverse-api/agent-secret-api.mdx similarity index 100% rename from pages/examples/intermediate/agent-secret-api.mdx rename to pages/examples/agentverse-api/agent-secret-api.mdx diff --git a/pages/examples/agentverse/_meta.json b/pages/examples/agentverse/_meta.json new file mode 100644 index 000000000..62adb08cd --- /dev/null +++ b/pages/examples/agentverse/_meta.json @@ -0,0 +1,23 @@ +{ + "mailbox-agents": { + "title": "Agents communication using Agentverse Mailbox service [intermediate]", + "tags": ["Intermediate", "Python", "Communication", "Mailbox"], + "timestamp": true + }, + + "on-query-proxy": { + "title": "Query an agent using a proxy API [intermediate]", + "tags": ["Intermediate", "Python", "Communication", "FastAPI", "Proxy"], + "timestamp": true + }, + "name-service": { + "title": "Agents Name Service [intermediate]", + "tags": ["Intermediate", "Python", "Name Service"], + "timestamp": true + }, + "running-an-agent-on-agentverse": { + "title": "Run Agents on Agentverse [intermediate]", + "tags": ["Intermediate", "Python", "Functions", "Agentverse"], + "timestamp": true + } +} diff --git a/pages/examples/intermediate/mailbox-agents.mdx b/pages/examples/agentverse/mailbox-agents.mdx similarity index 100% rename from pages/examples/intermediate/mailbox-agents.mdx rename to pages/examples/agentverse/mailbox-agents.mdx diff --git a/pages/examples/intermediate/name-service.mdx b/pages/examples/agentverse/name-service.mdx similarity index 100% rename from pages/examples/intermediate/name-service.mdx rename to pages/examples/agentverse/name-service.mdx diff --git a/pages/examples/intermediate/on-query-proxy.mdx b/pages/examples/agentverse/on-query-proxy.mdx similarity index 100% rename from pages/examples/intermediate/on-query-proxy.mdx rename to pages/examples/agentverse/on-query-proxy.mdx diff --git a/pages/examples/intermediate/running-an-agent-on-agentverse.mdx b/pages/examples/agentverse/running-an-agent-on-agentverse.mdx similarity index 100% rename from pages/examples/intermediate/running-an-agent-on-agentverse.mdx rename to pages/examples/agentverse/running-an-agent-on-agentverse.mdx diff --git a/pages/examples/ai-engine-api/_meta.json b/pages/examples/ai-engine-api/_meta.json new file mode 100644 index 000000000..d27ca66eb --- /dev/null +++ b/pages/examples/ai-engine-api/_meta.json @@ -0,0 +1,7 @@ +{ + "chat_api_example": { + "title": "Chat API example [Advanced]", + "tags": ["Advanced", "Python", "Dialogues", "Use cases"], + "timestamp": true + } +} diff --git a/pages/examples/advanced/chat_api_example.mdx b/pages/examples/ai-engine-api/chat_api_example.mdx similarity index 100% rename from pages/examples/advanced/chat_api_example.mdx rename to pages/examples/ai-engine-api/chat_api_example.mdx diff --git a/pages/examples/dialogues/_meta.json b/pages/examples/dialogues/_meta.json new file mode 100644 index 000000000..048c9d9d0 --- /dev/null +++ b/pages/examples/dialogues/_meta.json @@ -0,0 +1,17 @@ +{ + "open-dialogue-chitchat": { + "title": "Open Dialogue Chit-Chat [Advanced] [Advanced]", + "tags": ["Advanced", "Python", "Dialogues", "Use cases"], + "timestamp": true + }, + "predefined-dialogue-chitchat": { + "title": "Predefined Dialogue Chit-Chat [Advanced]", + "tags": ["Advanced", "Python", "Dialogues", "Use cases"], + "timestamp": true + }, + "deltaV-dialogues": { + "title": "DeltaV Dialogue Chit-Chat [Advanced]", + "tags": ["Advanced", "Python", "Dialogues", "DeltaV"], + "timestamp": true + } +} diff --git a/pages/examples/advanced/deltaV-dialogues.mdx b/pages/examples/dialogues/deltaV-dialogues.mdx similarity index 100% rename from pages/examples/advanced/deltaV-dialogues.mdx rename to pages/examples/dialogues/deltaV-dialogues.mdx diff --git a/pages/examples/advanced/open-dialogue-chitchat.mdx b/pages/examples/dialogues/open-dialogue-chitchat.mdx similarity index 100% rename from pages/examples/advanced/open-dialogue-chitchat.mdx rename to pages/examples/dialogues/open-dialogue-chitchat.mdx diff --git a/pages/examples/advanced/predefined-dialogue-chitchat.mdx b/pages/examples/dialogues/predefined-dialogue-chitchat.mdx similarity index 100% rename from pages/examples/advanced/predefined-dialogue-chitchat.mdx rename to pages/examples/dialogues/predefined-dialogue-chitchat.mdx diff --git a/pages/examples/easy/_meta.json b/pages/examples/easy/_meta.json deleted file mode 100644 index 669277471..000000000 --- a/pages/examples/easy/_meta.json +++ /dev/null @@ -1,27 +0,0 @@ -{ - "first-agent": { - "title": "Create your first agent", - "tags": ["Agents", "Beginner", "Installation"], - "timestamp": true - }, - "agents-interval-task": { - "title": "Interval task with Agents", - "tags": ["Intermediate", "Python", "Handlers", "Use Cases"], - "timestamp": true - }, - "local-communication": { - "title": "Local Network communication", - "tags": ["Intermediate", "Python", "Communication", "Use Cases"], - "timestamp": true - }, - "simple-agent-communication-with-bureau": { - "title": "Bureau Agents communication", - "tags": ["Intermediate", "Python", "Communication", "Use Cases"], - "timestamp": true - }, - "storage": { - "title": "Agents storage", - "tags": ["Intermediate", "Python", "Storage", "Use Cases"], - "timestamp": true - } -} diff --git a/pages/examples/examplestech/_meta.json b/pages/examples/examplestech/_meta.json new file mode 100644 index 000000000..b1cf6ec15 --- /dev/null +++ b/pages/examples/examplestech/_meta.json @@ -0,0 +1,5 @@ +{ + "jupyter-agent": "Jupyter Notebook Agent", + "hugging-face-agent": "Hugging Face Agent", + "react-example": "React web app Agent" +} diff --git a/pages/examples/hugging-face-agent.mdx b/pages/examples/examplestech/hugging-face-agent.mdx similarity index 99% rename from pages/examples/hugging-face-agent.mdx rename to pages/examples/examplestech/hugging-face-agent.mdx index 08ed2e869..4f465f47c 100644 --- a/pages/examples/hugging-face-agent.mdx +++ b/pages/examples/examplestech/hugging-face-agent.mdx @@ -1,4 +1,4 @@ -import { CodeGroup, DocsCode } from "../../components/code" +import { CodeGroup, DocsCode } from "../../../components/code" # Hugging face API agent as a Function diff --git a/pages/examples/jupyter-agent.mdx b/pages/examples/examplestech/jupyter-agent.mdx similarity index 99% rename from pages/examples/jupyter-agent.mdx rename to pages/examples/examplestech/jupyter-agent.mdx index 35da6d7f0..43c784c3d 100644 --- a/pages/examples/jupyter-agent.mdx +++ b/pages/examples/examplestech/jupyter-agent.mdx @@ -1,4 +1,4 @@ -import { CodeGroup, CodeSegment, DocsCode, GithubCodeSegment } from "../../components/code"; +import { CodeGroup, CodeSegment, DocsCode, GithubCodeSegment } from "../../../components/code"; # Using Jupyter notebook to build an Agent diff --git a/pages/examples/postgres-database-with-an-agent.mdx b/pages/examples/examplestech/postgres-database-with-an-agent.mdx similarity index 99% rename from pages/examples/postgres-database-with-an-agent.mdx rename to pages/examples/examplestech/postgres-database-with-an-agent.mdx index 43a4be204..be42ea3a3 100644 --- a/pages/examples/postgres-database-with-an-agent.mdx +++ b/pages/examples/examplestech/postgres-database-with-an-agent.mdx @@ -1,4 +1,4 @@ -import { CodeGroup, DocsCode } from "../../components/code" +import { CodeGroup, DocsCode } from "../../../components/code" # Utilize the PostgreSQL database with the Agent diff --git a/pages/examples/react-example.mdx b/pages/examples/examplestech/react-example.mdx similarity index 99% rename from pages/examples/react-example.mdx rename to pages/examples/examplestech/react-example.mdx index 148c91b80..5ae6c0aa8 100644 --- a/pages/examples/react-example.mdx +++ b/pages/examples/examplestech/react-example.mdx @@ -1,5 +1,5 @@ import { Callout } from 'nextra/components' -import { CodeGroup, DocsCode } from "../../components/code" +import { CodeGroup, DocsCode } from "../../../components/code" # React app with agents 'on_query' decorator diff --git a/pages/examples/intermediate/_meta.json b/pages/examples/intermediate/_meta.json deleted file mode 100644 index ed580c21f..000000000 --- a/pages/examples/intermediate/_meta.json +++ /dev/null @@ -1,131 +0,0 @@ -{ - "broadcast": { - "title": "Agents Broadcast", - "tags": ["Intermediate", "Python", "Communication", "Use Cases"], - "timestamp": true - }, - "multiple-agents": { - "title": "Multiple agents communication", - "tags": ["Intermediate", "Python", "Communication", "Use Cases"], - "timestamp": true - }, - "mailbox-agents": { - "title": "Agents communication using Agentverse Mailbox service", - "tags": ["Intermediate", "Python", "Communication", "Mailbox"], - "timestamp": true - }, - - "on-query-proxy": { - "title": "Query an agent using a proxy API", - "tags": ["Intermediate", "Python", "Communication", "FastAPI", "Proxy"], - "timestamp": true - }, - "dice-roll": { - "title": "Register a dice roll agent as a Function", - "tags": ["Intermediate", "Python", "Functions", "DeltaV"], - "timestamp": true - }, - "coin-toss": { - "title": "Register a coin toss agent as a Function", - "tags": ["Intermediate", "Python", "Functions", "DeltaV"], - "timestamp": true - }, - - "on_query_example": { - "title": "Shopping Assistance Agent using on_query ", - "tags": ["Intermediate", "Python", "Functions", "OpenAI", "Use Cases"], - "timestamp": true - }, - "agents-with-docker": { - "title": "Running an Agent with Docker", - "tags": ["Intermediate", "Python", "Docker", "Use Cases"], - "timestamp": true - }, - "local-agent-registration": { - "title": "Register a local agent as a Function", - "tags": ["Intermediate", "Python", "Functions", "Agentverse"], - "timestamp": true - }, - "table-booking-demo": { - "title": "Table booking service with Agents", - "tags": ["Intermediate", "Python", "Use Cases"], - "timestamp": true - }, - "agents-cleaning-demo": { - "title": "Cleaning service with Agents", - "tags": ["Intermediate", "Python", "Use Cases"], - "timestamp": true - }, - - "send-tokens-agents": { - "title": "Send tokens with Agents", - "tags": ["Intermediate", "Python", "Use Cases"], - "timestamp": true - }, - - "verify-messages": { - "title": "Verify messages with Agents", - "tags": ["Intermediate", "Python", "Communication", "Use Cases"], - "timestamp": true - }, - "wallet-messaging": { - "title": "Communicating with other agents wallet", - "tags": ["Intermediate", "Python", "Communication", "Wallet"], - "timestamp": true - }, - - "name-service": { - "title": "Agents Name Service", - "tags": ["Intermediate", "Python", "Name Service"], - "timestamp": true - }, - - "news-reading-system": { - "title": "Using News API to build network of Primary and Secondary functions", - "tags": ["Intermediate", "Python", "Functions", "AI Engine"], - "timestamp": true - }, - "local-agent-langchain": { - "title": "Locally Hosted Agent with LangChain Integration", - "tags": ["Intermediate", "Python", "Functions", "LangChain", "Agentverse"], - "timestamp": true - }, - "on-query": { - "title": "On Query decorator example", - "tags": ["Intermediate", "Python", "Handlers", "Use Cases"], - "timestamp": true - }, - "agent-and-function-api": { - "title": "Agents and Functions Creation using APIs", - "tags": ["Intermediate", "Python", "Functions", "Agentverse"], - "timestamp": true - }, - "running-an-agent-on-agentverse": { - "title": "Run Agents on Agentverse", - "tags": ["Intermediate", "Python", "Functions", "Agentverse"], - "timestamp": true - }, - "agent-secret-api": { - "title": "Adding Secret to agent using Agentverse API", - "tags": ["Intermediate", "Python", "Secrets", "Agentverse"], - "timestamp": true - }, - "langchain-rag": { - "title": "Langchain RAG Agent", - "tags": ["Intermediate", "Python", "Functions", "LangChain", "DeltaV"], - "timestamp": true - }, - - "sending-and-verifying-token-transactions-with-agent": { - "title": "Sending and verifying token transactions with agent", - "tags": [ - "Intermediate", - "Python", - "Web3", - "Token", - "Blockchain", - "Use Cases" - ], - "timestamp": true - } -} diff --git a/pages/examples/intermediate/dice-roll.mdx b/pages/examples/intermediate/dice-roll.mdx deleted file mode 100644 index 044a76541..000000000 --- a/pages/examples/intermediate/dice-roll.mdx +++ /dev/null @@ -1,115 +0,0 @@ -import { CodeGroup, DocsCode, GithubCodeSegment, CodeSegment } from "../../../components/code" - -# Register a dice roll agent as a Function - -## Introduction - -This file can be run on any platform supporting Python, with the necessary install permissions. -To enable this on [DeltaV ↗️](/concepts/ai-engine/deltav) you will need to create and register a Function. You will need to run this file on a device that can open a port. - -Please check out the example code in our [examples repo ↗️](https://github.com/fetchai/uAgent-Examples/blob/main/1-uagents/examples/intermediate/dice-roll/agent.py) to run this locally. - -### Guide - -- [Register a dice roll agent as a Function ↗️](/guides/agentverse/creating-agentverse-agents/simple-dice-roll-agent) - -### Supporting documentation - -- [Creating an agent ↗️](/guides/agents/create-a-uagent) - -- [Register in Almanac ↗️](/guides/agents/register-in-almanac) - -- [Almanac Contract ↗️](/references/contracts/uagents-almanac/almanac-overview) - -- [Protocols ↗️](/references/uagents/uagents-protocols/agent-protocols) - -- [Agentverse Functions ↗️](/concepts/agent-services/services) - -- [Register an Agent Function on the Agentverse ↗️](/guides/agentverse/registering-agent-services) - -### The agent - - - - - - - - ```py copy filename="agent.py" - - import random - from uagents import Agent, Context, Model, Field, Protocol - from uagents.setup import fund_agent_if_low - from ai_engine import UAgentResponse, UAgentResponseType - - - class DiceRoll(Model): - num_rolls: int = Field(description="Number of rolls.") - - # First generate a secure seed phrase (e.g. https://pypi.org/project/mnemonic/) - SEED_PHRASE = "put_your_seed_phrase_here" - - # Now go to https://agentverse.ai, register your agent in the Mailroom by providing the address you just copied. - # Then, copy the agent's mailbox key and insert it here below inline - AGENT_MAILBOX_KEY = "put_your_AGENT_MAILBOX_KEY_here" - - # Now your agent is ready to join the agentverse! - dice_roll_agent = Agent( - name="dice_roll_agent", - seed=SEED_PHRASE, - mailbox=f"{AGENT_MAILBOX_KEY}@https://agentverse.ai", - ) - - fund_agent_if_low(dice_roll_agent.wallet.address()) - - # Copy the address shown below - print(f"Your agent's address is: {dice_roll_agent.address}") - - dice_roll_protocol = Protocol("DiceRoll") - - - @dice_roll_protocol.on_message(model=DiceRoll, replies={UAgentResponse}) - async def roll_dice(ctx: Context, sender: str, msg: DiceRoll): - result = ", ".join([str(random.randint(1, 6)) for _ in range(msg.num_rolls)]) - message = f"Dice roll results: {result}" - await ctx.send( - sender, UAgentResponse(message=message, type=UAgentResponseType.FINAL) - ) - - dice_roll_agent.include(dice_roll_protocol, publish_manifest=True) - - if __name__ == "__main__": - dice_roll_agent.run() - -``` - - - -```py copy filename="agent.py" -import random -# third party modules used in this example -from uagents import Field -from ai_engine import UAgentResponse, UAgentResponseType - -class DiceRoll(Model): - num_rolls: int = Field(description="Number of rolls.") - -dice_roll_protocol = Protocol("DiceRoll") - -@dice_roll_protocol.on_message(model=DiceRoll, replies={UAgentResponse}) -async def roll_dice(ctx: Context, sender: str, msg: DiceRoll): - result = ", ".join([str(random.randint(1, 6)) for _ in range(msg.num_rolls)]) - message = f"Dice roll results: {result}" - await ctx.send( - sender, UAgentResponse(message=message, type=UAgentResponseType.FINAL) -) - -agent.include(dice_roll_protocol, publish_manifest=True) -``` - - diff --git a/pages/examples/intermediate/local-agent-langchain.mdx b/pages/examples/intermediate/local-agent-langchain.mdx deleted file mode 100644 index 533275036..000000000 --- a/pages/examples/intermediate/local-agent-langchain.mdx +++ /dev/null @@ -1,90 +0,0 @@ -import { CodeGroup, DocsCode, GithubCodeSegment, CodeSegment } from "../../../components/code" - -# Locally Hosted Agent with LangChain Integration - -## Introduction - -This guide demonstrates how to run an agent on your own hardware or infrastructure, making it accessible over Agentverse and DeltaV using the Agentverse Mailroom. The example uses a locally hosted agent that utilizes LangChain's Wikipedia integration to process requests related to Wikipedia search. - -Please check out the example code in our [examples repo ↗️](https://github.com/fetchai/uAgent-Examples/blob/main/1-uagents/examples/intermediate/local-agent-langchain/agent.py) to run this locally. - -### Supporting documentation - -- [Creating an agent ↗️](/guides/agents/create-a-uagent) - -- [Register in Almanac ↗️](/guides/agents/register-in-almanac) - -- [Almanac Contract ↗️](/references/contracts/uagents-almanac/almanac-overview) - -- [Protocols ↗️](/references/uagents/uagents-protocols/agent-protocols) - -- [Agentverse Functions ↗️](/guides/agents/intermediate/agent-functions) - -- [Register an Agent Function on the Agentverse ↗️](/guides/agentverse/agentverse-functions/registering-agent-services) - -- [Options for running your local agents ↗️](/guides/agents/intermediate/options-for-running-local-agents) - -### The agent - - - - - - - - ```py copy filename="agent.py" - - from langchain_community.tools import WikipediaQueryRun - from langchain_community.utilities import WikipediaAPIWrapper - from uagents.setup import fund_agent_if_low - from uagents import Agent, Context, Protocol, Model - from uagents import Field - from ai_engine import UAgentResponse, UAgentResponseType - - # Extend your protocol with Wikipedia data fetching - class WikiReq(Model): - search_keyword: str = Field(description="This describes the keyword you want to search on wiki") - - SEED_PHRASE = "" - - # Copy the address shown below - print(f"Your agent's address is: {Agent(seed=SEED_PHRASE).address}") - - AGENT_MAILBOX_KEY = "Your_mailbox_address" - - # Now your agent is ready to join the agentverse! - WikiAgent = Agent( - name="Wiki Agent", - seed=SEED_PHRASE, - mailbox=f"{AGENT_MAILBOX_KEY}@https://agentverse.ai", - ) - fund_agent_if_low(WikiAgent.wallet.address()) #funding agent. - wiki_protocol = Protocol("Wiki Protocol") - - @wiki_protocol.on_message(model=WikiReq, replies={UAgentResponse}) - async def load_dalle(ctx: Context, sender: str, msg: WikiReq): - wikipedia = WikipediaQueryRun(api_wrapper=WikipediaAPIWrapper()) - ctx.logger.info(msg.search_keyword) - try: - result = wikipedia.run(msg.search_keyword) - except Exception as e: - ctx.logger.info(f"Error generating response: {e}") - # Send an error response back to the user - await ctx.send( - sender, UAgentResponse(message=str(result), type=UAgentResponseType.FINAL) - ) - - WikiAgent.include(wiki_protocol, publish_manifest=True) - WikiAgent.run() - -``` - - -### Register Agent Function - -Head to this [guide ↗️](/guides/agentverse/agentverse-functions/registering-agent-services) for a detailed overview of the registration process of Agent Functions on the Agentverse. diff --git a/pages/examples/intermediate/local-agent-registration.mdx b/pages/examples/intermediate/local-agent-registration.mdx deleted file mode 100644 index 5e2f51b17..000000000 --- a/pages/examples/intermediate/local-agent-registration.mdx +++ /dev/null @@ -1,115 +0,0 @@ -import { CodeGroup, DocsCode, GithubCodeSegment, CodeSegment } from "../../../components/code" - -# Register a local agent as a Function - -## Introduction - -This file can be run on any platform supporting Python, with the necessary install permissions. This example shows one local agent registered as an Agent Function on the Agentverse and which can be queried on [DeltaV ↗️](/concepts/ai-engine/deltav). - -Please check out the example code in our [examples repo ↗️](https://github.com/fetchai/uAgent-Examples/blob/main/1-uagents/examples/intermediate/local-agent-registration/agent.py) to run this locally. - -### Supporting documentation - -- [Creating an agent↗️](/guides/agents/create-a-uagent) - -- [Register in Almanac ↗️](/guides/agents/register-in-almanac) - -- [Almanac Contract ↗️](/references/contracts/uagents-almanac/almanac-overview) - -- [Protocols ↗️](/references/uagents/uagents-protocols/agent-protocols) - -- [Agentverse Functions ↗️](/guides/services/services) - -- [Running locally ↗️](/guides/agents/running-locally) - -- [Register an Agent Function on the Agentverse ↗️](/guides/agentverse/registering-agent-services) - -- [Register a local Agent Function on the Agentverse ↗️](/guides/agents/running-locally#register-your-agent-function-on-the-agentverse) - -### The script - - - - - - - - ```py copy filename="agent.py" - - from uagents.setup import fund_agent_if_low - from uagents import Agent, Context, Protocol, Model - import random - from uagents import Field - from ai_engine import UAgentResponse, UAgentResponseType - import sys - - dungeons = Agent( - name="dungeonsanddragonsdiceroll", - port=6145, - seed="RANDOM STRINGS", - endpoint=["http://YOUR_IP:6145/submit"], - ) - - fund_agent_if_low(dungeons.wallet.address()) - - @dungeons.on_event("startup") - async def hi(ctx: Context): - ctx.logger.info(dungeons.address) - - class Request(Model): - dice_sides: int = Field(description="How many sides does your dice need?") - - dice_roll_protocol = Protocol("DungeonsAndDragonsDiceRoll") - - @dice_roll_protocol.on_message(model=Request, replies={UAgentResponse}) - async def roll_dice(ctx: Context, sender: str, msg: Request): - result = str(random.randint(1, msg.dice_sides)) - message = f"Dice roll result: {result}" - await ctx.send( - sender, UAgentResponse(message=message, type=UAgentResponseType.FINAL) - ) - - dungeons.include(dice_roll_protocol, publish_manifest=True) - - dungeons.run() - -``` - - - -```py copy filename="agent.py" -from uagents import Agent, Context, Protocol, Model -import random -from uagents import Field -from ai_engine import UAgentResponse, UAgentResponseType - -@agent.on_event("startup") -async def hi(ctx: Context): - ctx.logger.info(dungeons.address) - -class Request(Model): - dice_sides: int = Field(description="How many sides does your dice need?") - -dice_roll_protocol = Protocol("DungeonsAndDragonsDiceRoll") - -@agent.on_message(model=Request, replies={UAgentResponse}) -async def roll_dice(ctx: Context, sender: str, msg: Request): - result = str(random.randint(1, msg.dice_sides)) - message = f"Dice roll result: {result}" - await ctx.send( - sender, UAgentResponse(message=message, type=UAgentResponseType.FINAL) - ) - -agent.include(dice_roll_protocol, publish_manifest=True) -``` - - - -### Register Agent Function - -For this step, head to this guide for [registering a local Agent Function on the Agentverse ↗️](/guides/agents/running-locally#register-your-agent-function-on-the-agentverse) for a detailed overview of the registration process. diff --git a/pages/examples/rag/_meta.json b/pages/examples/rag/_meta.json new file mode 100644 index 000000000..2cf5b2b3c --- /dev/null +++ b/pages/examples/rag/_meta.json @@ -0,0 +1,7 @@ +{ + "langchain-rag": { + "title": "Langchain RAG Agent [intermediate]", + "tags": ["Intermediate", "Python", "Functions", "LangChain", "DeltaV"], + "timestamp": true + } +} diff --git a/pages/examples/intermediate/langchain-rag.mdx b/pages/examples/rag/langchain-rag.mdx similarity index 100% rename from pages/examples/intermediate/langchain-rag.mdx rename to pages/examples/rag/langchain-rag.mdx