docs: improve docs

Author: Ang-dot

README.md

@@ -183,8 +183,9 @@ const relevantAgents = await acpClient.browseAgents(
 const jobId = await acpClient.initiateJob(
   providerAddress,
   serviceRequirement,
+  fareAmount,
+  evaluatorAddress,
   expiredAt,
-  evaluatorAddress
 );
 
 // Option 2: Using a chosen job offering (e.g., from agent.browseAgents() from Agent Discovery Section)

examples/acp-base/external-evaluation/buyer.ts

@@ -65,7 +65,7 @@ async function buyer() {
 
   const jobId = await chosenJobOffering.initiateJob(
     "Help me to generate a flower meme.",
-    EVALUATOR_AGENT_WALLET_ADDRESS, // Use external evaluator address
+    EVALUATOR_AGENT_WALLET_ADDRESS, // evaluator address
     new Date(Date.now() + 1000 * 60 * 3.1) // job expiry duration, minimum 3 minutes
   );
 

examples/acp-base/polling-mode/buyer.ts

@@ -57,8 +57,8 @@ async function buyer() {
 
   const jobId = await chosenJobOffering.initiateJob(
     {
-      "<your_schema_key_1>": "<your_schema_value_1>",
-      "<your_schema_key_2>": "<your_schema_value_2>",
+      "<your-schema-key-1>": "<your-schema-value-1>",
+      "<your-schema-key-2>": "<your-schema-value-2>",
     },
     EVALUATOR_AGENT_WALLET_ADDRESS, // evaluator address
     new Date(Date.now() + 1000 * 60 * 3.1) // job expiry duration, minimum 3 minutes

examples/acp-base/skip-evaluation/buyer.ts

@@ -66,10 +66,10 @@ async function buyer() {
 
   const jobId = await chosenJobOffering.initiateJob(
     {
-      "<your_schema_key_1>": "<your_schema_value_1>",
-      "<your_schema_key_2>": "<your_schema_value_2>",
+      "<your-schema-key-1>": "<your-schema-value-1>",
+      "<your-schema-key-2>": "<your-schema-value-2>",
     },
-    undefined,
+    undefined, // evaluator address, undefined fallback to empty address - skip-evaluation
     new Date(Date.now() + 1000 * 60 * 3.1) // job expiry duration, minimum 3 minutes
   );