Improve docs

Author: peterkuczera

pica/README.md

@@ -24,7 +24,7 @@ import (
 
 type HelloPica struct{}
 
-// Return the current weather for a given location
+// Returns the current weather for a given location
 func (m *HelloPica) CurrentWeather(ctx context.Context, location string, picaApiKey *dagger.Secret, openaiApiKey *dagger.Secret) (string, error) {
 	prompt := fmt.Sprintf("What's the weather in %s?", location)
 	return dag.Pica(picaApiKey, openaiApiKey).OneTool(ctx, prompt)

pica/src/index.ts

@@ -1,20 +1,38 @@
+/**
+ * Use Pica OneTool with Dagger
+ *
+ * Pica provides powerful APIs and tools to build, deploy, and scale AI agents with seamless access to over 100+ integrations
+ */
 import { Secret, object, func } from "@dagger.io/dagger";
 import { createOpenAI } from "@ai-sdk/openai";
 import { generateText } from "ai";
 import { Pica as PicaAI } from "@picahq/ai";
 
 @object()
 export class Pica {
+  @func()
   picaApiKey: Secret;
+  @func()
   openaiApiKey: Secret;
 
-  constructor(picaApiKey: Secret, openaiApiKey: Secret) {
+  constructor(
+    /*
+     * Pica API key
+     */
+    picaApiKey: Secret,
+    /*
+     * OpenAI API key
+     */
+    openaiApiKey: Secret,
+  ) {
     this.picaApiKey = picaApiKey;
     this.openaiApiKey = openaiApiKey;
   }
 
   /**
-   * Returns a response from the LLM as a string
+   * Returns the response from ChatGPT using the supplied prompt and any connected integrations
+   *
+   * @param prompt The prompt to send to the ChatGPT
    */
   @func()
   async oneTool(prompt: string): Promise<string> {