Agent Harness 架构、数据层设计与记忆工程实践

Speaker: Hello. Hello. Perfect. Yep. So, perfect. Yeah, this volume is perfect. It's just a website that I registered the domain on Saturday just to do the registration of the workshop. But for those of you who are going to follow along with me, just know that after you complete that process in the workshop, you will get an invitation to the repository and just view the invitation, accept it, and then you will be able to run the workshop.

We'll be running the workshop on GitHub Codespaces. So, if you want to start that up, it takes like five minutes. Just for reference, I'm going to use the first 30 minutes to give you an introduction to agent harness and lots of other concepts, and then in the next hour and a half, we're going to actually go through the workshop together. Sound good? Okay, perfect.

And thank you, by the way, for being here because I know it's Monday 9:00 a.m. So, I commend you all for being here. Just two minutes before we begin. So I will shut up.

Speaker: All right. Well, let's begin, guys. So, thank you for being on this at this time here with me. I know it's 9:00 a.m. like I said, so hopefully I and my team can make your time worthwhile. At the end of this session, what I would like you to leave with is some knowledge on agent memory and agent harnesses. How you can build your own agent harness, which is nowadays one of the hot topics on AI, I would say.

Lots of people are talking about models constantly, but the thing is that models like language models, they are the frozen part of the reasoning, right? We just have to accept what we are given, and during the past few weeks, if you're following the news, you will have seen that this has never been more true than now. So the harness is what we're going to talk about.

For those of you who weren't here, you can scan this QR code or go to that website workshopwaitingroom.com and just register. You will get an invitation to a GitHub repo, and on this GitHub, you will be able to create a GitHub Codespace where we will run the workshop and you will have everything set up for you.

So just a little introduction on who I am. I've been working for Oracle for seven years. I've been a developer advocate for about four of them, and you can find my talks and I'm very active on GitHub as well. So if you're a GitHub user, check out my GitHub profile if you like. What is the highlight of my career so far? I launched a course with Andrew Ng on agent memory. So if you're interested in the memory components of what we are going to discuss today, you could just check out that course if you'd like.

Speaker: These are the things that we are going to talk through today. First of all, we're going to do a little introduction on what the agent stack is, and then we're going to zoom into the data layer where the memory lives. Then we're going to explore a little bit about the different shapes that AI applications take nowadays. What an agent is, followed by the seven different layers that make up an agent harness. So if you just follow these seven different structures, you will be able to create an agent harness, a minimal agent harness that you can connect any model to. Then we're going to finally talk a little bit about continual learning and how as Oracle we are uniquely positioned to help you achieve and develop agent harnesses and AI applications.

So the agent stack—and by the way, if you have any questions, just raise your hand. I'm very happy to take questions as well.

The agent stack: every AI agent sits on these five layers. You have an Application which is the product surface, right? What we interact with as users. You have Data, and that has lots of components. You have memory, you have knowledge, you have retrieval, encoding, search. You have the Model itself, the reasoning large language model that is behind everything. Infrastructure which is the orchestration—what model do we serve depending on the reasoning effort that we need and things like that. And then we have Compute which is the cloud or GPUs, and also the database engine.

And the application, the model, the infrastructure, and the compute—these four layers, except for the data, they are increasingly commoditized. What do I mean by that? They are trying to take away the complexity from these layers out of our domain, right? So the thing that we have the most control over when working with AI applications is actually the data, and that's the part that we're going to focus in because the agent harness excels and lives very closely with the data layer.

Speaker: So let's focus on the data layer. The data layer is where an agent harness appears and it has many components. The first component is the gateway, and MCP is interesting because that's the one that connects an agent harness to data and tools. So kind of think of a large language model like an isolated thing that wouldn't be able to work at all if it didn't have access to things like data, right?

So you then have like the memory layer, the semantic layer, retrieval layer, context layer, and tools and skills that are built on top of the gateway and MCP layer. Let's say for instance that you have an application on your computer and your large language model doesn't have access to it. For instance, Outlook, right? So if you might want to have your large language model connect to that, you can create an MCP, you specify some functions, and then the LLM all of a sudden is able to communicate with this program. So gateway and MCP is like the layer that connects a large language model to the outside world or the factor to our computer or wherever you're working.

Speaker: And AI applications today, they take up four different shapes, right? You have LLM chatbots which are very passive, they just respond when you ask a question. You also have RAG applications which are semi-passive because they have to do some kind of processing in the background, but then you also have a passive nature of it. And then you have the more active components of AI applications, which are what we kind of use every day like Claude Code etc. etc., which are a combination of LLM-driven workflows that provide automation and AI agents that provide autonomy. And we'll explain later what I mean by that.

But first, I want you to have a very clear definition of what an AI agent is. So to me, an AI agent is essentially a model (large language model) plus a harness. The model itself will be the reasoning, and everything else will be the harness.

So this definition is something like this: An autonomous entity whose cognitive functions are powered by a large language model for reasoning. They are augmented by a database or files for memory. They are extended through tools for actions, and grounded in inputs that let it perceive its environment. So an agent is a model plus the harness.

Speaker: So if the agent is the model plus the harness in this diagram, right, we have reasoning, and the reasoning is the part that we don't control. It's the part that's heavily subsidized, the part that we rent. If you're like me, you're subscribed to every imaginable subscription on earth, and that's the thing that we do not control, right? We have no control over what we are offered. And then we have memory, tools, and perception that actually we get some customizability that we can do.

So the goal of harness engineering is to create reliable and predictable outputs over and over. Whereas a reasoning model is very non-deterministic. You might give it the same input and it might produce different outputs every time. Right?

So I said that in AI applications, the most typical ones nowadays, Claude Code and any other type that you can think of, is a combination of automation plus autonomy. Why? Well, because automation provides reliability to a system and autonomy gives flexibility. And this is a combination that is very convenient when we...

Speaker: ...are developing ourselves. By the way, raise of hands. Who is working as an AI engineer or as an AI developer? Oh my god. Okay, good. So, you must all have used one of these systems, right? So, all of them they have this commonality which is they have autonomy and they have flexibility. Um, yeah. So the idea is that these systems right they are built on top of an a proprietary agent harness and an agent harness is nothing more than everything that we spoken about an AI agent all the things that you need to do around that to enable it to produce reliable and repeatable outcomes right so the model itself nondeterministic same input different outputs every But the harness, what we want to do with the harness is to turn this nondeterministic nature of a large language model and be able to produce reliable and repeatable results.

So the reasoning which is the part that we do not control, we're not going to focus actually the harnesses are built on top of models that are kind of swappable. you just need like a common interface like an open AI protocol or the anthropic API specification, right? All these things make it so that the model part is swappable and the harness is what we're going to focus on today.

So, seven things that make up an agent harness. And as I said, we're not going to touch on the model layer because we have no control over it. But let's go a little bit more uh in detail into each of these. Right?

Speaker: You need a storage layer on your agent harness that essentially determines where the data is going to live, where the memory physically lives. uh and we'll see about this dilemma that has been going on about the last six months about files versus databases and why I think a hybrid uh combination of both is actually the best part.

Then you also have memory engineering components which are all the encoding, the search and the retrieval components of it. And also the semantic layer which is kind of the the hidden things that happen or the hidden vocabulary that we assume that a large language model knows that is kind of proprietary to our companies or our knowledge. What we don't say to the LLM kind of that's the semantic layer.

We'll lightly touch on agent loops and what an agent loop is and how to implement a very very minimalistic agent loop and finally go about some context engineering techniques that you know keep the window as salient as possible the context window as salient as possible. You want to minimize the context window as much as possible so that that the task that you're solving stays relevant.

So until here we have done an introduction to what an AI agent is right its use cases and now we're going to dive deeper into uh an agent harness and each one of the individual components.

Speaker: So the model layer right the frozen reasoning core I say it's frozen because typically the weights of a model don't change and I say typically because uh we are actually I'm actually in the process with Casio sitting right there. We're going to record a new course with Andrew on continue learning for a agents. So if you're interested just check that out in a couple couple weeks.

But the thing is that 99.9% of the time you will have a model and the weights of the model will never change uh unless you have millions of dollars or you know a lot of time or GPUs it's very hard to change the weights of a model. So there are other ways in which you can affect the reasoning without actually changing the weights of the model. But this is motivation for for the continual learning part that we will see in the workshop.

Speaker: where does the memory live right the files versus databases dilemma that we've been having uh since January kind of some people are very maximalists of files and some of us are well oh I will not include myself but some of some people are also maximalists of the database um and you know both things are right files have convenient things convenient characteristics and also the databases

So the files right they are very easy to like they are very they match the model's instincts they are very easy to create they are very easy to insert and append data into files right it's very it has a very unstructured nature to it and databases on the other hand or the conception that people have is that they have a very structured way right but that's when you're thinking about SQL like SQL

And the thing is that you don't actually need to like choose one or the other. You can actually use both of them. Like files are attractive because the models picks them and they kind of work very very easily with operating systems. They follow posic semantics. So they are compatible on Debian, Ubuntu, any other operating system that you might want.

And they also have some disadvantages. for instance they don't have transactional consistency. So this is uh one of the problems that I wanted to talk about. If you are a degenerate like me and you are working I don't know with 8 16 32 agents at a time. Uh the problem with this is that files cannot be modified and inserted and modified at the same time. So what is the solution nowadays to not having transactional consistency and working with files? Any suggestions?

Work trees.

Exa. Exactly. So agents what they when they want to modify a file but another agent is working on this thing, they just create a different work tree, right? They will do all the progress in the work tree and then after the implementation is done they will merge to master or the merge to main sorry. So this is the way that is a workaround against not having transactional consistency right and you also have other characteristics like for instance hybrid search um this is not available on files but is very very easily achieved on databases. Um you don't have backups either. So if your operating system gets corrupted or something, you will just lose everything. And these are things that the database fixed 354 years ago and people have kind of forgotten about that.

Speaker: So what I want to do is to give you kind of the best of each of the of the implementations, right? You can get the benefits of files and the benefits of databases in the same place. And we'll see why. But these are some of the advantages, right? You have acid consistency. So atomic operations, consistent operations, isolated and durable. You have high availability. You might replicate the database and let it be, you know, in three different places in the world with a replication factor. You also have vector search, which is very easy. In files, you just have to do like regular expression matching or a derivative of that. and you know lots of other lots of other things.

So what we will do on the on the actual workshop is we're going to run an actual example of trying to modify a file with three different agents that will be working on the same file and trying to update a counter on this file and let's see who's faster. I know the answer of course but you will you'll get to know it later.

But what I want to introduce to you is that we have a thing called the Oracle DBFS or the database file system where you can store files inside the database on a file system and that gives you you know lots of the advantages that we said. You will get files with acid trans uh transactional consistency. You will get vector search relations security high availability etc. Right?

And my suggestion is that since a hybrid system works best um we can have things like for instance uh short-term memory right that lives in files and when something needs to be promoted into a long-term memory for instance user preferences things like this they can go into a more structured space like a database and this is what we'll do in the workshop for the encoding the search and the retrieval which was another of the components in the agent harness.

We also have a lang chain integration that I want to mention called langchain Oracle DB that makes it very easy to insert into vector stores, search in the vector stores and retrieve from the vector stores. So also we have another thing called in database embeddings. Have you ever heard about in database embeddings? Yes. Okay. So in database embeddings is very convenient especially for enterprise customers because you will get the embedding model inside the database so that when you're

Oracle Presenter: Doing embeddings, you don't have to call a third-party service, and that's very convenient for isolate, like data retention and data security purposes.

Oracle Presenter: So this is what an embedding searching and reranking model would look like from a chatbot interface, for instance. Right, you have a lot of documents, then you kind of use a bi-encoder—so a bi-encoder is essentially an embedding model. You will create embeddings out of these documents, you will split them and create vectors, put it into a vector store, right? And then you will get a user prompt, a user query, a question; you can also create an embedding out of that and then compare it to what you had previously on your vector store. And this is how you get the most relevant vectors in an answer.

Oracle Presenter: Then you will run a cross-encoder, which is a reranker, and take a look at the question plus the result, and that's how questions are answered kind of in RAG applications. Right? So these things we are also going to touch briefly on the workshop.

Oracle Presenter: And the things that, you know, imagine this RAG application from the beginning: from the documents you create, you do lots of things, right? You do tokenization, then you create the embeddings, um, you have to do things like deduplicating the data, normalization, uh, like redacting personally identifiable information, lots of things, right?

Oracle Presenter: And then on your store you have textual data from the documents, you have metadata which is typically stored in JSON, you have vectors which are represented as dense embeddings of 32 bits... Like you have so many types of data that you need to work on that typically what people have is, for instance, I don't know, I will not name names so I don't get in trouble, but you know, you might need like different databases for each one of these, right? You get what I mean?

Oracle Presenter: So there is a very high, nowadays very high data synchronization logic overhead for AI engineers or even for agents, right? So lots of maintenance required and lots of engineering effort on it. And this is something that we want to avoid.

Oracle Presenter: So what I want you to do today is just to try us out as Oracle. Try our database. We have support for every type of data imaginable that you can think of. Um, we are called the converged database. We are the only converged database in the market that we support JSON, we support relational, we support uh spatial, graph, JSON, anything that you can think of you'll be able to create with us.

Oracle Presenter: And you'll get like one database engine, one query interface, and uh one single development stack. Everything will be in the same database. So also for data security purposes, you just have to, you know, secure and save all your data in one place. So a single attack vector is what you need to worry about. You don't need to worry about updating five different databases. You can just worry on securing one database. So we can be the engine of your AI applications, not just a single step, which is what people think of when they're working with databases, right? Um, yeah.

Oracle Presenter: So agent memory. Agent memory is essentially a description of all the mechanisms and the systems that allow an agent to retain, reuse, refine and recall information. We want to reuse the data and refine it in the process. But we want to reuse the data. So that the next time that an agent or us as engineers we are working on a problem that took us three hours, the next time that we observe this problem, the problem becomes easier either for AI agents or for us.

Oracle Presenter: And agent memory has lots of lots of components, right? We have short-term memory, we have long-term memory, and then we have shared memory, which is something that's relatively new. Um and this shared memory is kind of what happens when a sub-agent is communicating with its parent, for instance, or two agents are trying to collaborate on solving one specific problem together. And then what I want you to see is that depending on the type of memory or the type of thing that we want to store, it will be in one place or the other, right?

Oracle Presenter: So short-term memory is kind of ephemeral, is very short-lived, and it's very useful for things that are happening right now. For instance, the to-do list on a coding agent, right? It's happening right now, but you actually don't want to save that, you know, in long term.

Oracle Presenter: But then there are things like, for instance, episodic memory, previous conversations that you've had, that's very useful to have. For instance, um, I don't know if you use Claude—some people are using Claude here—but in Claude you might take your previous conversations and try to refine all your workflows and your skills based on the things that you've done in the past. So this is something that makes sense to save in the long run, right?

Oracle Presenter: You also have things like procedural memory, previous workflows that have worked very well for your system. For instance, you worked on this front end and then you created a very beautiful design that you like. You might take the whole conversation and turn that into a workflow that is repeatable and reusable so that the next time you're working on a front end, the results will be similar to the previous one. Right? So these are the things that we will see on the workshop.

Oracle Presenter: And some people say, okay, why do I even need all of these? Like people that have animosity towards agent memory, people say, "Okay, let's just put like 15 million context window," even though it's not possible yet, but some people really believe that this is the thing, right? But the context window is a type of short-term memory, so it's useful for some things, but not for all of them.

Oracle Presenter: And one of the problems that happen with working with a context is this thing called context rot or context degradation over time. And what happens is that the more things that you put into the context window, the less attention there will be for each one of the things that are in the context. So at the beginning of a conversation—and this is a famous problem that the context window has—at the beginning of the conversation it will stay on track a lot because you just started the conversation.

Oracle Presenter: So let's say that for instance like in school, right? Or if I'm having a conversation with you, I might have a chat with you for 30 minutes and your attention to me is very, very high because I just started speaking. But if the conversation goes on for 8 hours, then you want to punch me, right? Because I haven't shut up and you haven't learned almost anything at the end. And the problem is that attention, like us humans, is very limited.

Oracle Presenter: So the more things that you put in the context window, the attention matrix of the neural network will also degrade, and it will like scale quadratically because the attention matrix, you know, is one token—it's essentially a reference of one token for every other token in the context window. So the bigger the context window is, the matrix scales on the number of rows and on the number of columns as well, which is a problem. So you want to keep the context window as small as possible to avoid context rot.

Oracle Presenter: And memory engineering, the components of memory engineering... So it's like designing, building, and doing everything around building agent memory for AI agents, and we want to retain, recall, reuse, and refine this data in some type in some way. So it is a discipline, right?

Oracle Presenter: And here we have Valentine, for instance, and we have people from Oracle, uh, my colleagues all over the room. So if you see them, you can say hi to them. Valentine here, he's working on the development—or he worked on the development—of this agent memory package. So if you have any questions about this, you can ask him.

Oracle Presenter: Um, OAMP, or Oracle Agent Memory Package, is the managed answer that we have in Oracle to lots of the problems that you will find when working with this type of data. For instance, as an engineer, if you do not have a managed solution, you need to make a lot of decisions. You need to see: when do I do context compaction? When do I summarize? How do I write it, the summarizer? What do I keep, what do I not keep? Um, what do I extract from my previous...

Presenter: ...conversations and when, how many tokens do I use for this problem and lots of these things, right? With OAMP, an Oracle agent memory package, you can actually just do all of this in one single line of code. And we want to make it easier so that we reduce the cognitive load of AI engineers and AI agents as well.

Presenter: And with this context card thing, you will get something like what you see on the left. And this is kind of an explanation of what each part does on it. But essentially, the topics that you see, for instance, from any conversation, you can create a context card from the thread or from the conversation. The topics will orient the model. The summary will compact the thread and it will state the current intent of an AI agent, and the relevant information has three different parts, which is the facts, the preferences, and the memories that are associated to this conversation. Then you have the episodic memories that explicitly track the unanswered question that is going on right now, and the recent messages give like local context to the model. So whenever you're feeling like unsure what do I need to do right now with the data that I have or this conversation, you might use the Oracle agent memory package on Python, and it is all assembled by one single call.

Audience Member: Yes. So you're not suggesting that this goes directly into the model. This is actually something that is used by the harness.

Presenter: Exactly.

Audience Member: What's going into the model?

Presenter: Yes. Yes.

Audience Member: The component that you're talking about that uses it knows about the structure.

Presenter: Exactly. Exactly. So this structure...

Audience Member: ...this is an abstraction that we build on top of the model because the model we have no control over in most cases, right?

Presenter: Exactly. Exactly. So this structure... this is an abstraction that we build on top of the model because the model we have no control over in most cases, right? The thing is that we can build on top of that whatever abstractions we want to make the model perform as reliably as possible. Yep.

So the memory and the semantic layer, they kind of work together. I know we talked only about memory components. I'm going to walk you quickly because I don't have a lot of time to the semantic layer, to the semantic components of it, right? And the semantic layer is the meaning of what's going on behind it that you kind of assume that that happens, right?

So anyone from Germany? Okay. So I apologize for my pronunciation, but I'm going to try. So the [Umwelt] is like the ambient of a model, and this was coined by Jakob von Uexküll. And this guy said that essentially every organism in the world that is living perceives its reality through a lens, and the lens is what it has access to. For us humans, for instance, we have our eyes, our senses, right? So everything that we perceive and everything that we live, all our experiences are seen through this lens, right?

And an agent doesn't have human-like senses, but it has also a kind of semantic layer or a semantic lens that everything that you ask it is filtered through. And this lens is essentially what you train it with, and then what you also give context to. So everything that you talk to the agent, right, when you talk to the agent, this agent will look it through the Umwelt, and the semantic layer is essentially the agent's Umwelt.

Presenter: So what I want to focus on, like for instance organizational knowledge or enterprise knowledge, things that when you're working with a colleague you don't mention this because this is already, you know, known between you and your colleague, you don't need to specify everything that you work on every day. If there was someone else, like a child that wanted to start working with you, you would have to specify everything very, very in detail. These are all the answers, and this is what the semantic layer captures. So the answer is the actual tribal knowledge that an enterprise has, institutional knowledge as well, like how the data is modeled, how the queries are executed, what is the metadata—all these things are in the semantic layer.

Presenter: And quickly just for you to know that we're also going to implement a very minimalistic agent loop. And an agent loop is like the driver of the model, right? It lets a model be kind of independent and autonomous, and it is what makes a model—it turns a model into an agent, right? And this is like the simplest agent loop that you can find, is kind of this observing and reasoning and then acting part that happens all of the time, all of the time. And you know, it has to be failure-resistant so that we never exit the loop. This is the idea that you give autonomy to the model so that it becomes the agent.

And then on the context engineering part, which is the last part of the seven layers of an agent harness, you also have lots of things that you can do.

Presenter: For instance, the toolbox pattern and the skillbox pattern, which is on the workshop as well. And these are ways in which you can store the available tools and the available skills of a model so that they are retrieved optimally. And what you want to do is only retrieve the tools and the skills when they are actually needed and put it on the context window only when needed. Every iteration of an agent loop you will see if this is actually the right place, and then if it's not you can just take them out temporarily.

Oh, sorry, I thought I saw a question. So we will see all of this in the workshop, I don't want to take up too much time, but the idea is that we will assemble the context at every iteration on the agent loop.

Presenter: And then continual learning is the part that we talked before about the ability to get better over time with the things that we've done with a model, right? So a frozen model, as we saw, it doesn't get better, right? But there are ways in which we can make an agent improve: in the weights, which is the parts that we are going to work on in the representation part, so on the embedding and the reranking part; and also in the context window. And these are the three types of continual learning techniques.

We are going to focus on the workshop on the context and the token space because it's one of the easiest ones and one of the least expensive ones as well. I assume no one is a millionaire, or not many of us are millionaires. So this is also the most achievable and the most realistic way to change the model behavior over time.

Presenter: So without further ado, I just want to introduce you to this part, which is skill promotion and workflow promotion. So those skills or those workflows that you've done for three, four hours, right, you've been working for the whole day on a workflow, you were able to successfully do your job. And then these things can actually be retrieved, they can be stored into the memory components that we'll see. And then we will see about skill promotion.

So if we promote a skill, for instance, we can promote it through a distillation process and create a better skill.md than the original. So we will retire the old version and update from the new version. And this allows us to do some kind of continual learning on our own skills that turn them into more customized skills for ourselves, for our tone, our way to work, our preferred preferences. Like for instance, "let's use this specific library because I really like the look and feel of it," "let's use this specific database engine because it has less bugs or I found it easier to work with." All these things can be promoted into reusable and improvable skills over time.

Presenter: So this is what the whole harness would look like at the end of the workshop, and hopefully what you leave today with a better understanding of all the specific components that make up an agent harness.

So let me go to here before I forget. If you are interested in the Oracle agent memory package or are working on the agent memory package, we have a Discord server in which you can just chat with us as stuff. If you're a Discord user, just feel free to join this Discord server. I'll put the link later as well.

But without further ado, let's begin with the actual workshop and I will tell you how. So let me show...

Presenter: First, what we are going to build, right? This is an app book. Oh, sorry, you don't see this.

Staff / Attendee: Yeah.

Presenter: First, yes, the workshop instructions, right? So, for those of you who weren't here, you can just go into this website, register with your GitHub user, and then you will get an invitation like this to a GitHub repo, and from here we will create a GitHub Codespace. So please make sure to do that right now, and all my colleagues are around the room to answer any questions that you might have during the creation of the Codespace, etc.

Attendee / Staff: The internet. Are you having issues with the internet?

Presenter: Okay. Let's see.

Staff / Attendee: So, do you guys have the same Wi-Fi? Um, AI.gineer Wi-Fi. Okay. So, can someone assist people with the Wi-Fi if possible? Whether you can help each and every one of us, you need to fix the system.

Attendee: Yeah, please fix the system. Whoever...

Attendee: do it.

Presenter: I can't, I can't.

Presenter: Yeah. Yeah. Uh, my colleagues will take a look at that if...

Attendee: Right. Yeah. Yeah. It always happens, you know.

Presenter: Yep. All right.

Attendee: Say again, sir. The slides that you were showing, are they...

Presenter: Yes, they will go into the AI, I believe they will go into the AI Engineer. So, if you go into the session, I'll make sure to go there. If not, if you either join the Discord or any other, you know, you can just message me as well on LinkedIn. I'll gladly give you the slides if you want.

Presenter: All right. Um, video team, can you turn me on? Uh, sorry, switch me on, please. Uh, oh, perfect. Thank you. So, what I'd like to show you is that we have built also, apart from the notebook that we're going to go through, we also built this app book. And with the app book, you can actually test every of the individual components of an agent harness individually, right? So just for me to show you that this is possible, and you will get this automatically deployed in GitHub Codespaces as well.

Presenter: So you will have this already deployed and you will say, "Well, how am I actually making requests?" We are going to be making requests to Oracle. Uh oh. Okay. Not file. Demo time. Um, the idea is that... Yeah. Okay. I know what's happening. So I lost connection to my Codespace because of inactivity. Let me restart.

This app book is going to allow you to create and chat and interact with the whole agent harness. And the models that we're going to use are actually deployed on a managed service that we have on Oracle called OCI the Generative AI service. We have partnerships with Google, with Meta, and with OpenAI and with xAI for the time being. And we can actually provide inference to their models through our managed server. So think of us as the enterprise OpenRouter if you'd like.

Presenter: So let me just go so you get started. You can get started. This is the repo, right? So the Agent Harness Workshop. If you're here—and thank you for starring that by the way—if you're here, you just have to click on "Open in GitHub Codespaces" and it will take you here, and you can select as many cores as you like.

If you want to create this with 8 or 16, please don't, because I'm paying for this myself. But you might also create this with more resources, but just create the Codespace and I'm going to pay for it as I said, so don't worry about that. And this will create a new Codespace instance. And once it finishes—which it hasn't yet—I will show you what we can do with the app book and the notebook. But the idea is to use the remainder of the time that we have, 1 hour and 15 minutes, to go through the notebook.

Presenter: And you will actually have to—let me show you on GitHub actually. You can go here and inside the notebook, after you deploy the Codespace, you will get a student notebook here, and this is one part of the workshop, right? And here we're going to implement the whole agent harness substrate from scratch.

So, we're going to start with only the model and then we're going to keep adding layers to the agent harness as we saw the seven layers, right? And we're going to be here to assist you. You will have to do some TODOs.

So, let me show you. There are a couple of things to do for you. So, for instance, the first thing that you need to do, you need to create a question, right? The simplest thing of everything, you just have to communicate with a model with no agent harness implemented, right? So the first thing you'll need is to ask any question that you like. This will go through the OpenAI completions API and it will return you a response. This is the simplest of all.

And then we will start adding search, retrieval, encoding and all the other components that we have seen. There are a total of 19 things that you need to do. If you finish first, raise your hand and I will give you a hug because I don't have anything else.

Presenter: And yeah, so anyone already deployed the Codespace? Okay, one person. Okay, good job. So if you have any questions or any problems, let me know. But this is what it looks like when you have it deployed. Okay. So, let me go through this quickly.

So, you will get an app, right? And the app will already have everything that you need. If you want to deploy this app yourself, you might change this Total Recall port here. Let me show you how I did it again. I go into Ports. I clicked on the visibility of the port and I changed this to Public. And then this is now using a public gateway. So that if I open the browser, I can actually get access to my individual Total Recall instance.

Presenter: So for instance, if I ask a question like "show the total revenue by product category"—and of course this is Mission Control, so this has all of the components that we've spoken about implemented already. You will get also a context window visualization of the things that are going on in the background.

For instance, these are the tools that were selected by the agent harness to be loaded into the context to answer this question. This is the schema that's happening. And then we can also take a look at the individual agent traces that are going on. For instance, which skills are being loaded, what sources of data are we taking, and what are the tool calls being used—like for instance running SQL commands, etc., to answer your question.

So the question is still being built. It's taking 16 steps, and you know, for instance here it detected an error, right? But because our agent harness is fault tolerant, it will keep trying because it has an agent loop implemented, etc., right? So all these things will actually yield you this result from the data in the database, right?

And you can actually go into the context window, see how many tokens we're using. And if you're particularly interested in some of these parts—for instance the Oracle Agent Memory package, for instance—you can interact also with only the context card, how the context card is being created, etc., etc. So you will all get this deployed in your codebase.

Attendee: Yeah.

Presenter: Yeah.

Presenter: So his question, for those of you who didn't listen: what happens if you have thousands of tools in an organization, right?

Well, we introduced this concept called the Toolbox Pattern in this course with Andrew Ng, and the thing is that you can optimize so that the retrieval of these tools is negligible. So you will use Hierarchical Navigable Small World (HNSW) indexes that use a graph structure, and then each node in the graph is a vector index or a vector store. And then HNSW indexes can be created for these types of problems only in the database, not in files.

So great question. It doesn't have to worry you until you reach millions and millions of users and tool calls—like different specific tool calls. You might not get 5 million; it's more like reading a file, writing a file, grepping, all these kinds of tool calls that we do every day, they typically don't exceed 100 or a thousand. But by being on a vector store, you abstract the complexity and the amount of it. You can just make a...

Speaker: ...query 2,000 just as simply as you would 10,000 because of the storage component that we choose, which is an HNSW index. Yeah, some of them have access to confidential data, for instance. Some of them don't. Yes.

Speaker: Great question. So his question was what happens if the tool descriptions that two different companies have are very similar, right? And one of the things we can do on the toolbox pattern is actually generate with LLM enhanced toolbox descriptions for these specific tools to increase the separability of the tools. So if you think that the current descriptions of a tool or of a skill as well are not enough, you can actually enhance them with LLM retrieval. Instead of running, for instance, named entity recognition, which is very caveman style, you can also do something more sophisticated, which is enhancing the docstring-enhanced representations of a tool so that you increase the separability when you're doing vector search. Does that answer the question?

Audience: The agent loop is that?

Speaker: Yeah.

Audience: Oh yes. Yes. We have seen some.

Speaker: Yes. So there is a limit, of course, because we don't have infinite money. So we can't just keep trying and trying over and over if the generations are just hallucinations, right. There is a cutoff point that I set depending on the frontier LLM that I'm using. For instance, for Groq 4.1 fast reasoning, which is the one that we're using here, I found that a value of 8 to 12 maximum number of tool calls before giving up is correct. It depends also on the accuracy and the correctness of the model. Like, for instance, in this case it was just able to show it in 2, before it was able to find it in 16. So sometimes it will have a faster retrieval, sometimes you will need to be a little bit more patient. But what I like to define is a variable like a hysteresis variable that holds the amount of patience that the harness will get with the model. Then you can do some other things like, for instance, if the model is garbage. You can just use a router: for difficult types of problems you will route this problem to a frontier LLM, and then for the easier types of problems you can just attach an open weights SLM, for instance, which will be more interesting.

Audience: Do you recommend models for...

Speaker: Yes. Yes. I think that's—my personal opinion is that the future is a mixture of small experts for each type of problem. Some companies have developed 100 million parameter models that work exceptionally well for one type of problem, and if you just have an aggregator and an orchestrator that routes the correct query to that model, then you will have a very token-efficient type of agent harness. So you can actually do model routing inside the agent harness. Some companies are actually essentially only doing that, and they will charge you like: "I'm going to charge you 10% of the tokens that I'm going to save you from the original amount of money that you were going to spend," right.

Speaker: So let me show you the student notebook. Once you are inside the student notebook, for those of you who are not familiar with Visual Studio Code, you might need to select a kernel here so that you run the notebook. You might select Python 3.12 here and then you can just start reading. If you stumble into a to-do that you need to do, you have a docs folder with all the explanations, the individual explanations that you need to solve this specific problem. For instance, the first to-do, which is just talking to the reasoning core to the model layer without doing anything else. It will just explain what you need to implement on that cell so that it works and you can proceed to the next one, and also have the solution. But if you're not lazy, you will try—and hope that you try—and we will be here answering questions around the room. I'm gonna turn off my microphone, just come down with my colleagues, and then let's chat about it for the remainder of the session. And if you have any questions or you'd like to talk more to us, please come by and swing by the booth, the Oracle booth. We'll be there every day, all the time. And you know, it makes us feel good like we are wanted and we have friends. So if you want to come up to us, just chat with us a little bit. It will be nice.

Audience: Internet. How is the internet?

Speaker: I feel like Cesar. Right. So, I'm gonna leave this here. I'm going to keep this here. And I'm going to come down.