Hermes Agent amb /learn i /goal: com enriquir un CRM amb dades citades
Un tutorial mostra com convertir la documentació de Parallel en una habilitat reutilitzable d’Hermes Agent i executar un flux autònom que completa empreses d’un CRM amb dades estructurades, confiança i fonts.
Ensenyar una API una vegada i reutilitzar-la
El vídeo de Derek Cheung presenta dues ordres recents d’Hermes Agent que canvien la manera d’automatitzar una feina repetitiva. /learn transforma documentació, una carpeta o un procés explicat per l’usuari en una habilitat reutilitzable. /goal fixa un objectiu persistent i fa que l’agent continuï treballant entre torns fins que considera que ha complert els criteris, arriba al pressupost màxim o l’usuari l’atura.
La demostració combina aquestes dues peces amb les API de recerca web de Parallel. L’objectiu és enriquir un CSV fictici d’un CRM que només conté cinc noms d’empresa. Sense més intervenció, l’agent ha de trobar el domini correcte, investigar cada companyia, retornar camps normalitzats i escriure el resultat al fitxer amb cites per poder comprovar-lo.
No és només una demostració de cerca. El valor està a convertir una resposta narrativa en registres que poden entrar directament en una base de dades, sempre que abans es validin.
Què fan exactament /learn i /goal
Amb /learn, el creador apunta Hermes a la documentació completa de Parallel i especifica què ha d’aprendre: endpoints, capçaleres, paràmetres, esquemes i el patró asíncron de crear una tasca i consultar-ne el resultat. Hermes genera una skill local i persistent. En sessions posteriors ja pot respondre com es crea una execució o preparar la crida corresponent sense tornar a llegir tota la documentació.
La documentació oficial d’Hermes descriu /learn <contingut> com una manera de destil·lar una habilitat a partir d’una URL, un directori o un flux de treball. L’habilitat, però, és una còpia interpretada del coneixement disponible en aquell moment: si l’API canvia, cal actualitzar-la o tornar-la a generar.
/goal resol una necessitat diferent. En lloc d’esperar una nova instrucció després de cada resposta, conserva un objectiu i un model auxiliar jutja si ja està acabat. Si no ho està, Hermes continua en la mateixa sessió. La configuració actual limita aquest bucle a vint torns per defecte, una protecció important davant objectius impossibles, criteris ambigus o un jutge que no detecta bé el final.
Per tant, /learn aporta procediment reutilitzable i /goal aporta persistència. Cap de les dues ordres garanteix per si sola que les dades siguin correctes.
Les API de Parallel que compon el flux
Parallel no ofereix una sola funció. El tutorial destaca una família d’API que inclou cerca, extracció, tasques de recerca, conversa, monitoratge i localització de conjunts d’entitats. La demostració utilitza sobretot tres peces:
- Search localitza el web oficial i altres perfils rellevants de cada empresa.
- Extract recupera el contingut de pàgines com «About» i el converteix en context utilitzable.
- Task API investiga diverses fonts i retorna una resposta ajustada a un esquema JSON, amb cites i informació sobre la confiança.
Separar els passos redueix un problema habitual: dues empreses poden tenir noms semblants. Si l’agent identifica primer el domini i després extreu el web oficial, la tasca final parteix d’una entitat més ben desambiguada. Això no elimina els errors, però és millor que demanar directament a un model que «investigui aquesta empresa» sense cap procediment.
El cas pràctic: cinc empreses amb vuit camps buits
El CSV simula una empresa de programari B2B que acaba d’importar cinc contactes. Per a cada companyia es demanen vuit camps: descripció del negoci, nom del director executiu, seu, rang de treballadors, any de fundació, finançament acumulat i indústria principal, a més del nom que ja existia.
La instrucció de /goal conté el resultat esperat i una definició de «fet». Hermes ha de:
- llegir totes les files del CSV;
- trobar el domini oficial i el perfil adequat;
- extreure les pàgines clau;
- executar la Task API amb l’esquema definit;
- agrupar les tasques per processar diverses empreses;
- escriure tots els camps i les cites al fitxer;
- no aturar-se fins que les cinc files estiguin completes.
L’ordre és important. L’agent no delega cegament tota la feina a una única crida: prepara les entitats, recupera evidència i després demana una síntesi estructurada.
Per què un esquema és millor que un paràgraf
Una consulta convencional a un xat pot donar una descripció convincent, però obliga una persona o un altre programa a extreure’n camps, detectar buits i comprovar cada afirmació. En canvi, un esquema JSON defineix anticipadament noms, tipus i format. La sortida pot validar-se abans d’actualitzar el CRM i cada camp pot conservar la seva font.
Això fa possible aplicar regles automàtiques: rebutjar una fila sense domini, marcar una xifra de personal amb poca confiança, impedir que un text entri en una columna numèrica o enviar a revisió els casos on les fonts discrepen.
Les cites tampoc converteixen el resultat en cert. Una font pot estar obsoleta, una pàgina corporativa pot ser promocional i les dades de finançament poden confondre una ronda amb el total acumulat. El guany real és la traçabilitat: queda un camí per comprovar d’on surt la informació.
La prova de reutilització
Després del primer CSV, el vídeo executa la mateixa skill sobre empreses del sector sanitari. No torna a ensenyar l’API ni canvia el mecanisme bàsic. El domini empresarial és diferent, però el patró continua sent cercar, extreure, investigar segons un esquema i escriure.
Aquesta segona prova demostra reutilització procedimental, no precisió universal. Una indústria regulada pot necessitar camps, fonts i criteris diferents. Per exemple, una empresa sanitària pot requerir informació sobre autoritzacions, assajos o jurisdiccions que no apareix en un esquema pensat per a programari B2B.
La skill s’ha de veure com una plantilla viva. El component estable és saber com parlar amb l’API; la definició de dades i les regles de qualitat han d’adaptar-se a cada negoci.
Cost, latència i manteniment
El creador dedica el final a les limitacions. Search i Extract són operacions relativament econòmiques, però Task API fa recerca en diverses fonts i té un cost superior. La tarifa oficial varia segons el processador; el nivell Base es factura per petició i pot tardar desenes de segons. En milers de registres, executar recerca profunda sobre totes les files pot ser lent i car.
Una arquitectura més eficient aplicaria nivells:
- validar i normalitzar primer les dades que ja existeixen;
- resoldre consultes simples amb cerca o extracció;
- reservar Task API per a camps difícils o empreses d’alt valor;
- agrupar peticions i imposar límits de concurrència;
- desar resultats per no repetir investigacions idèntiques.
També cal versionar la skill. Quan Parallel canviï endpoints o paràmetres, una habilitat antiga pot continuar produint crides incorrectes amb molta seguretat aparent. Conservar l’URL d’origen, la data d’aprenentatge i proves automàtiques bàsiques ajuda a detectar aquesta deriva.
Abans d’escriure en un CRM real
El mateix vídeo recomana revisar manualment les primeres files perquè l’autoavaluació d’Hermes tendeix a ser generosa. En un entorn real convé afegir proteccions encara més explícites:
- treballar primer sobre una còpia del CSV;
- validar l’esquema i els dominis abans de fer cap actualització;
- conservar el valor anterior i un historial de canvis;
- fer l’operació idempotent per evitar duplicats;
- no recollir dades personals que no siguin necessàries;
- registrar cost, temps, fonts i errors per fila;
- exigir revisió humana per a conflictes o baixa confiança.
/goal ha d’incloure criteris de finalització verificables. «Enriqueix el CRM» és massa vague; «totes les files tenen els vuit camps, una URL oficial, almenys una cita per camp i cap error de validació» ofereix al jutge una prova molt més concreta.
La lliçó del tutorial
La combinació és potent perquè separa tres nivells: Hermes recorda com utilitzar l’eina, Parallel fa la recerca i l’esquema defineix què ha de retornar. /goal manté el procés en moviment fins al resultat esperat.
El model més útil no és «ensenyar una API i oblidar-se’n per sempre», sinó ensenyar-la, versionar-la i envoltar-la de validacions. Amb aquesta disciplina, un CSV manual pot convertir-se en un flux repetible i auditable. Sense-la, l’autonomia només accelera la propagació de dades incorrectes.
Contrast i context
Fonts consultades
-
01
Nous Research Hermes Agent
-
02
Nous Research Hermes Agent — Slash Commands
-
03
Nous Research Hermes Agent — Configuration and Standing Goals
-
04
Parallel Web Systems Parallel API overview
-
05
Parallel Web Systems Task API
-
06
Parallel Web Systems Search API
-
07
Parallel Web Systems Extract API
-
08
Parallel Web Systems Pricing
Font de treball
Transcripció amb marques de temps
Consulta la transcripció
-
0:00
, obre el vídeo en una pestanya nova
Check this out. Five companies, zero contacts. I'm going to show you how to teach an AI agent to master a deep research API it's never even seen before. We're going to unlock some serious data enrichment potential and we're doing the whole thing with just one single prompt. Watch what just happened. It read a CSV. It called an API it learned 30 minutes ago. It researched five companies. It populated every field. It cited its sources. That's what this video is about. By the end, you'll know how to teach any Hermes agent any API once so it scales and then hand it real work that it drives to completion.
-
1:00
, obre el vídeo en una pestanya nova
Hermes agent has two commands that change how you use it, {slash} learn and {slash} goal. Here's the short version. {Slash} learn teaches it something, an API, a workflow, a business rule, once. And it remembers it forever as a skill. {Slash} goal gives it a standing objective and it keeps working until that objective is actually met, not until you get tired of prompting it, until it's done. Today, I'm going to show you both on a real problem. We're going to teach Hermes the Parallel Task API, an API for web research that returns structured data with citations, and then hand it a CRM export with five blank company records and tell it to go enrich them, all five, without me. There are two reasons this works. First, Parallel's API is designed for exactly this. You give it a schema describing what you want and it researches the web and returns structured JSON with confidence scores and source citations per field. It's not a search engine. It's not a scraper. It's a research API. Second, Hermes can learn that API once via {slash} learn and then drive it autonomously via {slash} goal. The combination is what makes this more than a cool demo. It's a repeatable workflow you can run every time your CRM gets new leads. And at the end, I'll show you the one thing most tutorials skip. How to take this same setup and run it for a second CSV from a completely different industry without reteaching anything. The skill is permanent.
-
2:30
, obre el vídeo en una pestanya nova
Before we dive in, Parallel is actually six APIs, not one. The task API is the star of today's video, but the skill Hermes learns covers the whole surface. Here's what else is in the toolbox. The entire suite is what makes this useful beyond today's demo. When Hermes learns Parallel via {slash} learn, it's not just learning the task API. It's learning search, extract, chat, everything. Future sessions, different use cases, same skill covers all of it. Today, we're going deep on task API for CRM enrichment, but by the end, the skill is permanent. Tomorrow, you could ask Hermes, "Search for recent funding announcements in the developer tool space." Or, "Extract the pricing page from all three of our competitors and build a comparison table." And it'll know how. One {slash} learn, six APIs, infinite use cases.
-
3:15
, obre el vídeo en una pestanya nova
Let's start from zero. This Hermes agent has never heard of Parallel. It doesn't know what a task API is, and it has no skills loaded. Watch. This is Parallel's full API documentation in one file. All the endpoints, all the parameters, and all the schemas. I'm going to point {slash} learn at it. Type {slash} learn and provide the URL of the Parallel AI docs. I want a skill that knows how to use every Parallel API. Search, extract, task, and chat. Focus on the task API for structured research with JSON schemas, and include exact endpoint URLs, required headers, and the async polling pattern. The Hermes agent will go to the URL, learn the API, and a few minutes later, it will know exactly how to use it. There it is. The Parallel Web skill is created. It's permanent and reusable. In any session from now on, I can reference this skill and Hermes will know exactly how to call the Parallel APIs. Search, extract, task, chat. All of them. It has the exact endpoints, the required parameters, the async polling pattern, and even batch execution via task groups. All of it. Let's do a quick demonstration. Ask Hermes, "How do I create a task API run?" Hermes responds with the exact curl command, endpoint URL, and parameter explanation. All pulled directly from the skill. One {slash} learn command. That's all it took. Hermes now knows the entire Parallel API surface. Let me show you what that's actually worth.
-
5:15
, obre el vídeo en una pestanya nova
Here is our scenario. This is a CRM export from a fictional B2B SaaS company called Pipeline, which sells developer tools. Their sales team just imported five new leads, but all they have are company names. No context, no qualification data, nothing. The sales team needs to know, "What does each company do? Who is the CEO? How big are they, and how much funding have they raised? Where are they headquartered, and what industry are they in?" Normally, that would require a junior salesperson to spend half a day on Google. But we are going to do it with one Hermes command. First, however, we need a schema. Company name, business descriptive, CEO name, headquarters, employee count range, founded year, latest funding total, primary industry. Eight fields. Each one changes how you sell to the company, yet each one is a Google rabbit hole when researched by hand. Now, every single one is something Parallel's task API can research and complete with citations, in a single call.
-
6:15
, obre el vídeo en una pestanya nova
Here's the slash goal command. One instruction that provides an outcome, guardrails, and a definition of done. But watch what APIs it uses. This isn't just one call. slash goal Enrich every company in CRM-export.csv. For each company, one, use parallel search to find their official website domain and Crunchbase profile. two Use parallel extract to pull their about page and key data. three >> [clears throat] >> Use the parallel task API with this JSON schema to produce a structured profile. four Write all results back to the CSV with source citations. Use task groups for batch execution. Don't stop until all five companies have every field populated. Watch the order. It's not jumping straight to the task API. It's searching first, finding the actual domains, then extracting, pulling the real pages, then feeding that structured context into the task API for the final profile. Check it out. Here's the output it generated. To start with, we only had the company name and these two fields right here. But now, look at this. It enriched all eight fields automatically. Everything from the business description and CEO name to the industry and even the source citations. We can dive into the details here and you'll see how it filled all of this in on its own using the APIs it learned from Parallel Web APIs. Super cool. So, here's a new CSV with healthcare companies. Completely different industry, right? But watch this. It's the exact same skill and the same Hermes agent. I didn't have to reteach it a single thing. See, the skill doesn't actually care what industry these companies are in. It already knows the drill. Call the parallel task API, pull for the results, and write everything back to the CSV. The domain changes, sure, but the workflow stays exactly the same. And honestly, that's the big difference between a quick one-off demo and an actual system. I taught Hermes once, and now I can enrich any CRM export I want. Doesn't matter what the industry is, using that same original skill. It's basically powerful automation on autopilot.
-
9:00
, obre el vídeo en una pestanya nova
I want to be straight with you about the tradeoffs. The parallel task API isn't free. While search and extract are cheap, the task API using the base processor costs more because it performs multi-source research with cross-referencing. For high-volume enrichment involving thousands of records, you should batch your requests smartly, and perhaps pre-filter which records actually need deep research versus those that only require quick lookups. Keep in mind that the skill Hermes learned from the learn command is only as good as the docs it was trained on. If Parallel updates their API with new endpoints or change parameters, you will need to rerun the learn command with the updated documentation. This isn't a set and forget process. Additionally, the self-evaluation step in the Hermes learning loop tends to rate its own work generously. Before you point this at a real CRM with 500 rows, spot-check the first few results manually. Just as I showed you with the citations. Trust, but verify.
-
9:45
, obre el vídeo en una pestanya nova
Here's what you just saw. Step one, learn an API once. Point Hermes at the docs, and it writes a reusable skill. Step two, set up your scenario with a CSV, a schema, and a clear definition of done. Step three, goal. With just one command, the agent drives the entire enrichment process autonomously. I will link the parallel docs, the schema we used, and the learn and goal prompts in the description. You can copy them, swap in your own CSV, and run this today. What is the first API you would teach your Hermes agent? Let me know in the comments. Thanks for watching, and see you in the next video.